使用可能なエージェントのリスト

特定のデータベース・ユーザーのA2Aエージェントとして公開されているSelect AIエージェント・チームのリスト(エージェント・カードURLおよび説明を含む)を取得します。

GETリクエストをA2Aエージェント・エンドポイントに送信します。

エンドポイント

GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/

必要なリクエスト・ヘッダーを含めます。

ヘッダー
```
Content-Type: application/json
Accept: application/json
Authorization: Bearer <token>
```
プレースホルダを特定の値に置き換えます。
- region-identifier: Oracle Cloudリージョン識別子。
- database-ocid: Autonomous AI DatabaseのOCID。
- token: Select AIエージェント・チームがリストされているデータベース・ユーザーのBearerトークンからaccess_token値を貼り付けます。詳細は、Bearerトークンの生成を参照してください。
A2Aサーバーから返された応答を確認します。

応答フォーマット
```
[
{
"agent_card_url": "https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json",
"name": "{agent-team-name}",
"description": "{agent-team-description}"
}
]
```
レスポンスの値は、データベースに定義されたエージェント・チームに基づいてA2Aサーバーによって生成されます。これらの値は変更または置換する必要はありません。
- agent_card_url: エージェント・チームのエージェント・カードを取得するためのURL。
- name: Select AIエージェント・チームの名前。
- description: Select AIエージェント・チームの説明。
レスポンスは、エージェント名、説明およびエージェント・カードURLを返します。このURLは、クライアントが使用可能なエージェントを検出して対話するために使用します。

例

使用可能なエージェントをリストするには、次の例を使用します。

curl -X GET 'https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>'

Oracle Cloud Infrastructureドキュメント

使用可能なエージェントのリスト