Agent Setup
The Dashboard Agent Setup page is where you configure how Azent connects to Azure DevOps, which AI provider to use, and who can trigger the agent. Changes here apply to every run in this workspace.
Overview
- •Azure DevOps connection — organization, PAT, and webhook secret. Secrets are stored encrypted and shown only as
***last4. Leave a secret field blank to keep the saved value. Test connection verifies the PAT can read the org. - •Connected as — the DevOps identity the saved PAT belongs to. The agent posts and acts as this user. Refresh re-fetches it.
- •AI agent — pick Codex (OpenAI) or Claude (Anthropic), and whether to call the provider directly or via Azure Foundry. The form swaps the fields below to match the chosen combination.
- •Workflow — the master prompt the agent follows on every run, plus the allowed-group name (only members of this Azure DevOps group can trigger the agent) and the optional repository field name for custom work-item mappings.
- •Save with the footer button. The form refuses to save while required fields are empty.
General settings
| Setting | Description |
|---|---|
| Organization | Your Azure DevOps organization name. Changing this will re-register all webhooks. |
| PAT | Personal Access Token for the bot user. Shown as masked in the UI — update by entering a new value. |
| Allowed group | Only members of this Azure DevOps group can trigger the agent. Default: Contributors |
| Agent provider | Claude (Anthropic) or Codex (OpenAI) |
| Connection type | API (direct provider API) or Foundry (Azure AI Foundry deployment) |
| API key | The API key for the selected provider/connection type |
| Webhook receiver URL | The public URL where Azure DevOps sends webhooks. In SaaS mode this is managed automatically. |
Azure AI Foundry settings
When using the Foundry connection type, these additional fields are required:
| Setting | Description |
|---|---|
| Foundry base URL | Your Azure AI Foundry endpoint URL (without trailing slash) |
| Foundry deployment name | The name of the model deployment in Foundry |
| Foundry key | API key for the Foundry deployment |
Workflow prompt
The workflow is the system prompt template that controls how the agent behaves. A default workflow is provided that covers all standard use cases. You can customize it in the configuration settings to change the agent's behavior globally across all projects in the workspace.
Tip: For project-specific instructions, use the project preprompt in .azent.json instead of modifying the global workflow.