Use External A2A Agents in Workflows

To use an external agent in a workflow created in AI Agent Studio, connect an externally hosted Agent2Agent server to Oracle Fusion AI Agent Studio as an outbound connector tool. Fusion Applications acts as the A2A client, the external service hosts the agent, publishes its Agent Card, authenticates requests, and returns A2A messages or tasks.

Prerequisites

  • Deploy the external agent on a stable HTTPS endpoint with a publicly trusted certificate.
  • Implement an A2A interface and version accurately declared by the Agent Card.
    • Use HTTP+JSON or JSONRPC as the agent card interface.
  • Choose an authentication scheme supported by Fusion Applications:
    • API Key
    • Bearer Token
    • OAuth 2
  • Obtain the required permissions.

Publish Agent Card

Publish the card at the any standard well-known URIsuch as https://{server_domain}/.well-known/agent-card.json,or retain the reviewed JSON file for upload during definition creation.

Create Connector in AI Agent Studio

To create and use the external A2A agent in your workflow, do these steps in AI Agent Studio:

  1. Generate the connector definition.
    1. Go to AI Agent Studio, and select the Connectors Connectors tab.
    2. Select Create Connector Definition.
    3. Enter the name for the connector definition.
    4. Select Type as Agent Card.
    5. Select the required Agent Card Source.
      1. Choose URL when Fusion Applications can retrive the card and specify the required URL Authentication.
      2. Choose Content to upload the reviewed JSON when URL retrieval is unavailable.
    6. Select Generate.
    7. Review and confirm that the intended interface, authentication scheme, skills, and required task lifecycle operations were generated.
  2. Create the connector instance.
    1. From the Connectors Connectors tab in AI Agent Studio, select Add Connector.
    2. Choose the generated A2A definition.
    3. Enter the identity and scope for the connector. Enter a name and code, and select the family and product used by the tool this connector will be added to.
    4. Enter the A2A Agent URL. Use the base URL declared by the selected interface. Make sure you don't add credentials in the URL.
    5. Select the generated authentication profile and enter the values for the fields.
    6. Create the connector.
  3. Create the connector tool.
    1. Go to the Resources Resources tab in AI Agent Studio, and select the Tools subtab.
    2. Select Add.
    3. From the Tool Type list, select Connector.
    4. Enter the tool name, description, and select the appropriate family and product. The tool code will be automatically populated based on the tool name.
    5. Enable Require Human Approval to ensure that a person reviews and approves any action before the tool runs.
      1. Actions: Select the required action to be done by the reviewer.
      2. Message: Enter instructions for the reviewer.
    6. From the Connector list, select the connector created previously.