快速开始
准备服务地址、Organization API Key、End User ID 和已保存的 AgentTemplate。通过认证指南配置 End User,并在模板列表选择 agentTemplateId。Organization Key 保存在应用后端。
创建 Session
Section titled “创建 Session”export BASE_URL='https://your-agent-service-host'export ORGANIZATION_API_KEY='<organization-api-key>'export USER_ID='<end-user-id>'export SESSIONS_URL="$BASE_URL/api/v1/org/users/$USER_ID/sessions"
curl --fail-with-body "$SESSIONS_URL" \ -H "Authorization: Bearer $ORGANIZATION_API_KEY" \ -H 'Idempotency-Key: support-session-001' \ -H 'Content-Type: application/json' \ --data '{"agentTemplateId":"<template-id>"}'保存响应中的 session.sessionId。如果请求结果未知,使用原 Idempotency-Key 和请求体重试。选用启用了跨会话 Recall 的模板时,显式传入 acknowledgeSessionRecall: true。
发送消息并读取结果
Section titled “发送消息并读取结果”export SESSION_ID='<session-id>'
curl --fail-with-body "$SESSIONS_URL/$SESSION_ID/events" \ -H "Authorization: Bearer $ORGANIZATION_API_KEY" \ -H 'Content-Type: application/json' \ --data '{"type":"agent.session.input.message","clientEventId":"support-message-001","data":{"text":"你好"}}'
curl --fail-with-body "$SESSIONS_URL/$SESSION_ID/interactions/support-message-001" \ -H "Authorization: Bearer $ORGANIZATION_API_KEY"
curl --fail-with-body "$SESSIONS_URL/$SESSION_ID/turns/<turn-id>" \ -H "Authorization: Bearer $ORGANIZATION_API_KEY"POST 返回命令回执;已受理的执行不依赖该响应继续运行。以 clientEventId 作为回执 ID,通过 /interactions/{receiptId} 再次读取回执,并通过 /turns/{turnId} 读取回执中 turnId 指向的 Turn,直到其 status 不再是 running。要实时接收进度和结果,由你的后端通过 Backend Connection 跟进该 Session。重试原消息时复用 clientEventId 和消息内容。
参阅会话与轮次了解切换 Template,Session 事件与恢复了解事件跟进与重连,或按语音指南在同一个 Session 上开启语音。