Calibrant
← Back to Docs

Finding your Copilot Studio Agent ID

To register a Copilot Studio agent in Calibrant, you need its Agent ID (also called the Bot ID). This uniquely identifies your agent in Microsoft's infrastructure.

The Agent ID can be a GUID like abcd1234-ef56-7890-... or a Copilot Studio internal format like cr0f1_myBot. Either format works.

Option 1: From Copilot Studio

This is the quickest method if you have access to Copilot Studio.

  1. Go to copilotstudio.microsoft.com and sign in with your admin account.
  2. Select the agent (copilot) you want to optimize.
  3. Click Settings (gear icon) in the top-right corner.
  4. Go to the Details tab.
  5. Find the Bot ID field — copy this value.
The Bot ID is also visible in the URL when you have the agent open. Look for the botId= parameter in your browser's address bar.

Option 2: From the Teams App Manifest

If your agent is published as a Teams app:

  1. Go to the Teams Admin Center → Teams apps → Manage apps.
  2. Find your copilot agent in the app list.
  3. Click on it and look for the Bot ID in the app details.

Option 3: From the Azure Portal

If you have access to your Azure subscription:

  1. Go to portal.azure.com.
  2. Search for "Azure Bot" in the top search bar.
  3. Select the bot resource associated with your Copilot Studio agent.
  4. The Microsoft App ID on the overview page is your Agent ID.
Copilot Studio agents automatically get an Azure Bot resource. You don't need to create one manually.

Example formats

# GUID format (most common)
abcd1234-ef56-7890-abcd-ef1234567890

# Copilot Studio internal format
cr0f1_myHRSupportBot

# Either format works in Calibrant

Next steps

You'll also need a Direct Line secret to enable Calibrant to test your agent. Then you can register it.