Turbo Notify: WhatsApp for AI agents

Turbo Notify エージェントスキル

Turbo Notify MCP serverをAIエージェントで活用するスキルです。Claude Code、Claude Desktop and Cowork、Codex、Antigravity CLI、Gemini CLI、およびAgent Skills形式を読み取るその他すべてのエージェントに対応しています。

スキル

スキル	機能
virtual-attendant	WhatsAppでビジネスの顧客に対応します。顧客の言語で回答し、顧客一人ひとりを記憶し、必要に応じて担当者を呼び出し、管理者や担当者からの指示もWhatsApp上で受け付けます。

顧客向けガイド（ポルトガル語と英語）：WhatsAppバーチャル担当者、 エージェントスキル、 AIエージェント。各エージェントのページもご覧ください。

インストール

エージェント	コマンド
Claude Code	claude plugin marketplace add turbo-notify/agent-skills の後に claude plugin install turbo-notify@turbo-notify
Claude Desktop and 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/ に追加します。~/.config/opencode/skills/ に追加する場合は -g を指定します）。続いて 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形式を読み取るその他のエージェント（Cursor、Copilotなど）	npx skills add turbo-notify/agent-skills を実行し、そのエージェントの設定でMCPサーバー https://mcp.turbonotify.com を追加します

無人実行ランナーに対応しているのはClaude CodeとCodexのみです。それ以外のエージェントでは、担当者がセッションを開いたままにし、各下書きを承認するアシストモードで動作します。

上記のプラグインはTurbo Notify MCPサーバー（https://mcp.turbonotify.com）をすでに宣言しているため、追加設定は不要です。エージェントが初めて使用するときに、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/にある、お使いのエージェント向けのガイドをご覧ください）。

更新

このスキルはサイクルごとにバージョンを確認し、新しいバージョンがある場合は、使用中のエージェント向けコマンドとともに管理者に通知します。

エージェント	コマンド
Claude Code	claude plugin marketplace update turbo-notify の後に claude plugin update turbo-notify@turbo-notify
Claude Desktop and Cowork	マーケットプレイスはリポジトリと同期します。新しいバージョンが表示されない場合は、マーケットプレイスを削除して再度追加してください
Codex	codex plugin marketplace upgrade の後に codex plugin add turbo-notify@turbo-notify
Antigravity	インストールコマンドを再実行します
Gemini CLI	gemini extensions update turbo-notify

接続先

• .mcp.json、mcp.json、mcp_config.json（エージェントの種類ごとに1つのファイル。いずれもキーやヘッダーは保持しません）でプラグインが指定する、https://mcp.turbonotify.com の Turbo Notify MCP サーバーです。アカウントでサインインするか、API キーを使って独自のアカウントを接続します。アカウントまたは API キーの権限で動作します。
• お使いのコンピューター上の1つのフォルダー（デフォルトでは ~/.turbo-notify/attendant）です。ここには顧客ごとに、会話（デフォルトでは90日間保存され、その後削除されます）、古い会話部分の短い要約、その顧客が伝えた情報（名前、好み、依頼内容）を記したファイル、および教えた内容が保存されます。Turbo Notify にコピーが送られることはありません。/forget を実行すると1人の顧客のデータが消去されます。保存期間は memory-policy.json で変更できます。
• https://api.turbonotify.com の Turbo Notify API です。無人ランナーまたはコンソールコマンドがメッセージを送信する際、ヘルパーが API キーを使って呼び出します。
• Turbo Notify 以外のネットワークアドレスは1つだけです。バージョン確認のために raw.githubusercontent.com/turbo-notify/agent-skills/main/latest.json を約1時間ごとに読み込みます（確認に失敗した場合は10分後にも再試行します）。失敗しても何も変わりません。
• セットアップ中にそれぞれ許可した場合に限り、ほかの MCP サーバーにも接続します。

実行する処理と送信する情報

• python3 で tn_assist ヘルパーを実行します。ヘルパーは標準ライブラリのみを使用し、何もインストールしません。
• 無人ランナー（Claude Code と Codex）では、顧客ごとに1回、お使いの claude または codex コマンドを独立したプロセスで起動し、ツールを使わずにその顧客への回答を作成します。プロセスに渡されるのは、その顧客のメッセージ、その顧客のファイル、およびメッセージに合致する業務知識（会社、口調、引き継ぎに関するファイルに加え、メッセージの語句に基づいて選ばれた最大3つのファイル）のみです。それ以外は渡されません。
• 顧客のメッセージ本文は、お使いのエージェントのモデルに、そのエージェントのアカウントを通じて送られます。それ以外の場所には送られません。
• 無人ランナーは、設定した TURBO_NOTIFY_API_KEY 変数から API キーを読み込み、各リクエストのサインインに使うため、api.turbonotify.com にのみ送信します。顧客への回答を作成するプロセスに渡されることはありません。
• 回答は API キーを使って Turbo Notify API 経由で、メッセージを送った顧客に送信されます。送信のたびに確認を行い、別の顧客の電話番号や名前、非公開のテキスト、認証情報が含まれていれば送信を停止します。
• 各チャットの最初の回答では、AI が回答していることを顧客に伝えます。この一文はモデルではなく、ヘルパーが追加します。
• 顧客が「ありがとう」や「ok」とだけ言った場合、または親指を立てた絵文字だけを送った場合は、回答せず、人にも引き継ぎません。モデルはそのように求める必要があり、ヘルパーが同意するのは、メッセージが感謝または了解の表現だけの場合に限られます（疑問符や数字が含まれず、固定リストにある少数の語句だけで構成されていること）。それ以外は回答するか、人に引き継ぎます。
• 回答が教えた内容に含まれない場合（価格、在庫、納期、約束、ポリシーなど）、顧客が人への引き継ぎを求めている場合や怒っている場合、依頼が業務の範囲外の場合、支払いの問題、返金や交換、苦情、法的な問題が生じた場合、またはアシスタントに書面での約束や確認を求めた場合は、人に引き継ぎます。交換期間など、あなたが記載したルールについての一般的な質問には回答します。
• モデルの回答を読み取れない場合、ヘルパーは問題の内容を示す一文を添えて1回だけ再試行します。連続して2回失敗した場合は、人が対応を引き継ぐことを顧客に伝えます。

構成

.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件提示し、7つの会話を行います（一部は「ありがとう」で終わりますが、これには回答する必要はありません）。各返信について、ナレッジに記載されていない価格、日付、時刻、数量、割引、約束が含まれていないか、返信の言語が正しいか、「ありがとう」はそのままにし、「ok」が実際には質問である場合は回答しているかを確認します。最後の2つのチェックでは、モデルの回答を途中で切り、ランナーが読み取れない回答をどう処理するかを確認します。また、提案（「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)

リリース時は、tools/release.py sync で VERSION、latest.json、5つのマニフェスト、ヘルパー、pyproject のバージョン、CHANGELOG.md をまとめて更新してから、v1 タグを移動します。このタグは、1.x に固定したい場合に引き続き利用できます（...agent-skills#v1、または Codex で --ref v1）。

ライセンス

MIT。詳しくは LICENSE をご覧ください。