SDK 向けにエージェントマーケットプレイスからエージェント情報を照会します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
alidns:DescribeAtiAgentRegisterInfoMarket |
list |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字以下にする必要があります。 |
eyJhbGciOiJIUzI1NiIsInR5cC.... |
| AgentHost |
string |
任意 |
エージェントが外部にサービスを提供するエンドポイントのドメイン名。 |
example.com |
| AgentVersion |
string |
任意 |
エージェントのバージョン。 |
5.0.1 |
| MaxResults |
integer |
任意 |
このリクエストで返すエントリの最大値。 |
100 |
| NextToken |
string |
任意 |
次のクエリ用のページネーショントークン。 |
4698691 |
|
任意 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンススキーマ。 |
||
| RequestId |
string |
一意のリクエスト ID。 |
0629502C-6224-5DC9-A8ED-2ED73A2E3931 |
| AgentRegisterInfoId |
string |
エージェント登録 ID。この ID は Alibaba Cloud ATS プラットフォームによって自動的に生成され、プラットフォーム内でグローバルに一意です。エージェント登録プロセス中に自動生成されます。API を介した複数ステップの登録プロセスでは、各ステップが同じエージェントに関連付けられ、完全な登録プロセスが完了することを保証するために、すべてのステップでこの ID を保持する必要があります。 |
2074753647748672512 |
| AgentId |
string |
実名認証後に CNNIC によって一元的に割り当てられるエージェント ID。AgentID は、エージェントを実名認証済みの登録者にバインドする一意の識別子として機能します。 |
gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca |
| AgentDisplayName |
string |
エージェントの表示名。 |
TestAgent |
| AgentHost |
string |
エージェントのホストアドレス。 |
www.example.com |
| AgentVersion |
string |
エージェントのバージョン。 |
3.9.3 |
| AgentDescription |
string |
エージェントの機能の説明。 |
Payment service |
| Status |
string |
DNS レコードのステータス。有効な値:
|
Disable |
| TrustLevel |
string |
信頼レベル。有効な値:
|
Basic authentication |
| Categories |
object |
||
| category |
array |
無視してください。 |
|
|
string |
無視してください。 |
Ignore |
|
| TrustCardContent |
string |
無視してください。 |
Ignore |
| Endpoints |
object |
||
| Endpoint |
array<object> |
各プロトコルのエンドポイント。 |
|
|
array<object> |
各プロトコルのエンドポイント。 |
||
| Protocol |
string |
エージェントエンドポイントが準拠する通信プロトコル標準。これにより、呼び出し元がエージェントをどのように呼び出すかが決定されます。有効な値:
他のエージェントまたはクライアントは、このプロトコル ID を使用してエージェントとの通信方法を決定します。たとえば、MCP プロトコルは MCP SDK を使用し、A2A は A2A SDK を使用し、OpenAPI は標準的な HTTP リクエストを使用します。 |
https |
| AgentUrl |
string |
エージェントエンドポイントの実際のサービスアドレス。これは、エージェントがオンラインで実行される HTTPS エントリポイントです。これは必須フィールドで、最大値は 500 文字です。 例: https://my-agent.example.com/mcp 呼び出し元は、DNS を介してエージェントを検出した後、この URL を使用して直接接続を開始できます。これは、エージェントが実際にオンラインになっているアドレスです。 |
https://www.example.com/mcp |
| Transports |
object |
||
| Transport |
array |
トランスポートメソッド。 |
|
|
string |
エージェントエンドポイントがサポートする通信トランスポートメカニズム。プロトコルと連携して機能します。次の表に、プロトコルと利用可能なトランスポートメソッドのマッピングを示します。
|
STREAMABLE-HTTP |
|
| MetadataUrl |
string |
エージェントのメタデータ記述ファイル (通常は JSON フォーマット) を指すオプションの URL。これにより、他のエージェントまたはクライアントは、接続前にエージェントの機能記述を自動的に検出できます。これには、エージェントがサポートする機能、入出力フォーマット、バージョン情報、その他の機能宣言が含まれます。 |
// https://my-agent.example.com/.well-known/agent.json { "name": "Intelligent Customer Service Assistant", "version": "1.2.0", "protocol": "MCP", "description": "An intelligent customer service agent that provides product consultation, order queries, and after-sales services", "capabilities": { "tools": [ { "name": "order_query", "description": "Query order status" }, { "name": "product_search", "description": "Search product information" }, { "name": "refund_request", "description": "Initiate a refund request" } ], "resources": [ { "uri": "faq://knowledge-base", "description": "FAQ knowledge base" } ] }, "endpoint": { "url": "https://my-agent.example.com/mcp", "transport": ["STREAMABLE-HTTP", "SSE"] }, "policy": { "authentication": "mTLS", "rateLimit": "100/min" } } |
| AccessDeniedDetail |
object |
アクセス拒否の詳細。このフィールドは RAM 認証が失敗した場合にのみ返されます。 |
|
| AuthAction |
string |
試行された未承認の操作。 |
AddRspDomainServerHoldStatusForGatewayOte |
| AuthPrincipalDisplayName |
string |
権限付与プリンシパルの表示名。 |
2015555733387XXXX |
| AuthPrincipalOwnerId |
string |
権限付与プリンシパルのオーナー ID。 |
1046973331XXXX |
| AuthPrincipalType |
string |
ID タイプ。 |
SubUser |
| EncodedDiagnosticMessage |
string |
暗号化された完全な診断メッセージ。 |
AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ== |
| NoPermissionType |
string |
認証失敗の理由。有効な値:
|
ImplicitDeny |
| PolicyType |
string |
ポリシータイプ。 |
DlpSend |
| NextToken |
string |
次のクエリ用のページネーショントークン。 |
4698691 |
| MaxResults |
integer |
このリクエストで返すエントリの最大値。 |
500 |
例
成功レスポンス
JSONJSON
{
"RequestId": "0629502C-6224-5DC9-A8ED-2ED73A2E3931",
"AgentRegisterInfoId": "2074753647748672512",
"AgentId": "gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca",
"AgentDisplayName": "测试Agent",
"AgentHost": "www.example.com",
"AgentVersion": "3.9.3",
"AgentDescription": "支付服务",
"Status": "Disable",
"TrustLevel": "基础认证",
"Categories": {
"category": [
"忽略"
]
},
"TrustCardContent": "忽略",
"Endpoints": {
"Endpoint": [
{
"Protocol": "https",
"AgentUrl": "https://www.example.com/mcp",
"Transports": {
"Transport": [
"STREAMABLE-HTTP\n"
]
},
"MetadataUrl": "// https://my-agent.example.com/.well-known/agent.json\n{\n \"name\": \"智能客服助手\",\n \"version\": \"1.2.0\",\n \"protocol\": \"MCP\",\n \"description\": \"提供产品咨询、订单查询、售后服务的智能客服Agent\",\n \"capabilities\": {\n \"tools\": [\n { \"name\": \"order_query\", \"description\": \"查询订单状态\" },\n { \"name\": \"product_search\", \"description\": \"搜索产品信息\" },\n { \"name\": \"refund_request\", \"description\": \"发起退款申请\" }\n ],\n \"resources\": [\n { \"uri\": \"faq://knowledge-base\", \"description\": \"FAQ知识库\" }\n ]\n },\n \"endpoint\": {\n \"url\": \"https://my-agent.example.com/mcp\",\n \"transport\": [\"STREAMABLE-HTTP\", \"SSE\"]\n },\n \"policy\": {\n \"authentication\": \"mTLS\",\n \"rateLimit\": \"100/min\"\n }\n}"
}
]
},
"AccessDeniedDetail": {
"AuthAction": "AddRspDomainServerHoldStatusForGatewayOte",
"AuthPrincipalDisplayName": "2015555733387XXXX",
"AuthPrincipalOwnerId": "1046973331XXXX",
"AuthPrincipalType": "SubUser",
"EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
"NoPermissionType": "ImplicitDeny",
"PolicyType": "DlpSend"
},
"NextToken": "4698691",
"MaxResults": 500
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。