{
  "markdown": "# Agent Mike\n\nAgent Mike is a deployable Level 1 support agent with a first-class identity, an AgentMail inbox, a web chat widget, manager oversight, and an OKF-compatible knowledge base. Claude Agent SDK is the agent harness; FastAPI runs the agent and channel workflows; PostgreSQL stores conversations and ranks knowledge; Next.js provides the manager console and widget.\n\nThe manager console is adapted from the MIT-licensed [Ai-Xccelerate/aix-ui-template](https://github.com/Ai-Xccelerate/aix-ui-template). See the [template usage map](docs/TEMPLATE_USAGE.md) for the exact components, conventions, and update boundary.\n\n## What is included\n\n- A polished support operations console: overview, inbox, live chat, knowledge, and settings.\n- An embeddable customer chat widget at `/widget`.\n- A safe Claude Agent SDK runtime with no filesystem or shell tools exposed.\n- AgentMail inbound webhook and outbound reply adapter.\n- OKF v0.1 markdown ingestion with YAML frontmatter and PostgreSQL full-text retrieval.\n- Manager escalation, confidence thresholds, citations, audit metadata, and configurable guardrails.\n- Demo mode so the whole product can be explored without paid API keys.\n- Docker and Railway-ready service configuration.\n\n## Architecture\n\n```text\nCustomer email ── AgentMail webhook ─┐\n                                    ├── FastAPI ── Claude Agent SDK\nWebsite widget ── chat REST API ─────┘      │          │\n                                            │          └── Anthropic API\nManager console ────────────────────────────┤\n                                            └── PostgreSQL\n                                                conversations, messages,\nOKF markdown bundle ── ingestion API ────────── knowledge + search index\n```\n\n## Quick start\n\nThe easiest full-stack start is Docker:\n\n```bash\ncp .env.example .env\ndocker compose up --build\n```\n\nOpen `http://localhost:3000`. Demo mode is enabled by default. To run with Claude, set `ANTHROPIC_API_KEY` and `DEMO_MODE=false` on the API service.\n\nFor a local developer loop without Docker:\n\n```bash\ndocker compose up -d postgres\ncd apps/api && python -m venv .venv && source .venv/bin/activate\npip install -e '.[dev]'\nuvicorn app.main:app --reload\n```\n\nIn another terminal:\n\n```bash\ncd apps/web\nnpm install\nnpm run dev\n```\n\nThe API is at `http://localhost:8000`; interactive API docs are at `/docs`.\n\n## Configure Mike\n\n1. Open **Settings → Identity** and set Mike's public name, email, tone, and avatar initials.\n2. Under **Role**, define the supported products and what Level 1 means for your team.\n3. Under **Guardrails**, set the confidence threshold and escalation triggers.\n4. Add OKF documents under `knowledge/` (they are ingested on API startup) or upload a `.md` file from **Knowledge**.\n5. Add AgentMail and Anthropic credentials to the API environment.\n\nSee [Product and template guide](docs/PRODUCT_GUIDE.md), [architecture](docs/ARCHITECTURE.md), and [Railway deployment](docs/DEPLOY_RAILWAY.md) for the operating model and production setup.\n",
  "bytes": 3031,
  "sha": "dbb9b75e618cab9a90262d36910596873f80296f058cf04156c5648438bb8b4a",
  "repo_slug": "ai-xccelerate/agent-mike",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_ai_xccelerate_agent_mike_knowledge_index_741b1685/readme"
}