Microsoft Foundry
The managed AI platform on Azure. Foundry handles the infrastructure you don't want to build: model deployment, agent hosting, knowledge indexing, safety filtering, and observability. You write the agent logic; Foundry runs, scales, and governs it.
Rebranded from Azure AI Studio in early 2026. One Foundry resource replaces the old Hub + Azure OpenAI + AI Services setup.
Resource Model
One Foundry resource governs everything. Projects isolate teams - separate deployments, separate agents, same billing and compliance boundary.
Foundry Models
1,900+ models behind one Azure endpoint. Prompts and completions are never used to train models. Data residency is configurable per deployment.
| Provider | Models (July 2026) | Notes |
|---|---|---|
| OpenAI | GPT-5.5, GPT-5.5 Pro, GPT-5, GPT-4o, o1, o3-mini | GPT-5.5 is the frontier model; GPT-5.5 Pro for most demanding enterprise workloads |
| Anthropic | Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4 | All GA on Azure. Claude Opus 5 is Anthropic's most advanced. No separate Anthropic account needed. |
| Meta | Llama 4, Llama 3.3 | Open-weight. Good for data-residency-sensitive deployments |
| Microsoft | MAI-Thinking-1, Phi-4, MAI-Voice-2, MAI-Transcribe-2, MAI-Image-2.5 | First-party, cost-efficient for specific tasks |
| Mistral | Mistral Large, Mistral Small | EU-preferred option for data residency |
| DeepSeek | DeepSeek-R1 | Strong reasoning at lower cost than o1 |
| Fireworks AI | Open-model inference (GA) | High throughput, custom weights, no separate contract |
| Embeddings | text-embedding-3-large, text-embedding-3-small | Use 3-small for RAG unless you need maximum recall |
| Deployment Type | How it bills | Latency | Use when |
|---|---|---|---|
| Pay-As-You-Go | Per 1K tokens | Variable | Dev, test, unpredictable load |
| Provisioned (PTU) | Fixed monthly per PTU | Consistent | Production with predictable P80 traffic |
| Global | PAYG, cheapest region auto-selected | Higher | Batch jobs, async processing |
| Managed Compute | Per GPU hour | Variable | Custom models, open-source hosting |
| EU/APAC Data Zone | PAYG + regional surcharge from Sept 2026 | Regional | Data residency requirements |
PTU sizing rule: size to P80 traffic, overflow to PAYG. PTU is cheaper per token at sustained load but you pay whether you use it or not.
# Production pattern - Managed Identity, no API keys
from azure.identity import DefaultAzureCredential
from openai import AzureOpenAI
credential = DefaultAzureCredential()
token = credential.get_token("https://cognitiveservices.azure.com/.default")
client = AzureOpenAI(
azure_endpoint="https://my-foundry.openai.azure.com/",
azure_ad_token=token.token,
api_version="2024-12-01-preview"
)
response = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Explain RAG in 3 sentences."}]
)
Foundry Agent Service
Managed runtime for agents. Three types:
| Type | How it works | Status | Use when |
|---|---|---|---|
| Prompt Agent | Declarative - you define instructions, tools, and knowledge; Foundry runs it | GA | Standard Q&A, RAG, tool use |
| Hosted Agent | Code-first - your code runs in Foundry's sandboxed environment with state and filesystem | GA July 2026 | Custom orchestration, complex logic |
| Connected Agent | One agent delegates to another by intent | GA | Triage + specialist routing |
Memory (preview) - three types that persist across runs:
- Procedural - agent learns how to do the work across runs. Early benchmarks show +7-14% absolute success rate gains
- User - retains user preferences and facts across sessions
- Session - maintains thread context within a conversation
Toolboxes (preview) - one managed MCP endpoint for all tools. Configure once, expose to any MCP client. Connects to Foundry IQ, Work IQ, Fabric IQ without custom plumbing.
Routines (preview) - schedule agents on a timer. Overnight triage, daily reporting, periodic compliance checks.
Voice Live (GA) - real-time voice for agents. STT, TTS, turn detection, interruption handling, avatars in one API.
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
client = AIProjectClient(
credential=DefaultAzureCredential(),
endpoint="https://my-foundry.services.ai.azure.com"
)
# Prompt agent - declarative
agent = client.agents.create(
model="gpt-5",
name="support-agent",
instructions="You are a tier-1 support agent. Use the knowledge base to answer questions. Escalate billing issues to the billing agent.",
tools=[
{"type": "file_search"},
{"type": "connected_agent", "connected_agent": {"id": billing_agent.id}}
]
)
# Publish to Teams
# Done via Foundry portal or Copilot Studio publish pipeline
Publish targets: Teams, Microsoft 365 Copilot, Copilot Studio, web apps - via a single governed publish pipeline.
Foundry IQ
The knowledge layer. Foundry IQ replaces custom RAG pipelines - ingest from multiple sources, retrieve with SLA-backed latency, ground agents without custom indexing glue.
| Component | Status | What it does |
|---|---|---|
| Knowledge Bases | GA | SLA-backed retrieval over connected sources |
| Serverless | Preview | No AI Search provisioning needed |
| Work IQ | Preview | Grounding in M365 data (email, docs, Teams, calendar) |
| Fabric IQ | Preview | Grounding in Fabric semantic models and OneLake |
| Web IQ | Limited access | Live web grounding, sub-200ms, zero data retention |
| Agentic Retrieval | GA | Multi-step reasoning over retrieved content |
Data pipeline features: layout-aware chunking (understands document structure, not just text splits), image extraction and serving, permission sync via Purview (ACLs from source propagate to retrieval), sensitivity label inheritance.
OneLake as knowledge source: Connect Foundry IQ directly to OneLake. Index files stored there, expose as knowledge inside agents.
Foundry Tools
Pre-built AI APIs that extend agents. All available as Toolbox tools.
| Tool | Key capabilities | Pricing |
|---|---|---|
| Document Intelligence | OCR, table extraction, key-value pairs, prebuilt models (invoice, receipt, ID, contract), custom models | $1.50/1K pages (prebuilt) |
| Speech | Real-time STT, neural TTS, MAI-Transcribe-2 (content biasing), MAI-Voice-2 (voice cloning) | $1.00/audio hour (STT) |
| Language | NER, PII detection/redaction, summarisation, sentiment, key phrase extraction, Text Analytics for Health | $1.00/1K text records |
| Vision | Image analysis, OCR, spatial analysis, face detection | $1.00/1K images |
| Content Understanding | Multimodal - video, audio, documents in one API | Usage-based |
| Translator | 100+ languages, real-time and document translation, custom terminology | $10/1M characters |
Gotcha: Foundry Tools bill separately from model inference. Budget for both when building document processing or voice agents.
Observability
Automatic when Application Insights is connected. Zero code changes for Foundry-hosted agents.
| Span type | What's captured |
|---|---|
agent_run | Total latency, status, cost |
model_call | Model name, input/output tokens, latency, cost per call |
tool_call | Tool name, input parameters, output, execution time |
retrieval | Query, result count, relevance scores |
content_filter | Category, severity, blocked/allowed |
Traces export to Application Insights (default), Datadog, or any OTLP backend.
Evaluation tools - all target different stages of the dev cycle:
| Tool | What it does | Status |
|---|---|---|
| Built-in evaluators | Groundedness, relevance, coherence, fluency, safety - run in CI | GA |
| ASSERT | Convert written policies into executable test scenarios (open source) | GA |
| Rubric | Auto-generate weighted quality criteria from your agent's definition | Preview |
| Agent Optimizer | Production traces - ranked improvement suggestions | Preview |
| Agent ROI | Task completion rate, time saved, cost efficiency | Private preview |
| AI Red Teaming Agent | Automated adversarial probing before production | Preview |
Security & Guardrails
| Control | What it does | When to enable |
|---|---|---|
| Content Safety | Input/output filtering, hate/violence/sexual/self-harm categories, configurable thresholds | Every production agent |
| Prompt Shield | Jailbreak detection on user input | Every public-facing agent |
| Custom blocklists | Block domain-specific terms or competitor names | Regulated industries |
| Agent Control Spec (ACS) | Deterministic controls at 5 checkpoints: input, LLM, state, tool, output. Portable YAML. | High-risk agents |
| Guided Guardrail Setup | Answer questionnaire, Foundry recommends controls, one-click apply | Fast path for new agents |
| Network isolation | Private endpoints, VNet injection, managed VNet | Enterprise deployments |
Important: Content Safety is not optional in production. Prompt Shield alone catches most jailbreak attempts. ACS adds deterministic rule enforcement for high-stakes scenarios.
Key Takeaways
- Use Managed Identity in production - API keys are a rotation and audit liability.
- PTU is cheaper per token at sustained load, but you pay whether you use it or not. Size to P80 and overflow to PAYG.
- Foundry IQ replaces custom RAG pipelines - permission sync via Purview and layout-aware chunking are the two things hardest to rebuild yourself.
- Content Safety and Prompt Shield are not optional in production. Enable both from day one.
- Hosted Agents (GA July 2026) are the production hosting target for MAF-built agents - sandboxed, stateful, framework-agnostic.
- Toolboxes (preview) consolidate all tool connectivity into one MCP endpoint - reduces integration surface significantly in multi-tool agents.