Skip to main content

Setup Guide

Quick Start (CLI Surface)​

1. Clone and install​

Option A: uv (recommended)

uv manages Python versions and virtual environments automatically -- no global installs, no manual venv activation.

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux
# or: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows

# Clone and install
git clone https://github.com/ericchansen/agent-demo.git
cd agent-demo
uv sync --extra dev        # creates .venv, installs all deps + dev tools

Run commands with uv run:

uv run pytest tests/unit/
uv run python -m src.orchestrator
Option B: pip + venv
git clone https://github.com/ericchansen/agent-demo.git
cd agent-demo
python -m venv .venv

# Activate the virtual environment
# macOS/Linux:
source .venv/bin/activate
# Windows (PowerShell):
.venv\Scripts\Activate.ps1

# Install
pip install -e ".[dev]"

2. Connect the Fabric Data Agent​

The repo includes a workspace .github/mcp.json that Copilot CLI auto-discovers. You just need to set your Fabric workspace ID.

Option A: Edit .github/mcp.json (zero-config)

Open .github/mcp.json in the repo and replace <your-workspace-id> with your Fabric workspace GUID:

{
  "mcpServers": {
    "wwi-sales-data": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/YOUR-WORKSPACE-ID/dataagent"
    }
  }
}

Copilot CLI loads this automatically when you run from the project directory.

Option B: copilot mcp add (one-liner, saved to your user config)

copilot mcp add --transport http wwi-sales-data \
  "https://api.fabric.microsoft.com/v1/mcp/workspaces/YOUR-WORKSPACE-ID/dataagent"

Option C: Inline for a single session

copilot --additional-mcp-config '{"wwi-sales-data":{"type":"http","url":"https://api.fabric.microsoft.com/v1/mcp/workspaces/YOUR-WORKSPACE-ID/dataagent"}}'

3. Start asking questions​

copilot
# > What were Tailspin Toys' total sales last quarter?

Copilot CLI authenticates to Fabric via OAuth -- you'll get a browser prompt on first use.

Foundry Surface Setup​

See the full setup guide for Azure AI Foundry configuration, Fabric IQ connections, and M365 publishing.