Skills
.Work. You
Rest

foundry-hosted-agents

Official

Deploy and evaluate Microsoft Foundry hosted agents

Software Engineering#deployment#RBAC#evaluation#telemetry#identity#foundry#hosted agents
Authoraiappsgbb
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Deploying Microsoft Foundry hosted agents reliably—while navigating identity wiring, SDK version changes, ACR image/version pitfalls, and production evaluation failures—can be slow and error-prone.

Core Features & Use Cases

  • Hosted-agent deployment lifecycle: Deploy, evaluate, and manage Foundry hosted agents on the refreshed May 2026 preview with the specific MAF Agent framework variant.
  • Identity and RBAC guidance: Configure agent.yaml/azure.yaml, set the correct Foundry user role, and handle token audience changes that otherwise cause 401/unauthorized failures.
  • Production-ready troubleshooting and migration notes: Cover breaking changes (e.g., MAF 1.4.0→1.6.0), telemetry behavior, MCP tool patterns, and gotchas like Foundry create_version deduplication and ACR caching traps.

Quick Start

Use the foundry-hosted-agents skill to deploy a container-based hosted agent on Foundry that uses FoundryChatClient with ResponsesHostServer and follows the MAF 1.6.0 upgrade and identity rules.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: foundry-hosted-agents
Download link: https://github.com/aiappsgbb/awesome-gbb/archive/main.zip#foundry-hosted-agents

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.