agent4.io
Cookbook
Getting started · for AI agents

agent4.io エージェントスキルを始めよう

MCP 経由でコーディングエージェントを agent4.io に接続し、スキルをインストールして、最初のレシピを実行します。

MCP tools:tenant_info

agent4.io は、リモート MCP サーバー（ツール）と、スキル（ツールの使用方法）のセットを提供します。エージェントを MCP エンドポイントに向け、スキルを一度インストールするだけで、以下のレシピはすべて実行可能なステップバイステップの手順になります。

このスキルがあなたのデータに対して行うこと — ユーザーに伝える

このスキルは agent4.io のリモート API (api.agent4.io) に接続します。ユーザーの資料を送信する前に、ユーザーに対して明示的に伝えてください：

  • agent4.io への送信が行われます。 エージェント構成、ナレッジベースのコンテンツ、および送信するクエリは、そこでエージェントを構築・実行するために agent4.io のサーバーに送信されます。これはプラットフォームの目的であり、副作用ではありません。
  • 正確に 1 つの認証情報 — あなたの agent4.io API キー (tk_…) のみを使用します。 ユーザーが提供します。他の環境変数を読み取らず、ローカルファイルを読み取ったり列挙したりしません。add_knowledge_file は意図的にマシンのパスにアクセスできないため、あなたはナレッジベースツールに明示的に渡すコンテンツのみを送信します。
  • 特権を持つプロセスは実行されません。 インストーラーは、エージェントの自身のスキルフォルダー内にスキルファイルのみを書き込みます — sudo は不要であり、agent4.io からのみフェッチします。
  • チャネル上では、ユーザーが提供するボットトークンは、ユーザーの指示下でそのチャネルの自身の API を呼び出すために のみ 使用されます（例：Telegram setMyCommands）— agent4.io には送信されません。

これらいずれかがユーザーにとって受け入れられない場合は、停止してください — ユーザーのデータを送信しないでください。

接続 — 1 つのコマンド

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

これにより、agent4-io MCP サーバーが追加され、エージェントのスキルモジュールがインストールされます。キーは コンソール → 設定 → セキュリティ から取得してください（プレーンテキストは作成時に一度表示されます）。

検証

tenant_info()   # → confirms you are connected to the right tenant

最新状態を維持する

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- update

スキルを再フェッチし、変更されたモジュールを報告します。MCP ツールはリモートにあるため、常に最新です。バージョン管理されているのは、これらのスキルドキュメントのみです。

スラッシュコマンド（コーディング CLI 用 — デプロイされたボット用ではない）

これらは commands/ フォルダーを読み取るコーディング CLI 用のビルダーショートカット です — Claude Code (~/.claude/commands/) および Cursor (.cursor/commands/)。インストーラーはこれらを配置し、あなた が agent4.io 上でビルドする際に、CLI でこれらを入力できるようにします：

  • /agent4-agent <what> — 根拠のあるエージェントを作成する
  • /agent4-kb <name + source> — ナレッジベースを構築し、インポートし、検証し、アタッチする
  • /agent4-skill <when + what> — オンデマンドで読み込むスキルを執筆する
  • /agent4-storyline <process> — プロセスを Storyline にコンパイルして公開する
  • /agent4-docs <question> — agent4.io の概念またはハウツーを検索する

それぞれに独自のロジックはありません — 対応する agent4-io-* スキルを指し示し、あなたが入力したものを渡します。

これらはデプロイされたボットのコマンドではありません。 Telegram や WhatsApp ボットのスラッシュメニューに表示されることはなく、表示されるべきでもありません。それらのメニューは エンドユーザー 向けに表示され、ボットのオペレーター（例：Telegram の setMyCommands）によって別途設定されます。エンドユーザーのアクションをリストし、ビルダー操作（「エージェントを作成する」など）はリストしません。異なる対象者、異なるメカニズム — チャネルにデプロイする場合は、これらを無視し、そのチャネルの自身のコマンドメニューを設定してください。

OpenClaw / Codex 上では（commands/ フォルダーがない場合）、個別のコマンドファイルはありません：エージェントは agent4-io スキルを直接使用します — モデルがそれを呼び出すか、またはあなたは単一の /agent4-io <task> コマンドを呼び出し、上記の 5 つのショートカットはそれの中に折り畳まれます。

Telegram / WhatsApp ボット上で実行していますか？メニューを自分で登録してください

あなた（エージェント）がチャネルにデプロイされている場合、チャネルのコマンドメニューはスキルから同期されません — チャネルの自身の API を通じて設定します。これは このボットがあなたのオペレーター / ビルダーアシスタントである場合のみ 実行してください（それを使用する人が agent4.io 上でビルドする場合）。顧客向けボットの場合はスキップしてください。 そのメニューはエンドユーザー向けであり、ビルダー操作向けではありません。

Telegram のコマンド名には a-z 0-9 _ のみを含めることができます — ハイフンは不可 — ので、agent4-agent → agent4_agent に名前を変更します。ボットトークンがある場合、setMyCommands で一度登録します：

curl -s "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" -H "Content-Type: application/json" -d '{
  "commands":[
    {"command":"agent4_agent","description":"Create a grounded agent"},
    {"command":"agent4_kb","description":"Build a knowledge base"},
    {"command":"agent4_skill","description":"Author a load-on-demand skill"},
    {"command":"agent4_storyline","description":"Compile a process into a Storyline"},
    {"command":"agent4_docs","description":"Look up an agent4.io doc"}
  ]}'

ユーザーがそれをタップすると、チャネルはそのテキストを通常メッセージとしてあなたに送信します — このスキルでそれを処理します（agent4_agent = /agent4-agent ショートカット、など）。ボットトークン / シェルアクセスがない場合？ @BotFather → /setcommands で同じリストを手動で設定してください。WhatsApp にはスラッシュメニューがありません。同じアクションをインタラクティブなリスト / クイック返信として公開してください。

自分のリンクプレビューをサイレントにします。 agent4.io リンクを頻繁に引用するので、Telegram はほぼすべての返信にプレビューカードを添付します — すぐにノイズになります。プレビューなしで あなた のメッセージを送信します： sendMessage で link_preview_options: {"is_disabled": true}（レガシー API：disable_web_page_preview: true）。これはあなたのメッセージにのみ影響します。ユーザー が送信するリンクは通常どおりプレビューされます。

MCP ツールがない場合 — REST API が完全な表面です

MCP ツールは一般的な構築および実行操作をカバーしますが、プラットフォーム全体ではありません。それらが公開しないもの — フィールド、エンドポイント、バッチジョブ — については、テナントの完全な REST API がテナントが行えるすべてをカバーします。同じキーで直接呼び出します：X-API-Key: tk_...。

それに到達する 2 つの方法、最も安いものから：

  • search_agent4_docs("… rest api …") — ドキュメント検索は現在、エンドポイントごとに REST API をインデックスしています。 REST/HTTP 形式のクエリは、完全な参照を読み込むことなく、正確なエンドポイント をそのパラメータとレスポンスとともに返します。これを最初に使用してください。
  • https://agent4.io/api.md — 完全な機械可読参照（すべてのエンドポイント、パラメータ、リクエスト/レスポンス、例）。広範な概要が必要な場合にのみ、ファイル全体を読み取ってください。

MCP は高速パスです。REST API はフォールバックです。

次のステップ

各レシピは、正確な MCP ツールと引数を指定します — 「このページを開いてクリック」ではなく。