Skill v1.0.4

Automated scan

microsoftdocs/agent-skills/microsoft-foundry

1 files

──Details

PublishedJune 23, 2026 at 08:27 AM

Content Hashsha256:d996baa8da7e7f62...

Git SHA145555f26c45

Bump Typepatch

Compare with v1.0.3

──Files

Files (1 file, 44.1 KB)

SKILL.md44.1 KBactive

SKILL.md · 357 lines · 44.1 KB

version: "1.0.4" name: microsoft-foundry description: Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with Azure OpenAI, model routing, VNet isolation, CI/CD, or LangChain/LangGraph, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Local (use microsoft-foundry-local), Microsoft Foundry Tools (use microsoft-foundry-tools). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-06-28" generator: "docs2skills/1.0.0"

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	Lines	Description
Troubleshooting	L37-L48	Diagnosing and fixing hosted agent issues, analyzing logs, handling model and evaluation problems, recovering from data/resource loss, configuring webhooks, and known Foundry service bugs/workarounds.
Best Practices	L49-L65	Best practices for designing, testing, evaluating, and optimizing Foundry agents—covering prompts, tools, routing, safety, human evals, metrics, latency, and fine-tuning (incl. vision).
Decision Making	L66-L107	Guidance for choosing Foundry models, deployments, regions, costs, lifecycle, and migration paths (classic → GA, Azure OpenAI, GitHub Models, agents, PTU, Realtime) and DR/networking options.
Architecture & Design Patterns	L108-L113	Designing Foundry agent architectures: VNet/subnet sizing, isolated resource layouts, high availability patterns, and model router patterns for routing and scaling AI workloads.
Limits & Quotas	L114-L132	Quotas, rate limits, regions, and cost controls for Foundry agents and models, including Azure OpenAI usage, vector/file search, sessions, deployments, caching, and fine-tuning.
Security	L133-L174	Security, identity, and compliance for Foundry: auth, RBAC, keys, private networking, guardrails, data privacy, policy enforcement, and secure configuration for agents, tools, and models.
Configuration	L175-L245	Configuring Microsoft Foundry agents and models: schemas, deployments, networking, security/guardrails, monitoring, tracing, evaluation, Azure OpenAI integration, and resource/environment setup.
Integrations & Coding Patterns	L246-L334	Patterns and code samples for integrating Foundry/ Azure OpenAI agents, tools, MCP, LangChain/LangGraph, search, storage, tracing, safety, fine-tuning, and external AI/model endpoints.
Deployment	L335-L356	Deploying and operating Foundry hosted agents and models: azd scaffolding, local/dev workflows, CI/CD (GitHub/Azure DevOps), ACR, workflows, evaluations, red teaming, and resilience.

Troubleshooting

Topic	URL
Check hosted agent project health with agent doctor	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-doctor
Diagnose and fix common hosted agent issues	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/debug-hosted-agent
Stream and analyze hosted agent logs via azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/monitor-hosted-agent-logs
Troubleshoot and understand Foundry partner models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-from-partners
Recover Foundry Agent Service from resource and data loss	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery
Troubleshoot Foundry evaluation and observability issues	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/troubleshooting
Set up and troubleshoot Azure OpenAI webhooks	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/webhooks
Known issues and workarounds for Microsoft Foundry services	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
Test hosted agents with unit and integration suites	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/test-hosted-agent
Use Task Adherence signals for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/guardrails/task-adherence
Evaluate Microsoft Foundry agents with built-in metrics	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluate-agent
Configure human evaluation workflows for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/human-evaluation
Improve Foundry agent prompts with Prompt Optimizer	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/prompt-optimizer
Design effective system messages for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering
Apply prompt engineering techniques for vision-enabled GPT models	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-4-v-prompt-engineering
Apply routing modes and best practices for model router	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
Fine-tune GPT-4 vision models with images	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
Check Foundry Agent Service feature availability in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/azure-government
Choose networking options for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/networking-options
Decide how to migrate to the new Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate
Migrate legacy Agent Applications to new model	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-agent-applications
Migrate hosted agents to refreshed Foundry preview	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-hosted-agent-preview
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 build approach	https://learn.microsoft.com/en-us/azure/foundry/concepts/choose-build-approach
Plan migration to the GA Microsoft Foundry portal	https://learn.microsoft.com/en-us/azure/foundry/concepts/general-availability
Plan and manage Microsoft Foundry cost usage	https://learn.microsoft.com/en-us/azure/foundry/concepts/manage-costs
Optimize Foundry model cost and performance	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-optimize-cost-performance
Choose Foundry deployment types and data residency options	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types
Choose Foundry deployment types in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types-gov
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
Select and plan use of Azure-sold Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure
Choose Foundry model deployment regions and types	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure-region-availability
Upgrade GitHub Models workloads to Foundry Models	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
Select and deploy Microsoft Foundry AI templates	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/ai-template-get-started
Interpret and compare Foundry evaluation results	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-results
Select and use healthcare AI models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/healthcare-ai-models
Choose integration patterns for Microsoft Foundry APIs	https://learn.microsoft.com/en-us/azure/foundry/how-to/integrate-with-other-apps
Plan migration from Foundry classic to current portal	https://learn.microsoft.com/en-us/azure/foundry/how-to/navigate-from-classic
Decide when to upgrade Azure OpenAI to Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/upgrade-azure-openai
Use Ask AI to upgrade or switch Foundry models	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/optimization-model-upgrade
Choose content streaming and filtering modes in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-streaming
Use Foundry model retirement schedule and replacements	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule
Use Foundry model retirement schedule in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule-gov
Plan around Foundry Models lifecycle and support policy	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements
Plan Foundry Models lifecycle in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements-gov
Plan and size provisioned throughput deployments in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput
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 choose alternatives	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/retired-models
Estimate and manage fine-tuning costs in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-cost-management
Use Foundry model router with agents for optimal model selection	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router-agents
Determine PTU capacity for Foundry workloads	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-throughput-sizing
Migrate from preview to GA Realtime API	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-preview-api-migration-guide

Architecture & Design Patterns

Topic	URL
Design networking and subnet sizing for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agents-networking-deep-dive
Design high availability for Microsoft Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency

Limits & Quotas

Topic	URL
Review quotas and limits for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/limits-quotas-regions
Use vector stores and file search limits in agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/vector-stores
Manage hosted agents and traffic routing in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-agent
Manage hosted agent sessions and persistence limits	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-sessions
Evaluation rate limits, regions, and enterprise options in Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-regions-limits-virtual-network
Configure token rate limits and quotas for Foundry models	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-enforce-limits-models
Use Claude models in Foundry with quotas and regions	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models
Apply quotas, limits, and timeouts for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/quotas-limits
Manage Microsoft Foundry model deployment quotas	https://learn.microsoft.com/en-us/azure/foundry/how-to/quota
Use Azure OpenAI global batch processing and quotas	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/batch
Use prompt caching to reduce Azure OpenAI costs	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/prompt-caching
Manage Azure OpenAI quota and rate limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/quota
Use reinforcement fine-tuning with cost safeguards	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/reinforcement-fine-tuning
Azure OpenAI quotas and limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits
Reference quotas and limits for Azure OpenAI in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits-gov

Security

Topic	URL
Configure and govern agent identities in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-identity
Configure authentication for Agent2Agent tools in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-to-agent-authentication
Understand permissions for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-permissions
Configure environment and RBAC for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/environment-setup
Understand Foundry Agent Service data and access	https://learn.microsoft.com/en-us/azure/foundry/agents/faq
Attach content safety guardrails to hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-hosted-agent-guardrails
Publish Foundry agent applications with auth and permissions	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
Assign Agent 365 observability app role in Entra	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/grant-agent-365-permissions
Control and disable Grounding with Bing access	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-grounding-with-bing
Configure authentication for MCP servers in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/mcp-authentication
Publish virtual network agents to Microsoft 365	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-copilot-virtual-network
Govern MCP tools via AI gateway and API Management	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/governance
Configure authentication and authorization in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/authentication-authorization-foundry
Configure customer-managed keys for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/encryption-keys-portal
Use Microsoft Foundry in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/concepts/foundry-azure-government
Use RBAC roles and scopes in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry
Govern Foundry agent infrastructure as Entra admin	https://learn.microsoft.com/en-us/azure/foundry/control-plane/govern-agent-infrastructure-entra-admin
Manage Foundry compliance and security integrations	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 Claude Code with secure Microsoft Foundry access	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-code
Set up Claude Desktop with Microsoft Foundry as provider	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-desktop
Configure keyless Entra ID authentication for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-entra-id
Configure guided safety and security guardrails for agents	https://learn.microsoft.com/en-us/azure/foundry/guardrails/guided-set-up
Configure private endpoints for Microsoft Foundry isolation	https://learn.microsoft.com/en-us/azure/foundry/how-to/configure-private-link
Create custom Azure Policy rules for Foundry resources	https://learn.microsoft.com/en-us/azure/foundry/how-to/custom-policy-definition
Restrict Microsoft Foundry preview features with RBAC and tags	https://learn.microsoft.com/en-us/azure/foundry/how-to/disable-preview-features
Secure Foundry with managed virtual network isolation	https://learn.microsoft.com/en-us/azure/foundry/how-to/managed-virtual-network
Enforce AI model deployment policies in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/model-deployment-policy
Enforce Foundry model router choices with Azure Policy	https://learn.microsoft.com/en-us/azure/foundry/how-to/model-router-policy
Secure Foundry MCP Server with RBAC and policies	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
Understand default Guardrail safety policies in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/default-safety-policies
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
Understand data privacy and security in Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/agents/data-privacy-security
Understand data privacy and security for Claude 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
Use agent.yaml schema to define Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-yaml-reference
Configure azure.yaml for Foundry hosted agent projects	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
Configure standard agent resources for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/standard-agent-setup
Inspect local hosted agents with Agent Inspector	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-inspector
Configure Foundry project context for azd AI commands	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 hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-hosted-agent-env-variables
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
Install and verify azd Foundry AI extensions	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/install-cli-foundry-extensions
Configure and use memory in Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/memory-usage
Configure isolation keys for hosted agent sessions	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/pass-isolation-keys
Configure a private tool catalog for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-tool-catalog
Register external agents for Foundry observability and evaluation	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/register-external-agent
Configure structured inputs for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/structured-inputs
Configure custom MCP-based code interpreter for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/custom-code-interpreter
Manage versioned skills with Foundry Skills API	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/skills
Configure tool search for large Foundry toolboxes	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-search
Update hosted agent endpoints and metadata with azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/update-agent-endpoint-cli
Change model deployments for 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 Foundry agents to use existing Azure resources	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-your-own-resources
Set up private networking for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/virtual-networks
Run Agent Optimizer to refine agent instructions	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-optimize-hosted-agent
Reference built-in evaluators and parameters in Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/built-in-evaluators
Configure rubric evaluators for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-evaluators/rubric-evaluators
Configure AI Gateway token limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/configuration/enable-ai-api-management-gateway-portal
Register and configure custom agents in Foundry	https://learn.microsoft.com/en-us/azure/foundry/control-plane/register-custom-agent
Use Microsoft Foundry model endpoints and authentication	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/endpoints
Configure Foundry model deployments with CLI and Bicep	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/create-model-deployments
Configure Azure Monitor for Foundry model deployments	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/monitor-models
Configure guardrails and controls in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/guardrails/how-to-create-guardrails
Configure Foundry managed network access to on-premises	https://learn.microsoft.com/en-us/azure/foundry/how-to/access-on-premises-resources
Configure bring-your-own storage for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-foundry
Set up BYOS for Speech and Language in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-speech-language-services
Use the 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 model and agent evaluations in Foundry portal	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-generative-ai-app
Enable and configure Fireworks models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/enable-fireworks-models
Import and deploy custom Fireworks models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/import-custom-models
Understand agent tracing behavior and data in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/concepts/trace-agent-concept
Run Foundry agent evaluations with azd CLI	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/azure-developer-cli-evaluation
Generate synthetic evaluation datasets in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-dataset-synthetic
Configure Agent Monitoring Dashboard for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/how-to-monitor-agents-dashboard
Log end user feedback with OpenTelemetry in Foundry	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/log-end-user-feedback
Use Ask AI to interpret Foundry monitoring dashboards	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/optimization-dashboard
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 to Application Insights for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-setup
Annotate Foundry traces with human feedback signals	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-annotations
Convert Foundry agent traces into evaluation datasets	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-to-dataset
Configure evaluation test suites for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-evaluate-hosted-agent
Enable and review tracing for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-tracing-hosted-agent
Configure and use Azure OpenAI v1 API in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/api-version-lifecycle
Configure Prompt Shields for Foundry model security	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-prompt-shields
Configure priority processing for Foundry model deployments	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/priority-processing
Automate Azure OpenAI deployments and TPM quota settings	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/automate-quota-deployments
Call chat completion models with Azure OpenAI in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/chatgpt
Configure Azure OpenAI image generation models	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/dall-e
Configure DPO fine-tuning for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-direct-preference-optimization
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
Check Azure OpenAI language support in Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/openai/supported-languages
Set up core Microsoft Foundry resources and access	https://learn.microsoft.com/en-us/azure/foundry/tutorials/quickstart-create-foundry-resources

Integrations & Coding Patterns

Topic	URL
Use agents, conversations, and responses via SDKs	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/runtime-components
Add Responses or Invocations protocol adapters	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-protocol-adapter
Integrate BYOM via AI gateways with Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/ai-gateway
Enable Agent2Agent endpoints for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/enable-agent-to-agent-endpoint
Connect Foundry agents to Foundry IQ knowledge bases	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-connect
Invoke hosted agents with azd commands	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/invoke-hosted-agent
Enable optimizer integration for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/make-agent-optimizer-ready
Connect Foundry agents to remote A2A endpoints	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/agent-to-agent
Integrate Azure AI Search with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/ai-search
Integrate Azure Speech MCP tool with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/azure-ai-speech
Integrate Azure Functions as tools for agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/azure-functions
Use Bing grounding tools with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/bing-tools
Configure Browser Automation tool for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/browser-automation
Use Code Interpreter tool in Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/code-interpreter
Integrate Foundry agents with computer use tool	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/computer-use
Add managed MCP connector servers to Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/connectors
Connect Foundry agents to Microsoft Fabric data	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/fabric
Connect Foundry agents to Fabric IQ	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/fabric-iq
Configure file search tool for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/file-search
Implement function calling with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/function-calling
Use image generation tool in Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/image-generation
Connect Foundry agents to MCP server endpoints	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/model-context-protocol
Connect OpenAPI tools to Microsoft Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/openapi
Ground Foundry agents with SharePoint content	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/sharepoint
Configure Foundry toolbox with external tools	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Enable web search tool in Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-search
Connect Foundry agents to Microsoft 365 via Work IQ	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/work-iq
Add declarative agent workflows using Foundry VS Code toolkit	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/vs-code-agents-workflow-low-code
Create a prompt agent using the Foundry SDK	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/prompt-agent
Ground hosted agents in Foundry IQ knowledge bases	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-foundry-iq-hosted-agent
Add persistent memory to Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-memory-hosted-agent
Build a toolbox and connect via MCP protocol	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-toolbox-agent
Call Foundry Responses API from application code	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/responses-api
Create custom evaluators in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-evaluators/custom-evaluators
Run fine-tuning jobs with azd extension	https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/fine-tune-cli
Generate text with Foundry Models via Responses API	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/generate-responses
Deploy and call Hugging Face models in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/hugging-face-models
Deploy and invoke MAI image models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-mai
Deploy and call DeepSeek-R1 in Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/tutorials/get-started-deepseek-r1
Integrate third-party safety guardrails with Foundry	https://learn.microsoft.com/en-us/azure/foundry/guardrails/third-party-integrations
Configure and manage Microsoft Foundry connections	https://learn.microsoft.com/en-us/azure/foundry/how-to/connections-add
Build LangGraph agents with Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-agents
Host LangGraph agents on Foundry hosted agent service	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-hosted-agents
Add Foundry long-term memory to LangChain apps	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-memory
Integrate Foundry Content Safety middleware in LangChain	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-middleware
Call Foundry models using LangChain integrations	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-models
Use Foundry Toolbox tools and skills in LangChain	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-toolbox
Trace LangChain apps with Foundry and Azure Monitor	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-traces
Run AI Red Teaming Agent scans locally	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/run-scans-ai-red-teaming-agent
Select and use Microsoft Foundry SDKs and endpoints	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/sdk-overview
Deploy and call CxrReportGen Premium for chest X-ray reports	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/deploy-cxrreportgen-premium
Deploy and call MedImageInsight Premium healthcare model	https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/deploy-medimageinsight-premium
Migrate Azure AI Inference SDK calls to OpenAI SDK	https://learn.microsoft.com/en-us/azure/foundry/how-to/model-inference-to-openai-migration
Integrate Azure Key Vault with Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/how-to/set-up-key-vault-connection
Use Foundry MCP Server tools and prompts	https://learn.microsoft.com/en-us/azure/foundry/mcp/available-tools
Build and register custom MCP servers for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/mcp/build-your-own-mcp-server
Connect VS Code to Foundry MCP Server securely	https://learn.microsoft.com/en-us/azure/foundry/mcp/get-started
Add OpenTelemetry client-side tracing to Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-client-side
Configure OpenTelemetry tracing for AI agent frameworks	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-framework
Use Azure OpenAI audio completions API	https://learn.microsoft.com/en-us/azure/foundry/openai/audio-completions-quickstart
Use groundedness detection with Foundry OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-groundedness
Configure and use Codex CLI with Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/codex
Call o3-deep-research via Azure OpenAI Responses API	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/deep-research
Fine-tune Foundry models via SDK and REST	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning
Fine-tune tool calling behavior in Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-functions
Implement function calling with Azure OpenAI in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/function-calling
Call Azure OpenAI vision-enabled chat models	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/gpt-with-vision
Configure JSON mode responses for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/json-mode
Call and configure Foundry model router	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router
Optimize latency with predicted outputs in Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/predicted-outputs
Implement GPT Realtime audio with Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio
Use GPT Realtime API over SIP	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-sip
Use GPT Realtime API over WebRTC	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-webrtc
Use GPT Realtime API over WebSockets	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-websockets
Use Azure OpenAI Responses API with Python and REST	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/responses
Call Foundry models via Responses API with routing	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/responses-model-routing
Run shell commands with Azure OpenAI Responses API	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/shells
Use structured outputs and JSON schema with Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/structured-outputs
Enable and configure web search tool in Responses API	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/web-search
Use WebSocket mode with Azure OpenAI Responses API	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/websockets
Use Azure OpenAI image and audio REST APIs (GA)	https://learn.microsoft.com/en-us/azure/foundry/openai/reference
Use Azure OpenAI image and audio REST APIs (preview)	https://learn.microsoft.com/en-us/azure/foundry/openai/reference-preview
Use Azure OpenAI image, audio, and video REST APIs (preview)	https://learn.microsoft.com/en-us/azure/foundry/openai/reference-preview-latest
Use Azure OpenAI Whisper for speech to text	https://learn.microsoft.com/en-us/azure/foundry/openai/whisper-quickstart
Get started coding with the Microsoft Foundry SDK	https://learn.microsoft.com/en-us/azure/foundry/quickstarts/get-started-code

Deployment

Topic	URL
Build and operate hosted agents with azd	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/cli-agent-development
Understand azd-scaffolded infrastructure for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/cli-infrastructure
Publish Foundry hosted agents to Microsoft Agent 365	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-365
Deploy containerized hosted agents to Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent
Deploy hosted agents from source code in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent-code
Deploy hosted agents using private Azure Container Registry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent-private-azure-container-registry
Initialize hosted agent projects with azd templates	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/init-agent-project
Run and test hosted agents locally with azd	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/run-hosted-agent-locally
Configure CI/CD pipelines for Foundry hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/set-up-ci-cd-cli
Create and deploy hosted agent workflows from VS Code	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/vs-code-agents-workflow-pro-code
Deploy custom Python agent code to Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-deploy-own-code
Set up GitHub Actions CI/CD for hosted agents	https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/set-up-cicd-hosted-agent
Recover Foundry Agent Service from regional platform outages	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-platform-disaster-recovery
Deploy open-source models on Foundry managed compute	https://learn.microsoft.com/en-us/azure/foundry/how-to/deploy-models-managed
Run cloud-scale evaluations with Foundry SDK	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/cloud-evaluation
Run AI Red Teaming Agent scans in the cloud	https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/run-ai-red-teaming-cloud
Run Foundry agent evaluations in Azure DevOps	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-azure-devops
Run Foundry agent evaluations in GitHub Actions	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-github-action
Deploy fine-tuned Azure OpenAI models in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-deploy

← v1.0.3 All versions v1.0.5 →