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.
This commit is contained in:
Chris McKee
2026-02-06 10:09:19 -06:00
parent ab8787b505
commit bdaeff279f

View File

@@ -72,25 +72,19 @@ The **Learn website** source has polished tutorials and conceptual docs. The **G
**Use both** for comprehensive Agent Framework coverage: query the website source for "how to" guides, then the repo source for API-level specifics.
##### DevUI Workflow
##### Researching DevUI
DevUI is a sample app for running and debugging agents/workflows interactively. Key topics:
DevUI docs are split across Learn and the GitHub repo. The best research strategy:
1. **Installation**: `pip install agent-framework-devui --pre`
2. **Programmatic launch**: `serve(entities=[agent], auto_open=True)` — registers agents in-memory
3. **Directory discovery**: `devui ./agents --port 8080` — auto-discovers agents/workflows from `__init__.py` files
4. **Tracing**: `devui ./agents --tracing` or `serve(entities=[agent], tracing_enabled=True)` — enables OpenTelemetry traces visible in the debug panel
5. **OpenAI-compatible API**: `POST /v1/responses` with `metadata.entity_id` — use with OpenAI Python SDK
6. **OpenAI proxy**: Set `X-Proxy-Backend: openai` header to proxy requests through DevUI (keeps API key server-side)
7. **Authentication**: `devui ./agents --auth --auth-token "token"` — Bearer token auth
8. **UI modes**: `--mode developer` (default, full debug) vs `--mode user` (simplified, restricted)
9. **.NET integration**: `builder.AddDevUI()` + `app.MapDevUI()` in ASP.NET Core (development only)
10. **Export to external observability**: Set `OTLP_ENDPOINT` to send traces to Jaeger, Zipkin, Azure Monitor, Datadog
| What You Need | Where to Search |
|---------------|----------------|
| Setup tutorial, directory structure | Context7 `/websites/learn_microsoft_en-us_agent-framework` — query "DevUI directory discovery" or "DevUI tracing" |
| CLI flags, REST API endpoints, auth config | Context7 `/microsoft/agent-framework` — query "DevUI CLI options" or "DevUI POST /v1/responses" |
| Working Python code snippets | `microsoft_code_sample_search` with `language: "python"` — query "DevUI agent framework serve" |
| Working C# integration code | `microsoft_code_sample_search` with `language: "csharp"` — query "DevUI AddDevUI MapDevUI" |
| Full setup guide in one page | `microsoft_docs_fetch` with URL `https://learn.microsoft.com/en-us/agent-framework/user-guide/devui/` |
**Best query strategy for DevUI:**
- Use `microsoft_code_sample_search` with `language: "python"` for working DevUI code
- Use Context7 `/microsoft/agent-framework` for the DevUI REST API reference
- Use Context7 `/websites/learn_microsoft_en-us_agent-framework` for directory structure and tracing guides
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.
#### Semantic Kernel