Microsoft Foundry

​

Overview

StackOne A2A agents are standard A2A agents, so 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 across your connected SaaS applications.

​

Connect StackOne in Foundry

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 (see below).
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 the Python, C#, JavaScript, Java, and REST examples, see Microsoft’s guide: Connect to an A2A agent endpoint from Foundry Agent Service.

​

Authentication

A StackOne agent authenticates with two HTTP headers: your StackOne API key sent as HTTP Basic, plus your account ID.

• Authorization: Basic <base64-encoded "<api_key>:">
• x-account-id: <account_id>

Configure both as custom headers on the Foundry A2A connection, so Foundry sends them on the agent-card fetch and on every message. See Authentication for how to build the Basic token and find your account ID.

​

Next steps