Turbo Notify: WhatsApp for AI agents

Turbo Notify Agent 技能

这些技能可让 Turbo Notify MCP server 在你的 AI Agent 中发挥作用：Claude Code、Claude Desktop 和 Cowork、Codex、Antigravity CLI、Gemini CLI，以及任何读取 Agent Skills 格式的其他 Agent。

技能

技能	功能
virtual-attendant	通过 WhatsApp 为企业客户提供服务：使用客户的语言回答问题、记住每位客户、在必要时联系人工，并直接通过 WhatsApp 接收管理员和接待人员的指令。

客户指南（葡萄牙语和英语）：WhatsApp 虚拟接待员、 Agent 技能 和 AI Agent，每种 Agent 均有单独的页面。

安装

Agent	命令
Claude Code	claude plugin marketplace add turbo-notify/agent-skills 然后运行 claude plugin install turbo-notify@turbo-notify
Claude Desktop 和 Cowork	Customize、Plugins、Add、Add marketplace、Add from a repository：turbo-notify/agent-skills；然后选择 Discover、turbo-notify、Add
Codex	codex plugin marketplace add turbo-notify/agent-skills 然后运行 codex plugin add turbo-notify@turbo-notify
Antigravity	agy plugin install https://github.com/turbo-notify/agent-skills
Gemini CLI	gemini extensions install https://github.com/turbo-notify/agent-skills
Hermes Agent	hermes skills install turbo-notify/agent-skills/skills/virtual-attendant，然后在 Hermes 中添加 MCP 服务 https://mcp.turbonotify.com
OpenCode	npx skills add turbo-notify/agent-skills -a opencode（项目文件夹 .agents/skills/，或使用 -g 安装到 ~/.config/opencode/skills/），然后运行 opencode mcp add --global --url https://mcp.turbonotify.com turbo-notify 和 opencode mcp auth turbo-notify 登录。指南：在 OpenCode 中使用 Turbo Notify
Cline	将 MCP 服务 https://mcp.turbonotify.com 添加到 cline_mcp_settings.json（编辑器和 CLI 的步骤见 llms-install.md）
其他读取 Agent Skills 格式的 Agent（Cursor、Copilot 等）	npx skills add turbo-notify/agent-skills，然后在该 Agent 自身的设置中添加 MCP 服务 https://mcp.turbonotify.com

仅 Claude Code 和 Codex 支持无人值守运行器。其他 Agent 会以辅助模式运行接待员：保持会话开启，并由人工审批每条草稿。

上表中的插件行已声明 Turbo Notify MCP 服务（https://mcp.turbonotify.com），因此无需另行添加。Agent 首次使用时，请使用你的 Turbo Notify 账户登录（Claude Code：/mcp；Codex：codex mcp login turbo-notify；Antigravity：在 Agent settings、Customizations 中点击服务旁的 Authenticate），然后让它“设置 Turbo Notify 虚拟接待员”。还没有账户？请前往 https://dashboard.turbonotify.com/auth/signup?locale=en 创建。对于任何独立运行的场景，请改用 API 密钥（参见 skills/virtual-attendant/references/ 中适用于你的 Agent 的指南）。

更新

该技能会在每个周期检查版本，并在有新版本时向管理员发送消息，同时附上当前 Agent 的更新命令。

Agent	命令
Claude Code	claude plugin marketplace update turbo-notify 然后运行 claude plugin update turbo-notify@turbo-notify
Claude Desktop 和 Cowork	市场会与仓库同步；如果未显示新版本，请移除该市场并重新添加
Codex	codex plugin marketplace upgrade 然后运行 codex plugin add turbo-notify@turbo-notify
Antigravity	再次运行安装命令
Gemini CLI	gemini extensions update turbo-notify

能访问的内容

• Turbo Notify MCP 服务位于 https://mcp.turbonotify.com，插件会在 .mcp.json、mcp.json 和 mcp_config.json 中声明该服务（每类 Agent 对应一个文件；其中都不包含密钥或请求头）。你可以使用自己的账户登录，也可以通过 API 密钥连接自己的账户。服务会在你的账户或 API 密钥权限范围内运行。
• 你电脑上的一个文件夹（默认位于 ~/.turbo-notify/attendant），其中按客户保存对话（默认保留 90 天，之后删除）、较早对话内容的简短摘要，以及记录该客户提供的信息（姓名、偏好、询问内容）和你传授的知识的文件。Turbo Notify 不会获取副本。/forget 会清除一位客户的数据；你可以在 memory-policy.json 中更改保留天数。
• Turbo Notify API，地址为 https://api.turbonotify.com。在无人值守运行器或控制台命令发送消息时，辅助程序会使用你的 API 密钥调用该 API。
• 除 Turbo Notify 外，还会访问一个网络地址：raw.githubusercontent.com/turbo-notify/agent-skills/main/latest.json。版本检查大约每小时读取一次；检查失败时会在 10 分钟后重试。检查失败不会造成任何改变。
• 只有在设置过程中逐一允许后，才会访问你的其他 MCP 服务。

运行内容和发送内容

• 它会通过 python3 运行 tn_assist 辅助程序。该辅助程序只使用标准库，不会安装任何内容。
• 在无人值守运行器中（Claude Code 和 Codex），它会针对每位客户启动一次你自己的 claude 或 codex 命令，在一个独立进程中撰写该客户的答复；该进程不具备任何工具。进程只会收到该客户的消息、该客户的文件，以及与消息相关的业务知识（公司、语气和转交文件，以及根据消息中的词语选出的最多三份其他文件），不会收到其他内容。
• 客户消息的文本会发送给你使用的 Agent 所对应的模型，并由你在该 Agent 下的账户承担费用，不会发送到其他地方。
• 无人值守运行器会从你为其设置的 TURBO_NOTIFY_API_KEY 变量中读取 API 密钥，并且只会将其发送到 api.turbonotify.com，作为每个请求的登录凭据。该密钥绝不会传递给撰写客户答复的进程。
• 答复会通过 Turbo Notify API 使用你的 API 密钥发送给发消息的客户。每次发送前都会进行检查，阻止发送其他客户的电话号码或姓名、非公开文本和凭据。
• 每段对话的第一条答复都会告知客户内容由 AI 生成。该提示由辅助程序添加，而非模型生成。
• 如果客户只说谢谢、回复“ok”或发送点赞表情，则不会收到答复，也不会转交给人工。模型必须先提出这种处理方式；辅助程序只会在消息纯粹是感谢或确认时同意（没有问号、没有数字，且仅包含固定列表中的少量词语）。其他任何内容都会得到答复，或转交给人工。
• 出现以下情况时，客户会被转交给人工：答复内容不在你传授的知识范围内（例如价格、库存、截止日期、承诺或政策）；客户要求人工处理或情绪激动；请求超出业务范围；涉及付款问题、退款或换货、投诉或法律事务；或者客户要求助手以书面形式承诺或确认。对于你写明的规则（例如换货期限），客户提出普通问题时会得到答复。
• 如果无法读取模型的答复，辅助程序会重试一次，并说明出错原因；如果连续第二次失败，就会向客户发送消息，告知后续将由人工处理。

文件布局

.claude-plugin/        plugin and marketplace manifests (Claude Code, Codex)
.codex-plugin/         the manifest Codex reads for the name, logo and listing text
plugin.json            manifest for Antigravity
gemini-extension.json  manifest for the Gemini CLI (the connection to the server)
.mcp.json              the Turbo Notify MCP server, as Claude Code, Claude Desktop, Cowork and Codex read it
mcp.json               the same server, as the Agent Plugins format reads it (Copilot, Cursor)
mcp_config.json        the same server, as Antigravity reads it
assets/icon.png        the plugin icon
agents/                the tool-less agent that answers a customer
skills/virtual-attendant/
  SKILL.md             the entry point the agent reads
  references/          one short file per topic (setup, tick, console, memory, privacy, ...)
  assets/templates/    interview templates (pt, en) and the memory policy
  scripts/tn_assist/   the helper: routing, memory, egress check, runner (Python 3.9+, no dependencies)
tools/release.py       version consistency check and sync
tests/                 unit, property and security tests (Poetry, development only)
evals/attendant/       live evaluation of a customer's turn on a real model, with a made-up shop

辅助程序负责落实模型不能被信任处理的保障措施：通过已登记的电话号码由代码判定客户身份；客户的每次交互都在不使用工具的情况下运行；每条答复在发出前都会通过数据外发检查；数据绝不会离开工作区文件夹。

开发

poetry install
poetry run pytest
poetry run ruff check . && poetry run ruff format --check .
poetry run mypy
python3 tools/release.py check

实时评估需要你自己的 claude 命令，并且已登录。它会提出 40 个知识库无法回答的问题和 11 个知识库可以回答的问题，并播放七段对话（其中一些以感谢结束，无需回复）。它会检查每条回复是否包含知识库未说明的价格、日期、时间、数量、折扣或承诺，检查回复使用的语言，并确认感谢不会得到回复，而真正的问题“ok”会得到回答。最后两项检查会截断模型的回答，看看运行器如何处理无法读取的回答；还会在一个提议（“quer que eu chame alguém?”）后发送“ok”，确认它会得到回答，而不是被忽略。其中没有任何真实数据。

poetry run python -m evals.attendant run                # writes evals/attendant/results/<date>-<label>/
poetry run python -m evals.attendant run --set refusal  # only the check on an unreadable answer
poetry run python -m evals.attendant run --set offers   # only the check on an ok that accepts an offer
TN_EVALS_LIVE=1 poetry run pytest evals                 # the same, as tests (skipped otherwise)

发布时，要同时更新 VERSION、latest.json、五个清单、辅助工具和 pyproject 版本以及 CHANGELOG.md（tools/release.py sync）， 然后移动 v1 标签。该标签会保留，供希望固定到 1.x 的人使用（...agent-skills#v1，或在 Codex 中使用 --ref v1）。

许可证

MIT。请参阅 LICENSE。