Skip to main content
An agent built in Microsoft Foundry (Azure AI Foundry Agent Service) can call a StackOne agent through Foundry’s A2A tool. Your Foundry agent stays in control of the conversation and calls the StackOne agent to search and execute actions.
Microsoft Foundry’s A2A tool is in public preview on Microsoft’s side. StackOne agent cards work with it.
In the Foundry portal, create a connection to the StackOne agent endpoint, then attach it to your agent:
  1. Go to Tools and select Connect tool.
  2. On the Custom tab, select Agent2Agent (A2A), then Create.
  3. Enter a Name and the StackOne A2A Agent Endpoint: https://a2a.stackone.com.
  4. Under Authentication, add the two StackOne headers: Authorization: Basic <base64 of apikey:> and x-account-id: <account_id> — configured as custom headers so Foundry sends them on the agent-card fetch and on every message. See Authentication.
  5. Add the A2A tool to your agent, referencing the connection. Foundry reads the StackOne agent card, and your agent can then call it.
For the full setup, including Python, C#, JavaScript, Java, and REST examples, see Microsoft’s guide: Connect to an A2A agent endpoint from Foundry Agent Service.