智能体发布的会话接口

`POST https://appstudio.sensecoreapi.cn/appstudio/agent/data/v1/chatbots/{chatbot_id}:run

• 智能体发布后的会话接口，支持文本输入，可配置为流式输出，同时支持基于历史会话上下文运行。
• 请求方法：POST
• 是否流式：支持（通过参数 stream 控制）

请求头（Request Header）

Authorization 可以使用如下两种Header

• 参考认证（authentication）

{
-H "X-Date: $xdate" \
-H "Authorization: $auth" 
}

• 直接提供完整的 Authorization Header,可以通过浏览器的开发者工具DevTools查看并复制接口调用的完整信息

{
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InB...'
}

---

请求体（Request Body）

字段名	类型	是否必须	描述
chatbot_id	string	是	Chatbot ID
content	Content[]	是	本次请求的消息内容，当前仅支持文本
status	ChatbotStatus	是	Chatbot 状态，草稿或发布
stream	bool	否	是否开启流式输出 ，默认为false，true，
session_id	string	否	会话 ID，若为空则创建新会话

Content 内容结构

字段名	类型	描述
type	ContentType	内容类型
text	string	文本内容

ContentType 枚举值

枚举值	含义
CONTENT_TYPE_UNSPECIFIED	未指定
CONTENT_TYPE_TEXT	文本

示例请求（Request Example）

{
  "chatbot_id": "your_chatbot_id",
  "content": [
    {
      "type": "CONTENT_TYPE_TEXT",
      "text": "你好"
    }
  ],
  "status": "CHATBOT_STATUS_PUBLISHED",
  "stream":false,
  "session_id":""
}

---

响应参数（Response ）

字段名	类型	描述
session_id	string	会话 ID
content	Content[]	会话内容（响应内容）
state	RunState	运行状态
error	string	错误信息（如有）
reasoning_content	string	深度思考内容（可选）

RunState 枚举值

枚举值	含义
RUN_STATE_UNSPECIFIED	未定义
RUN_STATE_RUNNING	运行中
RUN_STATE_SUCCEEDED	成功
RUN_STATE_FAILED	失败

---

响应示例（Response Example）

{
  "session_id": "your_chatbot_id",
  "content": [
    {
      "type": "CONTENT_TYPE_TEXT",
      "text": "你好！有什么我可以帮助你的吗？"
    }
  ],
  "state": "RUN_STATE_SUCCEEDED",
  "reasoning_content": "用户的问题与日常咨询相关，无需额外检索"
}

---

附录

ChatbotStatus

枚举值	含义
CHATBOT_STATUS_DRAFT	草稿
CHATBOT_STATUS_PUBLISHED	已发布

---

如需进一步支持，请联系平台开发者。