byok_401_debug_expert
OfficialFix silent BYOK 401 in Foundry agents
System Documentation
What problem does it solve?
This Skill helps you diagnose why a Foundry hosted agent using BYOK appears to start normally but returns a silent 401 error on the first streamed event.
Core Features & Use Cases
- Identifies the root RBAC gap between Project-scope “Foundry User” assignment and missing CognitiveServices account-scope “Foundry User”.
- Guides targeted verification using Azure role assignments and App Insights traces to confirm the silent BYOK 401 pattern.
- Provides the exact remediation command to grant the correct identity at the CognitiveServices account scope (including blueprint identity when applicable).
Use case: You deploy a BYOK-enabled Foundry hosted agent with project-scope RBAC, but the invoke stream fails with an authentication error after the connection succeeds.
Quick Start
Ask the skill to diagnose a silent BYOK 401 for your Foundry-hosted agent and output the exact az role assignment create command to grant “Foundry User” at the BYOK CognitiveServices account scope.
Dependency Matrix
Required Modules
None requiredComponents
💻 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: byok_401_debug_expert Download link: https://github.com/aiappsgbb/awesome-gbb/archive/main.zip#byok-401-debug-expert Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.