Skip to main content

Agents Create Conversation

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

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

Inputs

FieldTypeRequiredNotes
agent_idint or stringyesAgent ID or name
conversation_idstringyesStable runtime 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.