Skip to main content

Agents Create Conversation

[MODE:SIDEEFFECTS] Tier: overseer. Caller-visible effect is non-idempotent; retries with the same conversation_id are safe.

Creates or upserts a conversation for an Agent before sending messages to it.

Inputs​

FieldTypeRequiredNotes
id_or_nameint or stringyesAgent ID or name
conversation_idstringyesStable conversation/thread ID
titlestringnoHuman-readable title

Gotchas​

  • Use stable caller-owned ids for deterministic routing.
  • Never expose conversation_id as user authorization. It is routing metadata only.
  • fibe_agents_send_message: send into the conversation.
  • fibe_agents_delete_conversation: cleanup.