跳转到内容

快速开始

准备服务地址、Organization API Key、End User ID 和已保存的 AgentTemplate。通过认证指南配置 End User,并在模板列表选择 agentTemplateId。Organization Key 保存在应用后端。

终端窗口
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。

终端窗口
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 上开启语音。