# Register and test in AMC

Agent Mission Control developer docs > Microsoft Agent Framework (Python)

> Import a Foundry project or register one hosted agent, name it so AMC classifies it correctly, and confirm steps and tokens arrive.

**Before you start:** A deployed hosted agent or workflow, and the Department Manager or Tenant Admin role in AMC. An Agent Manager can register only Kind = Agent: no workflows, and no project import.

The general registration steps are in [Register your agent](https://www.agentmissioncontrol.ai/developers/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. Go to **Agents** and select **Import from Foundry**.
2. Enter the **Foundry project endpoint**: the project URL, such as `https://<resource>.services.ai.azure.com/api/projects/<project>`, not an individual agent URL.
3. Choose the **Department**. Every imported agent is scoped to it.
4. Choose 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. Go to **Agents** and select **Register**.
2. Set **Adapter** to **Azure AI Foundry**.
3. Set **Kind** to **Workflow** or **Agent**. It can't change after registration.
4. Set **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. Choose 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:

| Name contains | AMC treats it as | Effect |
| --- | --- | --- |
| `subagent` | An internal helper | Hidden from AMC's catalog. It can't be run on its own. |
| `agent` (and not `subagent`) | A single agent | Imported with **Kind** **Agent**. |
| Neither | A workflow | Imported with **Kind** **Workflow**. |

> **Important:** A workflow named like `multi-agent-research` contains `agent`, so an import classifies it as a single agent. Keep `agent` out of workflow names, or register the workflow by hand with **Kind** set to **Workflow**.

**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. Before AMC, run the client script from [Host and deploy on Foundry](https://www.agentmissioncontrol.ai/developers/af-host-and-deploy/) 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. In AMC, select **Run now** for the registration and open the run.
3. Check that each executor shows as its own step with its result and model usage, and that the run total is not zero.
4. For 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. For a human-input workflow, check the **Human input** step shows your question, answer it, and confirm the run continues to completion.
6. If 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.

## Related

- [Troubleshoot Agent Framework agents](https://www.agentmissioncontrol.ai/developers/af-troubleshooting/)
- [Report steps, tokens and human input](https://www.agentmissioncontrol.ai/developers/af-report-to-amc/)
- [Host and deploy on Foundry](https://www.agentmissioncontrol.ai/developers/af-host-and-deploy/)

---
Source: https://www.agentmissioncontrol.ai/developers/af-register-and-test/ · Last updated 2026-10-21 · Full index: https://www.agentmissioncontrol.ai/llms.txt