List Available Agents

Retrieve the list of Select AI agent teams exposed as A2A agents for a specific database user, including their Agent Card URLs and descriptions.

1. Send a GET request to the A2A agents endpoint.

   Endpoint

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

2. Include the required request headers.

   Headers

   Content-Type: application/json
   Accept: application/json
   Authorization: Bearer <token>

   Replace the placeholders with your specific values.

   • region-identifier: Oracle Cloud region identifier.

   • database-ocid: OCID of the Autonomous AI Database.

   • token: Paste the access_token value from the Bearer token for the database user whose Select AI agent teams are listed. SeeGenerate Bearer Token for details.

3. Review the response returned by the A2A server.

   Response Format

   [
   {
   "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}"
   }
   ]

   The values in the response are generated by the A2A server based on the agent teams defined in your database. You do not need to modify or replace these values.

   • agent_card_url: URL to retrieve the Agent Card for the agent team.

   • name: Name of the Select AI agent team.

   • description: Description of the Select AI agent team.

   The response returns agent names, descriptions, and Agent Card URLs, which clients use to discover and interact with the available agents.

Example

Use the following example to list available agents:

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>'