Register and test in AMC

The general registration steps are in Register your agent. This page covers what is specific to a Foundry-hosted Agent Framework agent.

Give AMC access to the project

AMC lists and runs Foundry agents either with its own managed identity or with a project API key.

• •Managed Identity (same tenant): grant AMC's managed identity a least-privilege role on the project, such as Azure AI User. Without it, AMC reports Access not granted.
• •API key: paste the project key. AMC stores it and never shows it again.

Import a whole project

1. 1Go to Agents and select Import from Foundry.
2. 2Enter the Foundry project endpoint: the project URL, such as https://<resource>.services.ai.azure.com/api/projects/<project>, not an individual agent URL.
3. 3Choose the Department. Every imported agent is scoped to it.
4. 4Choose the authentication mode and select Import project.

AMC adds one registration per agent and workflow in the project. Running the import again is safe: existing registrations stay, and only new ones are added.

Register one agent

1. 1Go to Agents and select Register.
2. 2Set Adapter to Azure AI Foundry.
3. 3Set Kind to Workflow or Agent. It can't change after registration.
4. 4Set Endpoint URL to the agent's URL in the project, <project-endpoint>/agents/<agent-name>/.... AMC reads the agent name from the segment after /agents/.
5. 5Choose the department and authentication, then save.

Name agents and workflows deliberately

Foundry doesn't tell AMC whether a hosted agent is a workflow, so AMC classifies by the deployed name, ignoring case:

Kind matters at run time. AMC runs a workflow in background mode (background: true, store: true), which is what lets it reconnect to a run after a dropped connection. By default, a registration is run in the older foreground shape only when its Kind is Agent and its type doesn't name a workflow.

Test it

1. 1Before AMC, run the client script from Host and deploy on Foundry with x-ms-debug-mode-enabled. Confirm one response.output_item.done per step whose item name is the step id and whose arguments JSON has delivered, the token counts and model.
2. 2In AMC, select Run now for the registration and open the run.
3. 3Check that each executor shows as its own step with its result and model usage, and that the run total is not zero.
4. 4For a workflow, force a failure (for example, an invalid model name) and check the failed step shows the failure_reason text. A single agent has no per-step failure; the run itself fails.
5. 5For a human-input workflow, check the Human input step shows your question, answer it, and confirm the run continues to completion.
6. 6If you send activity_log, select Show details on the step and check the rows.

Make sure every model the agent can run has a token rate configured in AMC, or its steps are priced at AMC's default rate.