Fibey is a runnable demo of an agent that connects to four different backend systems — inventory, work orders, a knowledge base, and a status dashboard — through one endpoint: the Azure AI Foundry Toolbox.
- Look up fiber parts, SKUs, stock levels, and inventory locations
- View, create, and update work orders
- Retrieve splicing procedures, safety protocols, and troubleshooting guidance
- Check current network or service status
┌──────────────┐ /api/chat ┌──────────────────┐ in-proc ┌──────────────────┐
│ React UI │ ──────────► │ FastAPI Gateway │ ────────► │ Fibey Agent │
│ + Activity │ ◄── SSE ─── │ (:8080) │ │ (agent-fw) │
└──────────────┘ └──────────────────┘ └────────┬─────────┘
│
Foundry Toolbox MCP
│
┌────────────────┬───────────────────┬─────────────────┐
│ inventory-mcp │ work-orders-api │ FoundryIQ KB │
│ (:8001) │ (:8002) │ (AI Search) │
└────────────────┴───────────────────┴─────────────────┘
The sample also ships containerapp and hosted modes — see docs/architecture.md.
- Python 3.12+
- Node.js 20+
- uv (Python package manager)
- Azure CLI (
az) + Azure Developer CLI (azd) — only needed for cloud deploy - An Azure AI Foundry project with a deployed model and a configured Toolbox
# 1) Install Python and UI dependencies
./scripts/setup.sh
# 2) Copy and edit environment variables
cp .env.example .env
# At minimum set FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL, TOOLBOX_MCP_URL
# 3) Start the gateway + UI
./scripts/start-dev.sh
# 4) (optional) In separate terminals, start the local toolbox backends
cd services/inventory-mcp && uv sync && uv run python server.py
cd services/work-orders-api && uv sync && uv run python server.py
cd services/status-dashboard/public && python -m http.server 8003Open the UI at http://localhost:5173.
| Service | Local URL |
|---|---|
| UI | http://localhost:5173 |
| Gateway | http://localhost:8080 |
| Inventory MCP | http://localhost:8001 |
| Work Orders API | http://localhost:8002 |
| Status Dashboard | http://localhost:8003 |
Toolbox URL gotcha:
TOOLBOX_MCP_URLshould not include?api-version=v1. The agent code auto-appends it. The Toolbox MCP endpoint requiresapi-version=v1(not a date-based version).
The full stack (UI, gateway, agent service, work-orders API, inventory MCP,
AI Search, blob storage) deploys to Azure Container Apps via azd:
az login
azd auth login
azd upSee docs/deployment.md for the full deployment guide, including FoundryIQ knowledge base setup and post-deploy RBAC.
| Doc | When to read it |
|---|---|
docs/toolbox-integration.md |
The integration recipe (custom httpx.Auth, headers, MCP gotchas) |
docs/architecture.md |
Full system diagram, components, streaming protocol, agent modes |
docs/local-development.md |
All env vars, running individual services, testing the gateway API |
docs/deployment.md |
Azure deployment via azd, hosted-agent deployment, knowledge base setup, RBAC |
src/fibey/ # Python package: agent + gateway
services/
inventory-mcp/ # MCP inventory server (port 8001)
work-orders-api/ # FastAPI work-orders service (port 8002)
status-dashboard/ # Static service-status dashboard (port 8003)
foundry-iq-docs/ # Markdown source for the FoundryIQ knowledge base
ui/ # React + TypeScript + Tailwind frontend
infra/ # Bicep modules for Container Apps + AI Search + blob
scripts/ # setup.sh, start-dev.sh, setup-knowledge-base.sh
docs/ # Architecture, deployment, local-dev, integration docs
This project welcomes contributions and suggestions. See CONTRIBUTING.md for details.
Licensed under the MIT License — see LICENSE.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-party's policies.