Fency.ai
Sessions

Conversation

Attach an agent task to an existing conversation.

conversationId attaches the task to an existing conversation so later tasks can share that thread. Your server sets it when creating a createAgentTask session. The React SDK only receives a clientToken and cannot change it.

How conversationId applies per task type:

Task typeconversationId
EXPLORE_MEMORIESOptional
EXPLORE_PRODUCTOptional
MEMORY_CHATNot supported
MEMORY_SEARCHNot supported
STREAMING_CHAT_COMPLETIONNot supported
STRUCTURED_CHAT_COMPLETIONNot supported

How they work

  • Create the conversation first with Create conversation. Conversations are never created as a side effect of a session.
  • Pass the returned cnv_... id as conversationId. An unknown id fails.
  • Title stays empty until the first attached task that has a query sets it.

Examples

EXPLORE_MEMORIES

{
    createAgentTask: {
        taskType: 'EXPLORE_MEMORIES',
        conversationId: 'cnv_...',
    },
}

See Conversations for the conversation object, Explore memories for a create-then-attach server route, and Sessions for full request bodies per task type.

On this page