microsoft-foundry

Microsoft Foundry Skill

This skill provides expert guidance for Microsoft Foundry. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Location	Description
Troubleshooting	L37-L52	Diagnosing and fixing Foundry agent issues: health checks, publishing/Copilot auth errors, training/eval problems, HTTP/webhook failures, data loss recovery, and debugging/tracing in VS Code.
Best Practices	L53-L72	Best practices for building, operating, and optimizing Foundry agents: prompts, tools, safety, routing, voice, evaluations, fine-tuning, reliability, performance, and production operations.
Decision Making	L73-L125	Guides for choosing models, deployments, networking, billing modes, and governance, plus planning migrations, lifecycle/retirement, DR, and rollout strategies for Microsoft Foundry and agents
Architecture & Design Patterns	L126-L135	Designing secure, scalable Foundry agents and toolboxes: networking in BYO VNets, data isolation, resilient long-running agents, tool search patterns, network isolation, and programmatic tool calling.
Limits & Quotas	L136-L165	Quotas, limits, and timeouts for Foundry agents and models, including tokens, rate limits, storage, sessions, audio streaming, Azure OpenAI/Claude/Fireworks usage, and deployment capacity.
Security	L166-L229	Security, identity, and governance for Foundry: auth/authorization patterns, Entra/RBAC, isolation, networking, data privacy, guardrails, safety policies, and secure tool/agent integrations.
Configuration	L230-L320	Configuring, deploying, securing, and monitoring Microsoft Foundry agents and models, including hosted/voice agents, networking, storage, evaluations, observability, and Azure OpenAI integrations.
Integrations & Coding Patterns	integrations.md	APIs and patterns for integrating Foundry agents/models with tools, data, voice/telephony, Realtime, Azure/OpenAI services, MCP, LangChain, and managing them via REST and observability.
Deployment	deployment.md	Deploying and operating Foundry agents/models: infra setup (azd, Bicep, Terraform), CI/CD, regional/ACR options, long‑running/steerable agents, evaluations, healthcare models, and outage recovery.

Troubleshooting

Topic	URL
Check hosted agent project health with agent doctor	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-doctor
Troubleshoot Microsoft Foundry hosted agent issues	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/debug-hosted-agent
Troubleshoot publishing Foundry agents to Copilot and Teams	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/troubleshoot-publish-copilot
Resolve authorization errors for Foundry agents in Copilot	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/troubleshoot-publish-copilot-authorization
Troubleshoot Foundry interactive training errors	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/interactive-post-training/troubleshoot
Recover Foundry Agent Service from resource and data loss	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery
Debug Foundry agents with Agent Inspector in VS Code	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/vs-code-agent-inspector
Collect and analyze Foundry agent traces in VS Code	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/vs-code-tracing
Troubleshoot Foundry evaluation and observability issues	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/troubleshooting
Troubleshoot HTTP errors for Azure OpenAI in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/troubleshoot-errors
Set up and troubleshoot Azure OpenAI webhooks	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/webhooks
Resolve known issues and workarounds for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues

Best Practices

Topic	URL
Apply tool usage best practices in Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice
Apply best practices for Microsoft Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-best-practice
Create evaluation datasets for Foundry agent optimizer	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/create-optimizer-dataset
Optimize instructions and prompts for Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/optimize-voice-agent-instructions
Recover long-running Foundry agents after crashes	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/recover-long-running-work
Steer in-flight turns for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/steer-hosted-agent
Use Task Adherence signals for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/guardrails/task-adherence
Use Foundry Skill prompts for common workflows	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/foundry-skills-scenarios-example-prompts
Fine-tune MedImageInsight Premium for medical imaging	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/fine-tune-medimageinsight-premium
Plan high availability and resiliency for Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency
Design effective system messages for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering
Understand and optimize Foundry model router behavior	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-router-how-it-works
Apply safety system message templates in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/safety-system-message-templates
Apply vision fine-tuning best practices in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision
Optimize Azure OpenAI latency and throughput in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/latency
Operate provisioned throughput deployments in production	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-get-started

Decision Making

Topic	URL
Choose networking options for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/networking-options
Understand pricing for Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-pricing
Plan migration to Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate
Decide and migrate to new Foundry agent model	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-agent-applications
Migrate from Voice Live to Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-from-voice-live
Choose the right web grounding tool for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-overview
Choose the right Microsoft Foundry capability	https://learn.microsoft.com/en-us/azure/foundry/concepts/capabilities
Use Foundry in Azure Government regions and endpoints	https://learn.microsoft.com/en-us/azure/foundry/concepts/foundry-azure-government
Plan general availability adoption of Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/general-availability
Compare Foundry models using benchmarks and leaderboards	https://learn.microsoft.com/en-us/azure/foundry/concepts/model-benchmarks
Plan Microsoft Foundry rollout topology and governance	https://learn.microsoft.com/en-us/azure/foundry/concepts/planning
Estimate and manage Foundry fine-tuning costs	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/cost-management
Use Foundry to generate synthetic training data	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/data-generation
Understand interactive training options in Foundry	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/interactive-post-training/overview
Choose fine-tuning methods and tiers in Foundry	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/overview
Choose and compare Claude models in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models
Plan and understand Claude CCU billing in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-billing
Compare Azure and Anthropic hosting for Claude models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-hosting-comparison
Choose Foundry model deployment types by scenario	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types
Select Foundry deployment types in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types-gov
Plan and execute model migration in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-migration
Manage model versioning and upgrade policies in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions
Choose and manage model version policies in Foundry Gov	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions-gov
Choose partner and community Foundry models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-from-partners
Select Azure-sold Foundry models by capabilities and regions	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure
Choose Azure Government Foundry models by region and type	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure-gov
Migrate applications from GitHub Models to Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/quickstart-github-models
Plan disaster recovery for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery
Use Foundry model leaderboard for selection	https://learn.microsoft.com/en-us/azure/foundry/how-to/benchmark-model-in-catalog
Choose Microsoft Foundry SDKs and project endpoints	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/sdk-overview
Select and use healthcare AI models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/healthcare-ai-models
Choose and implement Foundry app integration patterns	https://learn.microsoft.com/en-us/azure/foundry/how-to/integrate-with-other-apps
Plan and execute migration from Foundry classic portal	https://learn.microsoft.com/en-us/azure/foundry/how-to/navigate-from-classic
Upgrade Azure OpenAI resources to Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/upgrade-azure-openai
Choose content streaming mode for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-streaming
Choose GPT Realtime Transcribe for low-latency streaming	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-realtime-whisper
Plan for Foundry model retirement and replacements	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule
Use Azure Government model retirement schedule for migrations	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule-gov
Plan around Foundry Models lifecycle and retirements	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements
Plan for Foundry model lifecycle in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements-gov
Enable and evaluate priority processing in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/priority-processing
Decide when to use Azure OpenAI prompt transformation	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/prompt-transformation
Choose PTU billing mode and manage costs	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput-billing
Identify retired Foundry models and alternatives	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/retired-models
Evaluate model router for quality, cost, and latency	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/evaluate-model-router
Choose and use Flex processing for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/flex-processing
Use model router with Foundry agents effectively	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router-agents
Size provisioned throughput units for Foundry workloads	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-throughput-sizing
Migrate from preview to GA GPT Realtime API protocol	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-preview-api-migration-guide

Architecture & Design Patterns

Topic	URL
Plan Foundry Agent Service networking in BYO VNet	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agents-networking-deep-dive
Design resilient long-running hosted agents in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/long-running-agent-resilience
Set up standard agent resources with data isolation	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/standard-agent-setup
Design scalable tool search patterns for Foundry toolboxes	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-search
Design network-isolated toolboxes for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox-network-isolation
Choose programmatic tool calling with Responses API	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/programmatic-tool-calling

Limits & Quotas

Topic	URL
Evaluate agent optimizer cost and token usage	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-optimizer-costs
Understand durable state store limits for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-state-store
Quotas and limits for Microsoft Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/limits-quotas-regions
Understand vector store limits and expiration in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/vector-stores
Manage Foundry hosted agents and idle timeouts	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-agent
Manage Foundry hosted agent sessions and timeouts	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-sessions
Use function calling with Microsoft Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/function-calling
Evaluate Foundry with region support and rate limits	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-regions-limits-virtual-network
Set AI Gateway token limits and quotas in Foundry	https://learn.microsoft.com/en-us/azure/foundry/configuration/enable-ai-api-management-gateway-portal
Configure token rate limits and quotas in Foundry Control Plane	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-enforce-limits-models
Understand Claude model quotas and rate limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-quotas-limits
Reference quotas and limits for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/quotas-limits
Compare Fireworks model catalog limits and regions	https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/fireworks-model-catalog
Fine-tune and deploy CxrReportGen Premium with quotas	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/fine-tune-cxrreportgen-premium
Manage Foundry model deployment quotas and TPM limits	https://learn.microsoft.com/en-us/azure/foundry/how-to/quota
Manage provisioned throughput quotas for Foundry models	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput
Use Azure OpenAI global batch processing quotas	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/batch
Manage Azure OpenAI quota and rate limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/quota
Review Azure OpenAI quotas and limits in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits
Reference quotas and limits for Azure OpenAI in US Government	https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits-gov
Stream audio for Azure Foundry voice agent item	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-endpoint-conversations-get-agent-conversation-audio-item-content
Stream generated audio for Azure Foundry voice agent	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-endpoint-conversations-get-agent-conversation-generated-audio-item-content
Delete files and directories in Azure Foundry agent session sandbox	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-session-files-delete-session-file
Upload file to Azure Foundry agent session sandbox	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-session-files-upload-session-file
Establish WebSocket connection to Azure Foundry hosted agent	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-websocket-connect-endpoint-websocket
Stream console logs via SSE for Azure Foundry hosted agent session	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agents-get-session-log-stream

Security

Topic	URL
Integrate Foundry agents with Microsoft Agent 365	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-365-integration
Choose authorization options for Foundry agent endpoints	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-endpoint-authorization
Understand and govern Foundry agent identities	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-identity
Choose authentication methods for A2A tools in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-to-agent-authentication
Manage Entra consent for delegated agent access	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/entra-delegated-access-consent
Reference permissions for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-permissions
Use hosted-agent token service for downstream access	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-token-service
Select user delegation methods for Foundry tools	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/user-delegation
Set up secure environment for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/environment-setup
Attach RAI guardrails to Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-hosted-agent-guardrails
Publish and secure Microsoft Foundry agent applications	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-applications
Configure Agent 365 data collection for Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent-365-data-collection
Configure endpoint authorization for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent-endpoint-authorization
Configure user delegation for Foundry agent tools	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-user-delegation
Assign Agent 365 observability app role in Entra	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/grant-agent-365-permissions
Isolate Microsoft Foundry hosted agent sessions	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/isolate-sessions-per-user
Control and disable Grounding with Bing access	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-grounding-with-bing
Configure MCP server authentication for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/mcp-authentication
Multiplex users safely in Foundry agent sessions	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/multiplex-session-users
Migrate Foundry agent isolation keys to identities	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/pass-isolation-keys
Secure private container registries for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-registry-connections
Securely use the computer use tool in Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/computer-use
Govern MCP tools via AI gateway and API Management	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/governance
Ground Foundry agents with SharePoint while preserving access controls	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/sharepoint
Configure toolbox authentication and identity passthrough	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-authentication
Configure private networking for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/virtual-networks
Map elevated Azure roles to Foundry admin tasks	https://learn.microsoft.com/en-us/azure/foundry/concepts/administrator-guide
Configure authentication and RBAC for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/authentication-authorization-foundry
Configure VNet support for Foundry evaluations	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-virtual-network
Configure RBAC roles and scopes in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry
Control Foundry agent availability with Entra governance	https://learn.microsoft.com/en-us/azure/foundry/control-plane/govern-agent-infrastructure-entra-admin
Configure compliance and security for Foundry control plane	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-manage-compliance-security
Create and apply Foundry guardrail policies	https://learn.microsoft.com/en-us/azure/foundry/control-plane/quickstart-create-guardrail-policy
Configure Entra ID keyless auth for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-entra-id
Understand default safety policies in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/guardrails/default-safety-policies
Configure guided safety and security guardrails for agents	https://learn.microsoft.com/en-us/azure/foundry/guardrails/guided-set-up
Add Microsoft Foundry resources to network security perimeters	https://learn.microsoft.com/en-us/azure/foundry/how-to/add-foundry-to-network-security-perimeter
Create custom Azure Policies for Microsoft Foundry governance	https://learn.microsoft.com/en-us/azure/foundry/how-to/custom-policy-definition
Apply Foundry Content Safety middleware in LangChain	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-middleware
Restrict preview features in Microsoft Foundry environments	https://learn.microsoft.com/en-us/azure/foundry/how-to/disable-preview-features
Configure managed virtual networks for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/managed-virtual-network
Use built-in Azure Policies to govern Foundry model deployment	https://learn.microsoft.com/en-us/azure/foundry/how-to/model-deployment-policy
Govern Foundry model router deployments with Azure Policy	https://learn.microsoft.com/en-us/azure/foundry/how-to/model-router-policy
Apply security and governance to Foundry MCP Server tools	https://learn.microsoft.com/en-us/azure/foundry/mcp/security-best-practices
Control and govern trace data collection in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/concepts/trace-data
Assign roles for Microsoft Foundry evaluation workflows	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-permissions
Configure Entra auth for Foundry trace ingestion	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-ingestion-entra-authentication
Restrict access to sensitive content in Foundry traces	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-sensitive-content
Design safety system messages for Azure OpenAI in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/system-message
Apply safety evaluation to fine-tuned models	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-safety-evaluation
Create hosted session for Azure Foundry agent endpoint	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/agents-create-session
Retrieve SAS credentials for Azure Foundry datasets	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/datasets-get-credentials
Get temporary storage credentials for Azure Foundry model assets	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/models-get-credentials
Create short-lived Realtime client secrets for Azure Foundry sessions	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-client-secret
Create ephemeral tokens and Realtime sessions for Azure Foundry clients	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-session
Create ephemeral transcription sessions and tokens in Azure Foundry	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-transcription-session
Create short-lived translation client secrets and sessions in Azure Foundry	https://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-translation-client-secret
Configure data privacy and security for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/agents/data-privacy-security
Understand data privacy for Claude models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/claude-models/data-privacy
Understand data privacy and security for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/openai/data-privacy

Configuration

Topic	URL
Define Foundry hosted agents with agent.yaml schema	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-yaml-reference
Configure hosted agents with azd azure.yaml reference	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/azure-yaml-reference
Configure capability hosts for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/capability-hosts
Implement hosted agent runtime contract in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-contract
Monitor and evaluate Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-observability
Add human-in-the-loop pauses to Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-human-in-the-loop
Inspect local Foundry agents with Agent Inspector	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-inspector
Author azure.yaml configuration for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/author-azure-yaml
Configure Foundry project context for azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/cli-project-context
Configure and publish Microsoft Foundry agent endpoints	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent
Configure environment variables for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-hosted-agent-env-variables
Configure OpenTelemetry export for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-hosted-agent-telemetry
Configure Microsoft Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-voice-agent
Configure Connected Foundry Models in Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/connected-models
Disable classic agents and assistants in Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/disable-classic-agents
Configure private inbound connectivity for Foundry IQ	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-tutorial-private-inbound
Configure private outbound dependencies for Foundry IQ	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-tutorial-private-outbound
Initialize a hosted agent project with azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/init-agent-project
Install and verify azd Foundry AI extensions	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/install-cli-foundry-extensions
Configure durable state for long-running Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-task-state
Stream and filter logs for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/monitor-hosted-agent-logs
Configure a private skill catalog for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-skill-catalog
Create a private MCP tool catalog with API Center	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-tool-catalog
Publish Foundry agents to Microsoft 365 and Teams via REST	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-copilot-virtual-network
Register external agents for Foundry observability	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/register-external-agent
Configure local run settings for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/run-hosted-agent-locally
Configure reconnectable streaming for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/stream-with-reconnect
Configure structured inputs for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/structured-inputs
Configure custom MCP code interpreter for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/custom-code-interpreter
Author and manage skills for Microsoft Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/skills
Configure and manage Microsoft Foundry toolboxes	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Configure and manage toolboxes for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Update Foundry hosted agent endpoints via azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/update-agent-endpoint-cli
Reconfigure model deployment for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/update-hosted-agent-model
Automate azd AI usage with coding agents and scripts	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-cli-with-coding-agents
Configure and manage Foundry agent routines	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-routines
Configure subagents within Microsoft Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-subagent-voice-first-agent
Configure Foundry Agent Service with your own Azure resources	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-your-own-resources
Publish and share Foundry voice agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/voice-agent-channels-publish
Configure customer-managed keys for Foundry resources	https://learn.microsoft.com/en-us/azure/foundry/concepts/encryption-keys-portal
Register and configure custom agents in Foundry	https://learn.microsoft.com/en-us/azure/foundry/control-plane/register-custom-agent
Configure Claude Code CLI and VS Code for Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-code
Configure Claude Desktop to use Microsoft Foundry inference	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-desktop
Configure monitoring for Foundry model deployments	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/monitor-models
Deploy and use FLUX image models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-flux
Configure and use MAI-Thinking-1 in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-mai-thinking
Configure guardrails and controls in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/guardrails/how-to-create-guardrails
Connect Microsoft Foundry to customer-managed storage	https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-foundry
Configure BYOS storage for Foundry Speech and Language	https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-speech-language-services
Configure Private Link network isolation for Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/configure-private-link
Configure and add connections in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/connections-add
Create and configure Microsoft Foundry projects	https://learn.microsoft.com/en-us/azure/foundry/how-to/create-projects
Provision Microsoft Foundry resources with Terraform	https://learn.microsoft.com/en-us/azure/foundry/how-to/create-resource-terraform
Prepare a development environment for Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/install-cli-sdk
Use Microsoft Foundry Skill with coding agents	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/use-microsoft-foundry-skill
Configure diagnostic logging for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/diagnostic-logging
Run evaluations from Microsoft Foundry portal	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-generative-ai-app
View and analyze evaluation results in Foundry portal	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-results
Import and deploy custom Fireworks models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/import-custom-models
Configure health and performance alerts for Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/stay-informed-service-health
Configure and use Insights for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/agent-insights
Configure and run benchmark evaluations in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/benchmark-evaluations
Set up cloud evaluations with Foundry SDK	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation
Evaluate deployed interactions via Foundry SDK	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation-deployed-interactions
Retrieve and interpret Foundry cloud evaluation results	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation-results
Use Foundry evaluation dataset schema and fields	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-dataset-schema
Prepare and structure Foundry evaluation datasets	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-datasets
Monitor Foundry agents with Agent Monitoring Dashboard	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/how-to-monitor-agents-dashboard
Set up human evaluation for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/human-evaluation
Configure end user feedback logging with OpenTelemetry	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/log-end-user-feedback
Analyze agent traces with Trace Replay in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-replay
Set up tracing for AI agents with Application Insights	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-setup
Convert Foundry agent traces into evaluation datasets	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-to-dataset
Configure and run evaluations for a hosted agent	https://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-evaluate-hosted-agent
Configure and use Azure OpenAI v1 API in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/api-version-lifecycle
Configure groundedness detection for RAG in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-groundedness
Configure GPT-Live events and session settings	https://learn.microsoft.com/en-us/azure/foundry/openai/gpt-live-reference
Automate Azure OpenAI deployments and TPM quota settings	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/automate-quota-deployments
Configure Azure OpenAI image generation models	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/dall-e
Configure GPT-Live delegation and client actions	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/gpt-live-delegation
Configure and use model router in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router
Inspect model router metadata for routing analysis	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/monitor-model-router
Create and manage reusable skills for Responses API shell	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/skills
Configure spillover traffic management for provisioned Azure OpenAI deployments	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/spillover-traffic-management
Monitor Azure OpenAI Foundry with Azure Monitor	https://learn.microsoft.com/en-us/azure/foundry/openai/monitor-openai-reference
Configure Azure OpenAI Realtime API events in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/realtime-audio-reference
Configure text watermarking for Foundry GPT deployments	https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/content-safety/enable-text-watermarking-gpt-models