GetDataAgent - - 阿里雲

介面說明

按名稱返回單個 DataAgent 的完整配置，包括扮演的 RAM 角色、關聯的上下文模型與系統提示詞。DataAgent 不存在時返回 404。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:GetDataAgent

get

*DataAgent

acs:log:{#regionId}:{#accountId}:dataagent/{#name}

無

請求文法

GET /dataagents/{name} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
name	string	是	DataAgent 的名稱，須為當前帳號下已存在的 DataAgent。僅支援大小寫字母、數字、底線（_）與連字號（-），長度 4~128 個字元。	order-analysis-agent

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

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