agents

Remember

Give the agent something to keep: content (a text) or messages (a conversation), not both. What it is told is redacted first (secrets and card numbers by default; emails and phone numbers if its settings say so), then, with infer on (the default), read into separate memories under the agent's own instructions and excluded topics. A memory is about the agent, about one of its users (give user_id), or about the owner, the person the agent belongs to: only that last kind is ever offered to the person's own memory, held for their yes or filed at once as they set person.funnel, in the agent's voice and never theirs (see about_you in the answer). The same words again are skipped; a near-duplicate becomes the next version of the memory it repeats, unless that one is immutable. A paused agent answers 423. Needs the agent's own key or a person's key with write.

post/v1/agents/{agent}/memories

Request

  • Base URL: https://innernet.live/api
  • URL: https://innernet.live/api/v1/agents/{agent}/memories
  • Auth: HTTP bearer

Path parameters

agentstring required

The agent's slug, its id, or me (the agent a key made for one agent is bound to). Another agent, by any name, is a 404 to an agent key.

Request body

contentstring

The text to keep (or messages).

inferboolean

Overrides the agent's memory.infer for this call. With false the text is kept as given: one memory of at most 8000 characters.

kind'fact' | 'preference' | 'episode' | 'procedure' | 'instruction' | 'note'

Default note when not inferring.

subject'agent' | 'owner' | 'user'

Who it is about. When absent: the extraction decides, or user if user_id is given, else agent.

user_idstring

One of the agent's users (your id for them).

dimensionstring

For a memory about the owner: the part of their life it belongs to (a personal dimension such as preferences or tools). Wins over the extraction's guess; an unknown name answers 400.

run_idstring

A run, a thread or a session. Run memories expire after retention.run_days.

tagsstring[]
metadataobject

At most 30 keys and 16 KB. Filter by it with metadata.<key>.

importanceinteger
immutableboolean

Never changed (PATCH answers 409) and never replaced by a newer version.

event_atstring date-time

When it happened (an ISO date, or a time with a zone).

expires_atstring date-time

In the future. Not with ttl_days.

ttl_daysinteger
instructionsstring

Extra guidance for the extraction, for this call only.

Response

Created: something was kept. A call that kept nothing (all duplicates, all ruled out) answers 200 with the same body.

Changes

No recorded changes to this operation across all 1 revision of this API.