skills.rest
aiappsgbb
aiappsgbbOFFICIAL
Explore all skills by this author →
GitHub

foundry-hosted-agents

Deploys Microsoft Foundry hosted agents using MAF Agent framework variants.

5|2|Updated Apr 28, 2026
Search Tags:#deployment#RBAC#evaluation#telemetry#identity#foundry#hosted agents
One-click install
npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-hosted-agents
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: foundry-hosted-agents
Source: https://github.com/aiappsgbb/awesome-gbb/tree/main/skills/foundry-hosted-agents
Command: npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-hosted-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about foundry-hosted-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Microsoft Foundry hosted agents using the MAF framework?▼

To deploy Foundry hosted agents, use the MAF `Agent` + `FoundryChatClient` + `ResponsesHostServer` variant to build container agents, configure `agent.yaml` and Azure resources, and import hosted agent versions under the refreshed May 2026 preview.

Why am I getting 401 unauthorized errors when configuring Foundry hosted agent identity?▼

Foundry 401 unauthorized errors typically occur when the token audience or Foundry user RBAC role scope is incorrect. You must set the proper Foundry user role in `agent.yaml` or `azure.yaml` to resolve identity wiring failures.

What causes Foundry create_version deduplication issues during hosted agent deployment?▼

Foundry `create_version` deduplication issues arise from ACR image and version caching traps. Applying the included guardrails prevents these versioning pitfalls and ensures correct hosted agent version imports.

How do I run production evaluation workflows for Foundry hosted agents?▼

Run production evaluation workflows for Foundry hosted agents by deploying the container agent with `FoundryChatClient` and `ResponsesHostServer`, then validating telemetry and KQL expectations against the configured Azure resources.

Does the foundry-hosted-agents skill support MCP tool patterns and telemetry troubleshooting?▼

Yes, the skill covers MCP tool patterns, telemetry behavior, and KQL expectations. It provides production-ready troubleshooting and migration notes for Foundry hosted agents, including ACR and Foundry deduplication guardrails.

Related Skills

Explore More Software Engineering Skills→
spboyerspboyer

azd-ai-init

Scaffold Azure AI Foundry agent projects with Bicep templates and azure.yaml.

Community
Advanced
davidrrowleydavidrrowley

microsoft-foundry

Manage Azure AI Foundry agent lifecycles from deployment to evaluation.

Community
Advanced
bugrabilgebugrabilge
10

agents-v2-py

Define and deploy container-based hosted agents for Azure AI Projects using the Azure AI Projects SDK.

Community
Advanced
p-potvinp-potvin
1

microsoft-foundry

Deploy and manage Azure AI Foundry agents across container build, ACR push, hosting, and monitoring.

Community
Advanced