CreateDataAgent - - 阿里雲

介面說明

DataAgent 是日誌服務中的智能體資源：它以您指定的 RAM 角色（roleArn）的身份存取您帳號下的資料，並結合關聯的上下文模型理解您的業務口徑，用於回答自然語言問題、執行分析與生成產物。

呼叫本介面前，請確認：

roleArn 指向的 RAM 角色已授權日誌服務扮演；使用 RAM 使用者或扮演角色呼叫時，呼叫者還需具備該角色的 ram:PassRole 權限。
需要關聯的上下文模型已在同一帳號下建立。

首次在某帳號下建立 DataAgent 時，日誌服務會自動為該帳號建立服務關聯角色 AliyunServiceRoleForSLSSemantic，並為您啟用 DataAgent 商品，無需額外操作。若呼叫者缺少建立該服務關聯角色的權限，介面會返回 401，需要主帳號授予 ram:CreateServiceLinkedRole 後重試。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:CreateDataAgent

create

*All Resource

*

無

請求文法

POST /dataagents HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求主體。建立 DataAgent 所需的組態。
description	string	否	DataAgent 的描述，用於說明它的職責範圍與適用場景，僅供展示與檢索，不影響執行行為。列表介面的 keyword 會與該描述做模糊比對。	負責分析訂單與收入相關日誌，並按日輸出彙總報表
displayName	string	否	顯示名稱，供介面展示的短標題，可使用中文、空格與標點，長度上限 256 個字元（按字元數計算，非位元組數）。不傳或傳空字串表示未設定，此時介面回顯空字串 `""`（不會回填成 `name`），展示時可按 `displayName \|\| name` 回退。	訂單分析助手
name	string	是	DataAgent 的名稱，在同一帳號內必須唯一。僅支援大小寫字母、數字、底線（_）與連字號（-），長度 4~128 個字元。建立後不可修改，後續查詢、更新、刪除 DataAgent 及其工作階段均以此名稱定位資源。	order-analysis-agent
roleArn	string	是	DataAgent 扮演並用於存取您帳號下資源的 RAM 角色 ARN，形如 acs:ram::<阿里雲帳號 UID>:role/<角色名稱>。該角色需要允許日誌服務扮演，DataAgent 才能以它的權限讀取您的資料。使用 RAM 使用者或扮演角色呼叫時，呼叫者還必須擁有該角色的 ram:PassRole 權限，否則返回 401。	acs:ram::123456789012****:role/sls-dataagent-role
contextModels	array	是	為該 DataAgent 關聯的上下文模型名稱清單。上下文模型為 DataAgent 提供業務語意（資料來源、指標、維度與術語），關聯後 DataAgent 回答問題時才能定位到您的日誌資料。
	string	否	單一上下文模型的名稱，須是當前帳號下已建立的上下文模型。	order-context
systemPrompt	string	否	DataAgent 的系統提示詞，用於設定它的角色定位、能力邊界與回答風格。	您是訂單域的資料分析助手，只回答與訂單、收入相關的問題，不確定時說明原因而不是猜測

返回參數

名稱	類型	描述	樣本值
	object	回應主體。返回建立完成的 DataAgent 組態，欄位與請求主體一致。
description	string	DataAgent 的描述。未設定時返回空字串。	負責分析訂單與收入相關日誌，並按日輸出彙總報表
displayName	string	顯示名稱。未設定時返回空字串 `""`（不會回填成 `name`），展示時請按 `displayName \|\| name` 回退。	訂單分析助手
userId	string	該 DataAgent 歸屬的阿里雲帳號 ID。	123456789012****
createdAt	string	建立時間，UTC 時區的 ISO8601 格式，精確到秒。	2026-08-14T10:00:03Z
contextModels	array	該 DataAgent 關聯的上下文模型名稱清單。
	string	單一上下文模型的名稱。	order-context
updatedAt	string	最近一次更新的時間，格式同 createdAt。	2026-08-15T09:20:31Z
systemPrompt	string	DataAgent 的系統提示詞。未設定時返回空字串。	您是訂單域的資料分析助手，只回答與訂單、收入相關的問題，不確定時說明原因而不是猜測
roleArn	string	DataAgent 扮演的 RAM 角色 ARN。	acs:ram::123456789012****:role/sls-dataagent-role
name	string	DataAgent 的名稱。	order-analysis-agent

樣本

正常返回樣本

JSON格式

{
  "description": "負責分析訂單與收入相關日誌，並按日輸出彙總報表",
  "displayName": "訂單分析助手",
  "userId": "123456789012****",
  "createdAt": "2026-08-14T10:00:03Z",
  "contextModels": [
    "order-context"
  ],
  "updatedAt": "2026-08-15T09:20:31Z",
  "systemPrompt": "你是訂單領域的資料分析助手，只回答與訂單、收入相關的問題，不確定時說明原因而不是猜測",
  "roleArn": "acs:ram::123456789012****:role/sls-dataagent-role",
  "name": "order-analysis-agent"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
403	ExceedQuota	The number of DataAgents has reached the upper limit for this account. Delete unused DataAgents or contact the administrator to raise the quota.

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

變更歷史

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