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