Calibrant
← Back to Docs

Register an Agent

Once you've connected Microsoft 365 and configured the Power Automate flow on the Connections page, you can register your Copilot Studio agents for optimization.

Prerequisites

Calibrant checks these before allowing registration:

  • M365 tenant connected — admin consent granted on the Connections page
  • Power Automate flow configured — flow URL and API key set, health check passed within 24 hours
If either prerequisite is missing, the registration dialog will show what's needed and link you to the Connections page to complete setup.

What you'll need

  • Agent Name — a friendly name (e.g., "HR Support Bot")
  • Copilot Studio Agent ID — the schema name from Copilot Studio
  • Connection String (optional) — from Copilot Studio → Channels → Native app. Required for persona-authenticated testing.

Register the agent

  1. Navigate to Agent Optimizer in the sidebar.
  2. Click the Register Agent button.
  3. Enter the agent name and Agent ID (schema name).
  4. Optionally expand Connection String and paste the URL from Copilot Studio → Channels → Native app. This enables persona testing.
  5. Click Register Agent.

Calibrant will automatically fetch the agent's current instructions via the Power Automate flow and save them as the baseline variant.

Why the baseline matters

The baseline is your agent's existing system prompt. It's important because:

  • It lets Calibrant measure a baseline score before optimization starts
  • You can see exactly how much improvement each optimization run achieves
  • The optimization engine uses the baseline as a starting point for generating variants
  • Without a baseline, the optimizer starts from scratch with no reference point
Instructions are fetched automatically via the Power Automate flow when you register or sync. You can also manually paste instructions if needed.

After registration

Your agent appears in the agent list. From its detail page you can:

  • View the current instructions and connection status
  • Assign test personas from the Connections page for persona-based testing
  • Create evaluation suites with test queries
  • Start optimization runs
  • Compare instruction variants and scores over time

Updating connection settings

You can update an agent's connection string or add legacy options (token endpoint, Direct Line secret) at any time from the agent detail page via Edit Connection.