CreateChat - 發起會話 - STAROps

建立對話

介面說明

發起會話

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

starops:CreateChat

none

*DigitalEmployee

acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}

無

請求文法

POST /chat HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求結構體
digitalEmployeeName	string	否	數字員工名稱	test
threadId	string	否	會話線程 ID	thread_id01
action	string	否	操作類型: create(預設), reconnect, stop	create
variables	object	否	變數列表	{ "workspace": "test", "region": "cn-beijing", "project": "test", "language": "zh", "timeZone": "Asia/Shanghai", "timeStamp": "1768893948", "startTime": 1768887171, "endTime": 1768890771, "skill": "trace" }
messages	array<object>	否	訊息列表
	array<object>	否	訊息
messageId	string	否	當前訊息唯一標識	message_id02
role	string	否	訊息的角色	system
contents	array<object>	否	文本或多模態數組
	object	否	文本或多模態
type	string	否	內容類型	text
value	string	否	內容的值	test
tools	array<object>	否	工具調用列表
	object	否	工具調用	{ "arguments": { "confidence": "high", "intent": "analyser", "is_new_turn": true, "language": "en", "title": "Root Cause of Alert" }, "id": "IntentRecognition", }

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
messages	array<object>	會話的訊息列表
	array<object>	訊息資料明細結構
version	string	訊息版本號碼	v0.1.0
parentCallId	string	上一層級執行 ID	sess_abc123
callId	string	當前執行 ID	call_search_001
role	string	訊息發起角色	tool
seq	integer	訊息序號	1
timestamp	string	timestamp / 納秒	1765000005
type	string	訊息具體類型	done
detail	string	訊息明細	test
contents	array<object>	內容資訊
	object	內容資訊明細結構	{ "append": false, "lastChunk": false, "type": "text", "value": "result output chunk" }
tools	array<object>	工具使用列表
	object	工具明細結構	{ "arguments": { "confidence": "high", "intent": "analyser", "is_new_turn": true, "language": "en", "title": "Root Cause of Alert" }, "id": "IntentRecognition", "name": "IntentRecognition", "status": "start", "toolCallId": "019bc1cb-adad" }
agents	array<object>	調用的 Agent 列表
	object	調用的 Agent 詳細內容	{ "callId": "019bc1cb-adad", "id": "analyser", "inputs": [ { "append": false, "lastChunk": false, "type": "text", "value": "Analyze this trace: TraceID=xxx" } ], "name": "analyser", "status": "start" }
events	array<object>	事件列表
	object	事件詳細內容	{ "payload": { "error": { "code": "TASK_FAILED", "message": "Invalid task parameter", "suggestion": "" }, "statistics": { "duration": 300000 }, "success": false }, "type": "task_finished" }
artifacts	array<object>	產物產出資訊
	object	產物明細的結構	{ "artifactId": "019bc1cb-9600-703axxx", "name": "sql output", "description": "sql generation task result", "extensions": ["sql_generation_tool", "sql_diagnosis"], "metadata": { "model": "qwen3-coder-plus" }, "parts": [ { "text": "select * from table", "kind": "text" } ] }
traceId	string	當前 message 請求的 id 資料根資料中第一個追蹤識別碼	21504600000008405622576e3b48
requestId	string	當前 message 請求的 id 資料根資料中第一個 RequestID	0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0

樣本

正常返回樣本

JSON格式

{
  "messages": [
    {
      "version": "v0.1.0",
      "parentCallId": "sess_abc123",
      "callId": "call_search_001",
      "role": "tool",
      "seq": 1,
      "timestamp": "1765000005",
      "type": "done",
      "detail": "test",
      "contents": [
        {
          "append": false,
          "lastChunk": false,
          "type": "text",
          "value": "result output chunk"
        }
      ],
      "tools": [
        {
          "arguments": {
            "confidence": "high",
            "intent": "analyser",
            "is_new_turn": true,
            "language": "en",
            "title": "Root Cause of Alert"
          },
          "id": "IntentRecognition",
          "name": "IntentRecognition",
          "status": "start",
          "toolCallId": "019bc1cb-adad"
        }
      ],
      "agents": [
        {
          "callId": "019bc1cb-adad",
          "id": "analyser",
          "inputs": [
            {
              "append": false,
              "lastChunk": false,
              "type": "text",
              "value": "Analyze this trace: TraceID=xxx"
            }
          ],
          "name": "analyser",
          "status": "start"
        }
      ],
      "events": [
        {
          "payload": {
            "error": {
              "code": "TASK_FAILED",
              "message": "Invalid task parameter",
              "suggestion": ""
            },
            "statistics": {
              "duration": 300000
            },
            "success": false
          },
          "type": "task_finished"
        }
      ],
      "artifacts": [
        {
          "artifactId": "019bc1cb-9600-703axxx",
          "name": "sql output",
          "description": "sql generation task result",
          "extensions": [
            "sql_generation_tool",
            "sql_diagnosis"
          ],
          "metadata": {
            "model": "qwen3-coder-plus"
          },
          "parts": [
            {
              "text": "select * from table",
              "kind": "text"
            }
          ]
        }
      ]
    }
  ],
  "traceId": "21504600000008405622576e3b48",
  "requestId": "0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。