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.

ProviderModels (July 2026)Notes
OpenAIGPT-5.5, GPT-5.5 Pro, GPT-5, GPT-4o, o1, o3-miniGPT-5.5 is the frontier model; GPT-5.5 Pro for most demanding enterprise workloads
AnthropicClaude Opus 5, Claude Sonnet 5, Claude Sonnet 4All GA on Azure. Claude Opus 5 is Anthropic's most advanced. No separate Anthropic account needed.
MetaLlama 4, Llama 3.3Open-weight. Good for data-residency-sensitive deployments
MicrosoftMAI-Thinking-1, Phi-4, MAI-Voice-2, MAI-Transcribe-2, MAI-Image-2.5First-party, cost-efficient for specific tasks
MistralMistral Large, Mistral SmallEU-preferred option for data residency
DeepSeekDeepSeek-R1Strong reasoning at lower cost than o1
Fireworks AIOpen-model inference (GA)High throughput, custom weights, no separate contract
Embeddingstext-embedding-3-large, text-embedding-3-smallUse 3-small for RAG unless you need maximum recall
Deployment TypeHow it billsLatencyUse when
Pay-As-You-GoPer 1K tokensVariableDev, test, unpredictable load
Provisioned (PTU)Fixed monthly per PTUConsistentProduction with predictable P80 traffic
GlobalPAYG, cheapest region auto-selectedHigherBatch jobs, async processing
Managed ComputePer GPU hourVariableCustom models, open-source hosting
EU/APAC Data ZonePAYG + regional surcharge from Sept 2026RegionalData 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:

TypeHow it worksStatusUse when
Prompt AgentDeclarative - you define instructions, tools, and knowledge; Foundry runs itGAStandard Q&A, RAG, tool use
Hosted AgentCode-first - your code runs in Foundry's sandboxed environment with state and filesystemGA July 2026Custom orchestration, complex logic
Connected AgentOne agent delegates to another by intentGATriage + 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.

ComponentStatusWhat it does
Knowledge BasesGASLA-backed retrieval over connected sources
ServerlessPreviewNo AI Search provisioning needed
Work IQPreviewGrounding in M365 data (email, docs, Teams, calendar)
Fabric IQPreviewGrounding in Fabric semantic models and OneLake
Web IQLimited accessLive web grounding, sub-200ms, zero data retention
Agentic RetrievalGAMulti-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.

ToolKey capabilitiesPricing
Document IntelligenceOCR, table extraction, key-value pairs, prebuilt models (invoice, receipt, ID, contract), custom models$1.50/1K pages (prebuilt)
SpeechReal-time STT, neural TTS, MAI-Transcribe-2 (content biasing), MAI-Voice-2 (voice cloning)$1.00/audio hour (STT)
LanguageNER, PII detection/redaction, summarisation, sentiment, key phrase extraction, Text Analytics for Health$1.00/1K text records
VisionImage analysis, OCR, spatial analysis, face detection$1.00/1K images
Content UnderstandingMultimodal - video, audio, documents in one APIUsage-based
Translator100+ 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 typeWhat's captured
agent_runTotal latency, status, cost
model_callModel name, input/output tokens, latency, cost per call
tool_callTool name, input parameters, output, execution time
retrievalQuery, result count, relevance scores
content_filterCategory, severity, blocked/allowed

Traces export to Application Insights (default), Datadog, or any OTLP backend.

Evaluation tools - all target different stages of the dev cycle:

ToolWhat it doesStatus
Built-in evaluatorsGroundedness, relevance, coherence, fluency, safety - run in CIGA
ASSERTConvert written policies into executable test scenarios (open source)GA
RubricAuto-generate weighted quality criteria from your agent's definitionPreview
Agent OptimizerProduction traces - ranked improvement suggestionsPreview
Agent ROITask completion rate, time saved, cost efficiencyPrivate preview
AI Red Teaming AgentAutomated adversarial probing before productionPreview

Security & Guardrails

ControlWhat it doesWhen to enable
Content SafetyInput/output filtering, hate/violence/sexual/self-harm categories, configurable thresholdsEvery production agent
Prompt ShieldJailbreak detection on user inputEvery public-facing agent
Custom blocklistsBlock domain-specific terms or competitor namesRegulated industries
Agent Control Spec (ACS)Deterministic controls at 5 checkpoints: input, LLM, state, tool, output. Portable YAML.High-risk agents
Guided Guardrail SetupAnswer questionnaire, Foundry recommends controls, one-click applyFast path for new agents
Network isolationPrivate endpoints, VNet injection, managed VNetEnterprise 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.