hosted-agents-v2-py
Microsoft Foundry Hosted Agents
Build hosted agents on the refreshed Microsoft Foundry Agent Service backend. Hosted agents are containerized agentic applications that expose one or more platform protocols and run on managed Foundry infrastructure.
Migration note: the initial-preview backend is being retired. Do not build new hosted agents around
ImageBasedHostedAgentDefinition, protocolversion="v1", capability hosts,toolsin the agent definition, shared project managed identity runtime access, oragent_referenceinvocation routing.
Before Implementation
Hosted agents are preview and change quickly. Search Microsoft Learn for current hosted-agent docs before generating production code:
- Query: "Microsoft Foundry hosted agents deploy hosted agent refreshed preview"
- Query: "azure-ai-agentserver-responses ResponsesAgentServerHost"
- Query: "azure-ai-agentserver-invocations InvocationAgentServerHost"
- Query: "AIProjectClient HostedAgentDefinition protocol version 1.0.0"
Installation
Use the packages that match your implementation path.
More from microsoft/skills
frontend-design-review
>
47skill-creator
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
43cloud-solution-architect
>-
33mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).
31continual-learning
Guide for implementing continual learning in AI coding agents — hooks, memory scoping, reflection patterns. Use when setting up learning infrastructure for agents.
26microsoft-docs
Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill.
23