Skip to main content

Agents Create Conversation

[MODE:SIDEEFFECTS] Tier: overseer. Not idempotent from the caller perspective, but safe to retry for the same conversation_id.

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.