Trying to connect the Azure BOT to Azure Foundry AI Agent what Messaging endpoint (Https:// ?) do we need to provide

Question

Trying to connect the Azure BOT to Azure Foundry AI Agent what Messaging endpoint (Https:// ?) do we need to provide

Sameer Mahajan 15

We are trying to connect the Azure BOT to Azure Foundry AI Agent. Within the BOT Configuration -> Messaging endpoint what URL needs to be provided so it can communicate with an Agent created within the Azure Foundry AI.

1.Can some one please share the detailed steps to get the https://URL for the Azure BOT as mentioned in https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-settings?view=azure-bot-service-4.0&tabs=userassigned#configuration

Also we understand we don't need to append the /api/messages as mentioned under https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/chat/quickstart-botframework-integration#create-a-messaging-endpoint-for-the-bot

thanks in advance

Saideep Anchuri 9,515 Reputation points Moderator

2025-06-05T04:03:25.6433333+00:00

Hello Sameer Mahajan,

Just checking in to see if the below answer provided by @ Suwarna S Kale Azar helped.

Thank You.
Sameer Mahajan 15 Reputation points

2025-06-05T13:54:25.66+00:00

Hi Suwarna S Kale,

Thank you for your response.

I have the following clarifications:

Navigate to Azure AI Studio --> Agents --> Your Agent --> Deployment.

With in the Azure AI Foundry - Agent the Deployment is the language model to use. Attached is the screen shot.

Q1. Can you please share the details navigation or screen shot of what you mean by Deployment?

Copy the HTTP endpoint URL (e.g., https://<agent-name>.azurewebsites.net).

Q2. As you can see in the screen shot the 3 agents have the same name. Azure identified each agent uniquely by giving it a unique Id (colums that are blacked out in the screen shot). So coping the HTTP endpoint URL with the agent-name does not help as it won’t know which of the agent it needs to pick out of three.

Ensure the Agent’s endpoint accepts Bot Framework activities (JSON payloads).

Q3, Where do you specify this? Can you please share the detailed navigation?

Use the Agent’s API key (or Azure AD auth) in the Bot’s appsettings.json.

Q4. What is the navigation to find the appsettings.json. The only Json, I can see is under Properties and that is for user defined tags. What use define tag we should use for the Agent’s API key (or Azure AD auth)?

Thanks in advance,

Sameer Mahajan
Saideep Anchuri 9,515 Reputation points Moderator

2025-06-07T08:52:46.9233333+00:00

Hello Sameer Mahajan,

Regarding your specific questions:

Q1: The "Deployment" you refer to in Azure AI Studio is where you select the language model for your agent. Unfortunately, I cannot provide screenshots or navigation details directly, but you can find the deployment settings under the Agents section in Azure AI Studio.

Q2: When you have multiple agents with the same name, Azure identifies them by their unique IDs. To ensure the correct agent is used, you should copy the HTTP endpoint URL associated with the specific agent's unique ID.

Q3: To ensure that the agent's endpoint accepts Bot Framework activities, you need to configure the messaging endpoint in your Azure Bot Service settings. This is typically done in the Azure portal under your Bot's configuration settings.

Q4: The appsettings.json file is usually found in your bot's project directory. If you are using a .NET project, you can add the Agent’s API key or Azure AD authentication details in this file. The user-defined tags you mentioned are not the correct place for this information; instead, you should directly edit the appsettings.json file.

Thank You.

2 answers

Your answer

Saideep Anchuri 9,515 Reputation points Moderator

2025-06-05T04:03:25.6433333+00:00

Hello Sameer Mahajan,

Just checking in to see if the below answer provided by @ Suwarna S Kale Azar helped.

Thank You.
Sameer Mahajan 15 Reputation points

2025-06-05T13:54:25.66+00:00

Hi Suwarna S Kale,

Thank you for your response.

I have the following clarifications:

Navigate to Azure AI Studio --> Agents --> Your Agent --> Deployment.

With in the Azure AI Foundry - Agent the Deployment is the language model to use. Attached is the screen shot.

Q1. Can you please share the details navigation or screen shot of what you mean by Deployment?

Copy the HTTP endpoint URL (e.g., https://<agent-name>.azurewebsites.net).

Q2. As you can see in the screen shot the 3 agents have the same name. Azure identified each agent uniquely by giving it a unique Id (colums that are blacked out in the screen shot). So coping the HTTP endpoint URL with the agent-name does not help as it won’t know which of the agent it needs to pick out of three.

Ensure the Agent’s endpoint accepts Bot Framework activities (JSON payloads).

Q3, Where do you specify this? Can you please share the detailed navigation?

Use the Agent’s API key (or Azure AD auth) in the Bot’s appsettings.json.

Q4. What is the navigation to find the appsettings.json. The only Json, I can see is under Properties and that is for user defined tags. What use define tag we should use for the Agent’s API key (or Azure AD auth)?

Thanks in advance,

Sameer Mahajan
Saideep Anchuri 9,515 Reputation points Moderator

2025-06-07T08:52:46.9233333+00:00

Hello Sameer Mahajan,

Regarding your specific questions:

Q1: The "Deployment" you refer to in Azure AI Studio is where you select the language model for your agent. Unfortunately, I cannot provide screenshots or navigation details directly, but you can find the deployment settings under the Agents section in Azure AI Studio.

Q2: When you have multiple agents with the same name, Azure identifies them by their unique IDs. To ensure the correct agent is used, you should copy the HTTP endpoint URL associated with the specific agent's unique ID.

Q3: To ensure that the agent's endpoint accepts Bot Framework activities, you need to configure the messaging endpoint in your Azure Bot Service settings. This is typically done in the Azure portal under your Bot's configuration settings.

Q4: The appsettings.json file is usually found in your bot's project directory. If you are using a .NET project, you can add the Agent’s API key or Azure AD authentication details in this file. The user-defined tags you mentioned are not the correct place for this information; instead, you should directly edit the appsettings.json file.

Thank You.

Answer 1

Hello Sameer Mahajan,

Thank you for posting your question in the Microsoft Q&A forum.

To connect your Azure Bot to an Azure AI Foundry Agent, the Messaging Endpoint in the Bot configuration should point to the Agent’s HTTP endpoint exposed by Azure AI Foundry. Follow these steps:

Retrieve the Agent’s Endpoint:
- Navigate to Azure AI Studio --> Agents --> Your Agent --> Deployment.
- Copy the HTTP endpoint URL (e.g., https://<agent-name>.azurewebsites.net).
Configure the Bot:
- In the Azure Portal, go to Bot Services --> Your Bot --> Configuration.
- Paste the Agent’s endpoint into the Messaging Endpoint field (no /api/messages needed).
- Ensure the Agent’s endpoint accepts Bot Framework activities (JSON payloads).
Authentication:
- Use the Agent’s API key (or Azure AD auth) in the Bot’s appsettings.json.
For troubleshooting, verify the Agent’s CORS settings and network policies.

Some reference documentation you may review:

https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-settings?view=azure-bot-service-4.0&tabs=userassigned

https://learn.microsoft.com/en-us/training/paths/develop-ai-agents-on-azure/

If the above answer helped, please do not forget to "Accept Answer" as this may help other community members to refer the info if facing a similar issue. Your contribution to the Microsoft Q&A community is highly appreciated.

Chris Clark 5 Reputation points

2025-08-20T17:06:34.88+00:00

There is No "appsettings.json" in the bot in azure portal.

Answer 2

Azar 29,620 MVP Volunteer Moderator

Hi there Sameer Mahajan

Thanks for using QandA platform

connect your Azure Bot to an Azure AI Foundry Agent, the Messaging endpoint in your Bot's configuration should point to the Foundry Agent endpoint URL, like thisa

https://<your-agent-name>.<region>.inference.azure.com/conversations/<agent-id>

Get your Agent endpoint from AI Studio (Foundry) after publishing your agent.

In Azure Bot resource → Configuration tab, set the Messaging endpoint to that URL.

Do not append /api/messages when integrating with Foundry Agents (unlike standard Bot Framework bots).

Make sure CORS and authentication settings are correctly configured in both services.

If this helps kindly accept the answer thanks much.

Sameer Mahajan 15 Reputation points

2025-06-05T13:55:43.3833333+00:00

Hi Azar,

Thank you for your response.

I have the following clarifications:

Get your Agent endpoint from AI Studio (Foundry) after publishing your agent.

Q1. I am unable to find the publish button or field on any of the UI screen. Could you please share the detailed navigation steps to publish the agent?

https://<your-agent-name>.<region>.inference.azure.com/conversations/<agent-id>

I did populate the BOT’s configuration Messaging endpoint as suggested above.

Q2. When I tried to test the same end point in the same browser where I was logged in to both the Azure Portal and AI foundary by opening a 3rd New window (not a incognito window) and pasted the https complete URL with and without appending /api/messages. I keep getting the error “This site can’t be reached Check if there is a typo in <your-agent-name>.<region>.inference.azure.com. If spelling is correct, try running Windows Network Diagnostics. DNS_PROBE_FINISHED_NXDOMAIN”

If this is a valid formulate URL should it not recognize the domain? Do you have an example of the screen shot of the actual working?

Thanks in advance,

Sameer Mahajan
Zain Baquar 0 Reputation points

2025-06-05T17:11:38.2033333+00:00

I would also like to know this, as I have been trying to get my AI foundry agent (which is connected to a fabric data agent) to work for a week now

Share via

Trying to connect the Azure BOT to Azure Foundry AI Agent what Messaging endpoint (Https:// ?) do we need to provide

2 answers

Your answer