Skip to content

Commit bdaeff2

Browse files
committed
refactor: Replace DevUI tutorial content with research guidance
The skill is about how to research docs, not a DevUI tutorial. Replace the 10-step DevUI workflow checklist with a research strategy table showing which tool to use for each type of DevUI information.
1 parent ab8787b commit bdaeff2

1 file changed

Lines changed: 13 additions & 19 deletions

File tree

skills/microsoft-docs/SKILL.md

Lines changed: 13 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -72,25 +72,19 @@ The **Learn website** source has polished tutorials and conceptual docs. The **G
7272

7373
**Use both** for comprehensive Agent Framework coverage: query the website source for "how to" guides, then the repo source for API-level specifics.
7474

75-
##### DevUI Workflow
76-
77-
DevUI is a sample app for running and debugging agents/workflows interactively. Key topics:
78-
79-
1. **Installation**: `pip install agent-framework-devui --pre`
80-
2. **Programmatic launch**: `serve(entities=[agent], auto_open=True)` — registers agents in-memory
81-
3. **Directory discovery**: `devui ./agents --port 8080` — auto-discovers agents/workflows from `__init__.py` files
82-
4. **Tracing**: `devui ./agents --tracing` or `serve(entities=[agent], tracing_enabled=True)` — enables OpenTelemetry traces visible in the debug panel
83-
5. **OpenAI-compatible API**: `POST /v1/responses` with `metadata.entity_id` — use with OpenAI Python SDK
84-
6. **OpenAI proxy**: Set `X-Proxy-Backend: openai` header to proxy requests through DevUI (keeps API key server-side)
85-
7. **Authentication**: `devui ./agents --auth --auth-token "token"` — Bearer token auth
86-
8. **UI modes**: `--mode developer` (default, full debug) vs `--mode user` (simplified, restricted)
87-
9. **.NET integration**: `builder.AddDevUI()` + `app.MapDevUI()` in ASP.NET Core (development only)
88-
10. **Export to external observability**: Set `OTLP_ENDPOINT` to send traces to Jaeger, Zipkin, Azure Monitor, Datadog
89-
90-
**Best query strategy for DevUI:**
91-
- Use `microsoft_code_sample_search` with `language: "python"` for working DevUI code
92-
- Use Context7 `/microsoft/agent-framework` for the DevUI REST API reference
93-
- Use Context7 `/websites/learn_microsoft_en-us_agent-framework` for directory structure and tracing guides
75+
##### Researching DevUI
76+
77+
DevUI docs are split across Learn and the GitHub repo. The best research strategy:
78+
79+
| What You Need | Where to Search |
80+
|---------------|----------------|
81+
| Setup tutorial, directory structure | Context7 `/websites/learn_microsoft_en-us_agent-framework` — query "DevUI directory discovery" or "DevUI tracing" |
82+
| CLI flags, REST API endpoints, auth config | Context7 `/microsoft/agent-framework` — query "DevUI CLI options" or "DevUI POST /v1/responses" |
83+
| Working Python code snippets | `microsoft_code_sample_search` with `language: "python"` — query "DevUI agent framework serve" |
84+
| Working C# integration code | `microsoft_code_sample_search` with `language: "csharp"` — query "DevUI AddDevUI MapDevUI" |
85+
| Full setup guide in one page | `microsoft_docs_fetch` with URL `https://learn.microsoft.com/en-us/agent-framework/user-guide/devui/` |
86+
87+
The GitHub repo source is particularly valuable for DevUI because it contains API-level detail (endpoint schemas, proxy config, auth tokens) that the Learn page summarizes.
9488

9589
#### Semantic Kernel
9690

0 commit comments

Comments
 (0)