This section covers real problems makers have hit while building AI agents — each write-up walks the exact symptom, the root cause, and the fix.
Overview
Unlike the rest of this documentation, these aren't feature references — they're diagnostic write-ups, each structured the same way: Symptom (what you're seeing), Cause (why it's happening), Fix (the exact steps), and Prevention (how to avoid it next time). Reach for one when something isn't behaving the way the reference docs say it should.
What's in This Section
Scenario | Symptom |
|---|---|
A generic blocked response despite tools succeeding and a real answer being produced. | |
An embedded Copilot hangs in a live surface after working fine in Preview. | |
A tool referenced in task instructions never gets invoked. | |
Documents stuck Syncing or Failed after a connection change. | |
Connecting an Agent to a Privately Hosted Azure OpenAI Deployment | Connecting an agent to a private, non-standard Azure OpenAI endpoint. |
Getting app-uploaded PDFs automatically into an agent's knowledge. |