組み込みツール(およびシステムMCP)
リード獲得、ドキュメント、フォローアップ、ウェブ検索といったプラットフォーム標準のツール、および自動インストールされる時刻・天気・位置情報サーバー。
list_toolsupdate_agent共通ツールを構築する必要はありません — プラットフォームがそれらを同梱しています。このエージェントの業務に必要なツールを update_agent(name, add_tools=[…]) でアタッチしてください。ツールセットは小さく保つようにしてください(設計原則 参照)。テナント上の正確な名前を確認するには list_tools() を使用してください — これが唯一の信頼できる情報源です。
tools=[…]はリスト全体を置き換えます;add_tools/remove_toolsは1つの項目を変更します。検討中のツールだけを指定してtools=を渡すと、最初に確認しなかったすべてのツールが静かに削除されます — これは本番環境で発生し、機能しなくなったまで誰も気づかなかった例があります。tools=は「まさにこのセット」と意図的に指定する場合のみ使用し、どちらの場合でも最終リストを確認するために返されるエージェントを読み取ってください。スキル(add_skills/remove_skills)およびナレッジベース(add_knowledge_bases/remove_knowledge_bases)にも同様のペアが存在します。
組み込みツール
| ツール | 機能 |
|---|---|
web_search | オープンウェブ上で何かを検索します。 |
save_contact | エンドユーザーの連絡先情報をそのプロファイルに記録します — プラットフォームのリードキャプチャ / レコードパスです。エージェントがユーザーに伝える 実在の参照コード(AB2C-D3EF 形式)を返します;ユーザーの詳細ページ(recent_refs)でコードを検索してください。 |
export_document | 会話用の構造化ドキュメント(ブランド付き要約 / レポート)を生成します。 |
schedule_followup | 後でプロアクティブにフォローアップする(「2日後に確認する」)か、ユーザーがリクエストした折り返し電話を予約します — メッセージはプラットフォームが送信します。スケジュールされたタスクに追跡可能な 実在の予約参照 を返します。絶対時刻(「明日の午前10時」)の場合、モデルに run_at (ローカルISO日付時刻 + オプションの tz)を渡すよう指示してください — サーバーがユーザーのタイムゾーンを解決します;手計算の delay_seconds は相対時刻のみを対象としており、モデルは算術を誤ります。ウィンドウ:最大7日間。 |
schedule_reminder | エンドユーザーのリマインダーを設定します;list_reminders / cancel_reminder がそれらを管理します。 |
compute_chart | コード内で派生系列を計算します — 全体の割合、成長率、累積合計、固定レートでの予測、または従量課金制の請求書(基本料金 + 基本枠 + 単体超過料金)。すでにツールを持つエージェントには自動的にアタッチされるため、手動で追加することはほとんどありません。回答でのチャート を参照してください。 |
load_skill も組み込みですが、アタッチする必要はありません — モデルはスキルの description が一致した場合、独自にスキルを呼び出します。
list_tools() # テナントで利用可能な正確な名前
update_agent(name="Support", add_tools=["save_contact", "schedule_followup"]) # 増分的 — 既存のものを保持save_contact で連絡先をキャプチャすると、ユーザーのレコードが更新されます;エージェントの ask_forms と組み合わせることで、構造化された入力情報がコンソールで確認できるレコードとして記録されます。
プラットフォームはこれら2つを自動的にバックアップします。 エンドユーザーのメッセージに明確なシグナル(電話番号 / メールアドレス(任意の言語、 spelled-out 数字やスペース区切りフォーマットを含む)、または「明日の朝電話をかけて」タイプの折り返し電話リクエスト)が含まれ、save_contact / schedule_followup が有効になっている場合、プラットフォームは1ターンごとにモデルにツールを呼び出すよう促すヒントを注入します。本番環境のバックエンドでベンチマークした結果、この手法により最も性能の低いモデルにおけるリードキャプチャの準拠率が約85%から100%に向上し、ゼロ の誤った保存(ヒントには「誤りの場合は無視する」というエスケープハッチが含まれているため、過剰に敏感な検出器が誤ったデータを引き起こすことはありません)でした。これは無料で利用できます — 設定は不要です。スキルは依然として description でトリガーを明記する必要があります(スキルの作成 参照)、ヒントは安全網であり、置き換えではありません。
システムMCP — すでにインストール済み
すべてのテナントには、デフォルトで有効化された組み込みの system MCPサーバーがあり、キーレスのツールで ローカル時刻、天気、IPジオロケーション(都市 / 地域 / タイムゾーン)を提供します。登録する必要はありません — そこにあります。そのツールは、上記の組み込みツールとともに list_tools() に表示され、アタッチの準備ができています。
したがって、「ユーザーの所在地の天気は?」や「ローカル時刻は?」といった問いは、そのまま動作します — プラットフォームがエンドユーザーのクライアントIPを注入するため、位置情報に基づく回答にはセットアップは不要です。