エージェント・カードの取得

Select AIエージェント・チームのエージェント・カードを取得します。

エージェント・カードは、エージェントの機能と顧客対応の詳細を定義します。エージェント・カードURLは、サポートされている場合はA2Aクライアントで直接使用するか、このAPIを使用して取得し、返された情報でクライアントを構成できます。

エージェント・カードは、データベースに定義されているSelect AIエージェント・チームのメタデータに基づいて、A2Aサーバーによって自動的に生成および公開されます。A2Aサーバーは、エージェント・カードをJSONドキュメントとして構築し、A2Aクライアントの検出および相互作用のために標準エンドポイント.well-known/agent-card.jsonを介して公開します。

次の表に、Select AI Agent値がエージェント・カード・フィールドにどのようにマップされるかを示します。

エージェントカードフィールド	Select AI Agentマッピング
`name`	`DBMS_CLOUD_AI_AGENT.CREATE_TEAM`で使用される`team_name`値にマップします。
`description`	`DBMS_CLOUD_AI_AGENT.CREATE_TEAM`で使用される`description`値にマップします。設定されていない場合は、デフォルトで`team_name`値に設定されます。
`skills[].id`	`DBMS_CLOUD_AI_AGENT.CREATE_TOOL`を介して生成されたツールIDにマップします。
`skills[].name`	`DBMS_CLOUD_AI_AGENT.CREATE_TOOL`で使用される`tool_name`値にマップします。
`skills[].description`	`DBMS_CLOUD_AI_AGENT.CREATE_TOOL`で使用される`instruction`属性にマップします。

たとえば、チーム名がREPORT_SUMMARY_AGENT_TEAMで、説明がSummarizes uploaded reports and answers follow-up questionsの場合、エージェント・カードnameはREPORT_SUMMARY_AGENT_TEAMで、エージェント・カードdescriptionはSummarizes uploaded reports and answers follow-up questionsです。

tool_nameをSUMMARIZE_REPORT、instructionをSummarize uploaded reports and answer follow-up questionsとするツールを作成すると、エージェント・カード・スキル・エントリは、生成されたツールIDをskills[].id、SUMMARIZE_REPORTをskills[].name、Summarize uploaded reports and answer follow-up questionsをskills[].descriptionに使用します。

クライアントは、エージェント・カードを取得して、エージェントのコール方法とエージェントが提供する機能を理解します。

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

エンドポイント

GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json

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

ヘッダー
```
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json
```
プレースホルダを特定の値に置き換えます。
- region-identifier: Oracle Cloudリージョン識別子。
- token: Select AIエージェント・チームにアクセスできるデータベース・ユーザーのBearerトークン。
- database-ocid: A2A対応のAutonomous AI Database OCID。
- agent-team-name: データベースからSelect AIエージェント・チーム名。
返されたエージェント・カード仕様を確認します。

応答

A2Aプロトコルで定義されているエージェント・カード仕様を返します。

詳細は、AgentCardオブジェクト構造を参照してください。

例

次の例を使用して、エージェント・カードを取得します。

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

Oracle Cloud Infrastructureドキュメント

エージェント・カードの取得