# Agent 8 — AI Agent Team Service (Full Reference)
> https://agent8.org
> This is the detailed version of llms.txt. For the summary, see llms.txt.

## Overview
Agent 8 is an AI agent service that provides a complete 8-member AI team for solopreneurs, freelancers, and small businesses. Unlike single chatbot solutions, Agent 8 deploys 8 specialized AI partners — covering strategy, design, development, marketing, sales, administration, and compliance — that collaborate as a real team through multi-agent orchestration.

The service is built on three proprietary engines: (1) Multi-Agent Orchestration for cross-functional team collaboration, (2) Knowledge Accumulation that makes the AI team smarter with every interaction, and (3) Autonomous Execution Loop for proactive operations without human prompts. Powered by Google Gemini (gemini-2.5-flash) with per-partner LoRA fine-tuning, deployed on Firebase Cloud Functions v2, fully TypeScript with 100% type-safe ESM codebase.

---

## Core Engines (3)

### 1. Multi-Agent Orchestration
8 partners independently analyze problems → autonomously discuss solutions → cross-verify results → reach consensus. Not a single chatbot — a team-level output.

### 2. Knowledge Accumulation System
Business patterns are auto-extracted → structured → permanently stored → applied to future tasks. Works independently of LLM context window. The more you use it, the smarter your team gets.

### 3. Autonomous Execution Loop
Observe → Analyze → Plan → Execute → Verify — repeats without human intervention. Includes Morning Briefing, Weekly Reports, OODA Event Loop.

---

## AI Partners (8)

| ID | Name | Role | Domain |
|:---|:-----|:-----|:-------|
| leader | Andrew | CEO/Leader | Strategic direction, team coordination |
| planning | Dani | Strategist | Roadmaps, planning, OKRs |
| dev | Kai | Developer | Full-stack development, code review, architecture |
| secretary | Hana | Secretary | Calendar, scheduling, meeting notes |
| marketing | Miso | Marketer | SEO, campaigns, content strategy, growth |
| design | Yuna | Designer | UI/UX, design systems, accessibility |
| audit | Rex | Auditor | Security, compliance, KISA Zero-Trust |
| sales | Juno | Sales | Lead generation, proposals, CRM |

Free tier includes all 8 partners with 20 messages/day.

---

## API Reference

Base URL: `/api/dt` via `dreamTeamApi` Cloud Function
Region: `asia-northeast3` (Seoul)
Auth: Firebase ID Token (`Bearer {token}`)

### Chat & Discussion
| Method | Path | Description |
|:-------|:-----|:-----------|
| POST | /chat | Gemini call (BYOK) |
| POST | /chat/stream | SSE streaming chat |
| POST | /chat/discuss | Inter-agent discussion (SSE) |
| GET | /chat/discussions | Discussion history |
| PUT | /chat/history | Save history + handover |
| GET | /chat/history | Load history |
| POST | /chat/summarize | Conversation summary |

### Suggestions & Autonomous
| Method | Path | Description |
|:-------|:-----|:-----------|
| GET | /suggest | Personalized suggestions |
| GET | /suggest/briefing | Morning briefing |
| POST | /suggest/briefing | Manual briefing generation |
| GET | /suggest/alerts | Partner health check alerts |
| GET | /suggest/weekly | Weekly report |
| GET | /suggest/state | Current handover state |

### MCP Server (Model Context Protocol)
| Method | Path | Description |
|:-------|:-----|:-----------|
| POST | /mcp | JSON-RPC single message (HTTP transport) |

Supported methods: `initialize`, `tools/list`, `tools/call`, `resources/list`, `resources/read`, `prompts/list`, `prompts/get`

**MCP Tools**: pola_chat, pola_discuss, pola_memory, pola_slash, pola_adapt
**MCP Resources**: pola://partners, pola://config

### Slash Commands
| Command | Korean | Description |
|:--------|:-------|:-----------|
| /research | /리서치 | URL crawl + AI analysis |
| /audit | /감사 | Security/code audit |
| /report | /보고서 | Business report |
| /competitor | /경쟁사 | Competitor analysis |
| /schedule | /일정 | Calendar management |
| /ppt | /피피티 | PPTX generation |
| /memory | /기억 | Agent memory recall |

### Other Endpoints
- /key — BYOK API key management (AES-256-GCM)
- /memory — Partner memory CRUD
- /user — Profile, OAuth, settings
- /billing — Stripe checkout, subscription
- /agents — Agent marketplace
- /ws — B2B workspace sharing
- /report — Report save/retrieve

### External Channels
- POST /slack/events — Slack Events API (HMAC-SHA256)
- POST /discord/interactions — Discord Interactions (Ed25519)

### Scheduled Functions
| Name | Schedule | Description |
|:-----|:---------|:-----------|
| partnerDailyCheck | 09:00 KST daily | Partner health checks |
| morningBriefing | 08:00 KST daily | Morning briefing |
| weeklyReport | 10:00 KST Monday | Weekly activity report |
| agentEventLoop | 06:00 KST daily | OODA autonomous event loop |

---

## Technology Stack

- **Frontend**: Next.js 15 (App Router), TypeScript, React 19
- **Backend**: Firebase Cloud Functions v2, Node.js 22, 100% TypeScript ESM
- **AI**: Google Gemini (gemini-2.5-flash), Firebase AI Logic SDK + Google AI Developer SDK
- **Fine-tuning**: LoRA via Google Colab (per-partner domain models)
- **Auth**: Firebase Authentication (Google OAuth 2.0)
- **Database**: Cloud Firestore
- **Storage**: Firebase Storage (PPT, documents)
- **Hosting**: Firebase Hosting (greatpola.com)
- **Payments**: Stripe Checkout + Webhooks
- **Crawling**: Crawl4AI Docker + fallback fetch
- **Caching**: Gemini Context Cache (75% cost reduction)
- **Search**: TF-IDF vector search (in-memory, no external DB)
- **Security**: KISA Zero-Trust, PII auto-masking, role-based access control

---

## SEO & GEO

- robots.txt: AI crawlers explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Applebot, GoogleOther, Google-Extended, Bytespider, CCBot)
- sitemap.xml: auto-generated with all public pages
- JSON-LD: Organization, WebSite, Service, SoftwareApplication, FAQPage (EN/KO), WebPage (speakable), BreadcrumbList
- llms.txt: This file (LLMs.txt specification compliant)