# Agent Developer

> Microsoft Agent Framework + Foundry Toolbox MCP integration specialist

- Skill: `microsoft-foundry/agent-developer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add microsoft-foundry/agent-developer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microsoft-foundry/agent-developer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: microsoft-foundry (https://skillmd.com/u/microsoft-foundry)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microsoft-foundry/agent-developer

---


# Agent Developer Skill

You are a specialist in building and configuring the AI agent backend for this project.

## Tech Stack
- Python 3.11+
- Microsoft Agent Framework 1.0
- FastAPI + Uvicorn for the API gateway
- Azure AI Foundry SDK (`azure-ai-projects`)
- Azure Identity (`DefaultAzureCredential`)

## Architecture

This project uses a **single agent** that connects to the **Foundry Toolbox** via one MCP endpoint. The Toolbox dispatches to individual tools (FoundryIQ, WorkIQ, custom MCP, FabricIQ) behind the scenes.

```
API Gateway → Single Agent → Toolbox (MCP endpoint) → Multiple Tools
```

### Agent Modes
- **Local** (`AGENT_MODE=local`): Agent runs in-process, connects to Toolbox MCP directly via `MCPStdioTool` or `MCPStreamableHTTPTool`
- **Hosted** (`AGENT_MODE=hosted`): Agent deployed as container in Foundry Agent Service, Toolbox configured via Foundry project

## Streaming Protocol
The gateway streams newline-delimited JSON events:
```json
{"type": "message", "content": "chunk of text"}
{"type": "activity", "tool": "FoundryIQ", "status": "running", "detail": "Searching knowledge base..."}
{"type": "activity", "tool": "FoundryIQ", "status": "complete", "detail": "Found 3 results"}
{"type": "citation", "source": "doc-name", "url": "..."}
```

Activity events must surface **individual tool names** within the Toolbox, not just "Toolbox called".

## File Organization
```
src/fibey/agent/
├── api_server.py     # FastAPI gateway
├── main.py           # Local-mode entrypoint
├── hosted.py         # Hosted-mode entrypoint
├── agent.py          # Agent definition + Toolbox MCP connection
└── prompts/
    └── system_prompt.md
```

## Conventions
- System prompts are stored as markdown in `prompts/` and loaded at runtime
- Use `python-dotenv` for environment configuration
- All Azure auth via `DefaultAzureCredential`
- Type hints on all function signatures
- Use `asyncio` and `async/await` throughout — the agent framework is async-first