GetAgent - DataWorks - Alibaba Cloud Documentation Center

Mengambil detail agen berdasarkan nama.

Deskripsi operasi

Permintaan

API ini menggunakan nama agen, yang diberikan sebagai parameter, untuk mengambil konfigurasi detailnya, termasuk konfigurasi model, sistem prompt, dan daftar tool.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
Name	string	Yes	Nama skill yang akan diambil.	my-skill

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	824F80BA-1778-5D8A-BAFF-668A4D9C4CC7
Agent	object	Detail agen.
CreatorId	string	ID pembuat.	123456
ModifierId	string	ID pengubah terakhir.	123456
Name	string	Nama agen.	my-agent
DisplayName	string	Nama tampilan.	我的助手
Description	string	Deskripsi.	数据分析助手
Model	object	Konfigurasi model.
ModelName	string		qwen3-max
Temperature	number		1
TopP	number		1
MaxTokens	integer		8192
Stream	boolean		true
Config	object		{}
SystemPrompt	string	Sistem prompt.	你是一个数据分析助手。
Tools	array<object>	Daftar tool.
	object
Kind	string		builtin
BuiltinName	string		builtin_sql
McpServerName	string		server-name
McpItems	array
	string		search_table
Skills	array<object>	Daftar skill.
	object
Name	string		my-skill
Version	integer		-
CallableAgents	array<object>	Daftar sub-agen yang dapat dipanggil.
	object
Name	string		sub-agent
DisplayName	string		子助手
Version	integer		-
Source	string		custom
RequiredRuntime	array	Dependensi runtime.
	string	Dependensi runtime.	-
Metadata	object	Metadata tambahan.	{}
Visibility	string	Tingkat visibilitas.	TENANT
VisibilityScope	object	Ruang lingkup visibilitas.
ProjectIds	array
	string		proj_001
UserIds	array
	string		123456
GmtCreateTime	string	Waktu pembuatan, sebagai Unix timestamp dalam milidetik.	1780555634000
GmtModifiedTime	string	Waktu modifikasi terakhir, sebagai Unix timestamp dalam milidetik.	1780555634000

Contoh

Respons sukses

JSONformat

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "Agent": {
    "CreatorId": "123456",
    "ModifierId": "123456",
    "Name": "my-agent",
    "DisplayName": "我的助手",
    "Description": "数据分析助手",
    "Model": {
      "ModelName": "qwen3-max",
      "Temperature": 1,
      "TopP": 1,
      "MaxTokens": 8192,
      "Stream": true,
      "Config": {}
    },
    "SystemPrompt": "你是一个数据分析助手。",
    "Tools": [
      {
        "Kind": "builtin",
        "BuiltinName": "builtin_sql",
        "McpServerName": "server-name",
        "McpItems": [
          "search_table"
        ]
      }
    ],
    "Skills": [
      {
        "Name": "my-skill",
        "Version": 0
      }
    ],
    "CallableAgents": [
      {
        "Name": "sub-agent",
        "DisplayName": "子助手",
        "Version": 0,
        "Source": "custom"
      }
    ],
    "RequiredRuntime": [
      "-"
    ],
    "Metadata": {},
    "Visibility": "TENANT",
    "VisibilityScope": {
      "ProjectIds": [
        "proj_001"
      ],
      "UserIds": [
        "123456"
      ]
    },
    "GmtCreateTime": "1780555634000",
    "GmtModifiedTime": "1780555634000"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.