agents-sdk-dotnet-debugging Skill

Source

• Creator: microsoft
• Repository: microsoft/Agents
• Skill file: agent-plugins/agents-for-net/skills/agents-sdk-dotnet-debugging/SKILL.md

What it does

Use when troubleshooting an agent built with the Microsoft Agents SDK (Microsoft.Agents.Hosting.AspNetCore and related packages) in C / .NET. Trigger on any of these symptoms: build or C compile errors, crashes on startup, 401 or auth errors on incoming requests, the bot not responding to messages, appsettings.json con

Skill instructions

Debugging Agents Built with Microsoft Agents SDK (.NET) Overview Most agent failures fall into one of three categories: the code doesn't build or start, the configuration is wrong, or the agent isn't reachable. Work through this checklist in order — each step confirms a prerequisite for the next. Checklist You MUST create a task for each of these items and complete them in order: 1. Make sure the code builds successfully. 2. Make sure the application starts and runs without crashing. 3. Make sure the application opens a port and listens for incoming requests. 4. Validate the appsettings.json configuration. 5. Validate the bot's credentials against Azure AD. 6. Use the Agents Playground to test the agent end-to-end locally. --- 1. Build the code bash dotnet build Expected: exits with code 0, no errors. Fix any C compile errors before continuing. Common build errors: - Missing package — dotnet add package Microsoft.Agents.Hosting.AspNetCore - Namespace not found — wrong using statement;