MATE 智能体指挥中心

这个 Agent 能做什么，适合哪些场景？

MATE 是建立在 Google ADK 之上的生产级多智能体编排引擎（同时支持 LangGraph），通过 FastAPI 提供 Web 仪表盘与后端。智能体配置存放在数据库中，可在可视化画布上创建层级、绘制父子关系、挂载工具与 MCP 节点，并支持版本历史与一键回滚。它通过 LiteLLM 接入 50+ 厂商模型，记录每次调用的美元成本与四类 token 用量，并提供按用户、智能体、项目的 RBAC、预算、告警与审计日志。内置 Eval 框架与 Playground，可对智能体跑测试集并按版本追踪分数与回归。部署方式为 Docker 镜像或源码自托管，数据库默认 SQLite，也可用 PostgreSQL、MySQL 8。

MATE 以 auth_server.py 启动 FastAPI 服务，默认在 8000 端口暴露仪表盘。它从数据库读取智能体定义（模型、指令、父子层级、工具、MCP 服务器、记忆块、RBAC 角色），在对话时通过 LiteLLM 调用所选模型，并将每次模型调用的美元成本与 prompt/response/thoughts/tool-use 四类 token 用量写入日志，供 /dashboard/usage 分析。它把每个根智能体暴露为 MCP 服务器（/agents/{name}/mcp/*）和 A2A 端点（/a2a/{agent}），并提供 OpenAI 兼容的 /v1 桥接与可嵌入的 <script> 聊天组件。Eval 框架自动调用在线智能体，用精确匹配、语义相似度或 LLM 裁判打分，并在版本回退超过 5 分时触发回归 webhook。启动时自动执行数据库迁移。

1. 运维或平台团队需要一个统一的智能体控制面，集中管理多团队、多项目的智能体层级与权限。
2. 产品团队想在不重新部署的情况下迭代提示词与模型，并用版本回滚兜底。
3. 需要在对外网站（客服、销售、文档站）部署聊天机器人，且每个站点有独立外观与访问规则。
4. 合规或财务团队要按智能体、项目、用户追踪 LLM 成本并设置预算告警。
5. 想把智能体接入 Claude Desktop、Cursor 或兼容 OpenAI 的 IDE 客户端。
6. 需要在发布前用自动化测试集对提示词改动做回归验证的团队。

如何安装或部署这个 Agent？

最快方式：从已发布的镜像运行 Docker 容器。

docker run -d --name mate -p 8000:8000 \
  -e AUTH_PASSWORD=change-me -e GOOGLE_API_KEY=your-key \
  -e DB_PATH=data/my_agent_data.db -v mate-data:/app/data \
  ghcr.io/antiv/mate:latest

或从源码安装：

git clone https://github.com/antiv/mate.git && cd mate
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.lock

cp .env.example .env
# 设置 GOOGLE_API_KEY（或其他受支持提供方的密钥）、AUTH_USERNAME 和 AUTH_PASSWORD

也可以使用 docker-compose up --build 构建完整栈（需在 .env 中设置 AUTH_PASSWORD）。

运行时需要 Python 3.10+（源码方式）、一个 LLM 提供方 API 密钥，默认数据库为 SQLite，迁移在启动时自动执行。

如何使用这个 Agent？

启动服务后打开 http://localhost:8000，使用 AUTH_USERNAME / AUTH_PASSWORD 登录（留空时为 admin / mate；MATE_ENV=production 会拒绝该默认值）。

源码方式启动：

python auth_server.py
# Dashboard: http://localhost:8000

登录后默认进入 /dashboard/workroom，从卡片中选择一个根智能体开始对话。在 /dashboard/agents 用可视化画布创建智能体、绘制父子连线、配置工具和 MCP 服务器。

把智能体作为 MCP 服务器暴露：

export MCP_EXPOSED_AGENTS=creative_agent,support_agent

客户端使用仪表盘账户菜单生成的 Personal Access Token 认证：

curl -H "Authorization: Bearer mate_pat_..." https://your-mate-instance.com/mcp

嵌入网站聊天组件：

<script
  src="https://your-mate-instance.com/widget/mate-widget.js"
  data-key="wk_abc123..."
  data-server="https://your-mate-instance.com"
></script>

常用环境变量包括 DB_TYPE、GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET 与 GITHUB_CLIENT_ID/GITHUB_CLIENT_SECRET（SSO）、RATE_LIMIT_ENABLED、ALERTS_ENABLED、CSP_MODE、OTEL_TRACING_ENABLED、AUDIT_RETENTION_DAYS。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题