Memories
Give your application a memory that learns facts, episodes and procedures from its conversations, overnight.
A memory remembers what was said in the conversations attached to it, so your application's assistant knows it next time: facts about a customer, what happened before, how a task is done.
Create a memory
- Open Memories in Platform and select Create memory.
- Give it a Name that says what it remembers, such as support desk, and optionally a Description.
Memories belong to your organization; every key can use them.
Attach it to a conversation
Open the memory: Attach it shows its id and an example. Pass the id as
placeholder.memory_id on the request that starts a conversation. With the OpenAI SDK for Python:
client.responses.create(
model="auto",
input="My order hasn't arrived.",
extra_body={"placeholder": {"memory_id": "mem_…"}},
)
Or in the request body:
{
"model": "auto",
"input": "My order hasn't arrived.",
"placeholder": { "memory_id": "mem_…" }
}
What it learns, and when
A memory learns once a night, between 5 and 8 a.m.: it reads the day's conversations and keeps what is worth keeping. The memory's page shows what it holds, in tabs:
| Tab | What it holds |
|---|---|
| Facts | things that are true, such as a customer's plan |
| Episodes | what happened, conversation by conversation |
| Entities | the people, companies and things the facts are about |
| Procedures | how to do a task; one appears once a task was done well three times |
| Recurring situations | situations that come up again and again |
Last nights shows how each night went. A new memory says It has not slept yet until its first night.
Delete a memory
Owners and admins can select Delete on the memory's page. Everything it learned is deleted; this cannot be undone.