仕組み
プラットフォームが自動で何をしてくれるかを理解しましょう。そうすれば、設定が不要なものが分かります。task を送るだけで、プラットフォームがルーティング、ツール呼び出し、結果の受け渡しを行います。
自動ルーティング：1つのエンドポイント、2つのレーン
task を POST /v1/workspaces/{workspace_id}/agent/runs に送ると、プラットフォームがどの実行レーンが適切かを判断します。あなた自身がエンドポイントを選ぶことはありません：
Chat レーン — 高速でテキストのみの返信。モデルが1ターンで直接答えられる質問向け（「SEPA Instant を説明して」「これを翻訳して」）。高速かつ低コスト。
Agent レーン — 自律的・複数ステップ・ツール呼び出し。調査、ファイル作成、コード実行、ブラウザが必要なタスク向け（「Wise と Airwallex の手数料を比較して表を出力して」「ナレッジベースを読んで返金ポリシーを要約して」）。
ルーターはヒューリスティック優先（ほぼゼロコスト、LLM 呼び出しなし）で、タスクが明らかにツールや複数ステップを必要とする場合にのみエスカレートします。Chat の返信の途中でツールが必要になった場合は、自動的に agent レーンへエスカレートします — 目に見える切り替えも、あなた側での再試行も不要です。
どちらの場合も1つのエンドポイントに送ります。タスクが高速な chat として実行されるか、完全な agent ループとして実行されるかは、あなたではなくプラットフォームの判断です。純粋な chat 返信（ツールなし、最低レイテンシ）を保証したい場合は、直接 POST …/chat を使ってください — Chat を参照。
組み込みツール：設定不要
Agent には完全なツールキットが組み込まれています。タスクに基づいて呼び出すツールを自分で判断します — あなたがツールを選択・設定・接続する必要はありません。以下はすべてデフォルトで毎回の実行で利用できます：
カテゴリー | ツール | 自動呼び出しのタイミング |
|---|---|---|
Web 調査 |
| タスクがリアルタイムの Web 情報、ページの読み取り、PDF/画像の抽出を必要とする |
あなたのナレッジベース |
| タスクがワークスペースにアップロードされたファイルやデータを参照する |
オープンデータセット |
| タスクが金融、学術、構造化された公開データを求める |
コード実行 |
| タスクが計算、データ処理、分析を必要とする |
ブラウザ |
| タスクが Web サイトの訪問、ログイン、ページとの対話を必要とする |
ファイル作成 |
| タスクが成果物のドキュメント、スプレッドシート、スライドを求める |
メモリ |
| agent が将来の実行に向けた事実の保存や再呼び出しを必要とする |
計算ヘルパー |
| タスクが算術、単位換算、タイムスタンプを必要とする |
以上はすべてゼロ設定です — プラットフォームの一部であり、毎回の agent 実行で利用できます。モデルがタスクに合ったツールを選びます。ストリーミングイベント（tool_call → tool_result）で各ツール呼び出しを確認できます。
唯一の例外：コネクタ。 サードパーティのアカウント（Gmail、Slack、GitHub、Notion、Supabase、Datadog など）は、Settings → Connectors で一度だけ OAuth または API key 接続を行う必要があります。接続後、agent はそれらも自動的に使用します。Connectors を参照。
自動出力：計画 → 実行 → 受け渡し
Agent の実行は自己主導型のループです。あなたがステップをスクリプト化する必要はありません — agent が計画します：
計画 — モデルがタスクをステップに分解します（「まず X を検索し、次に上位の結果を読み、それから統合する」）。
実行 — 計画したツールを呼び出し、1つずつ（安全な場合は並行で）実行し、各結果を読んでから次のステップに進みます。
検証 — タスクと照らして自身の出力を確認し、ツールが失敗したり結果が不完全な場合は再試行します。
受け渡し — 最終的な回答は
run_endイベントのfinal_textに格納され、生成されたファイルは artifacts として返されます。
各ステップは GET …/agent/runs/{run_id}/attach 経由でリアルタイムにストリーミングされます — 推論、ツール呼び出し、回答の生成をその場で確認できます。また、後から GET …/agent/runs/{run_id} で完了した実行（完全なステップ履歴付き）を取得することもできます。
オプションの拡張（必須ではありません）
ベースライン — 追加パラメータのない task — は、すでに完全なツール能力とスマートなルーティングを備えています。以下は純粋に任意の改善です：
Skills — 再利用可能なワークフローのプレイブック。1つ注入して、agent がタスクにどう取り組むかを誘導します（例：「競合分析」プレイブック）。自動付与はされず、明示的に選択します。
スペシャリストロール — ドメインのアイデンティティ（弁護士、データアナリスト、ブランドガーディアン）。その実行で agent が「誰」になるかを決めます。最大1つまで。
Projects — 常駐の指示 + アップロードされたナレッジを、再利用可能なコンテキストとしてまとめたもの。実行をプロジェクトに紐付け、あなたのドメインに基づかせます。
Memory — ワークスペースの長期記憶。事実を一度保存すれば、関連する将来の実行で agent が自動的に再呼び出しします。
**pro**モード — 複雑なタスク向けに、より深くマルチスレッドな推論（並列サブ agent）をアンロックします。実行 body 上のブールフラグです。
これらはいずれも連携に必須ではありません。まずは {"task": "…"} だけで始め、具体的なニーズが生じたときだけ拡張を追加してください。Cookbook に各拡張の実際の使い方が載っています。