メインコンテンツへスキップ
エージェントビルダーのツールタブでは、エージェントにカスタムツールとワークフローを追加できます。ツールキット(事前構築された統合)とは異なり、ツールはユーザーが作成したカスタムツールとワークフローであり、ニーズに合わせた特定の機能でエージェントの機能を拡張します。

概要

ツールにより以下が可能になります:
  • カスタムツールを追加:プロジェクトで作成したカスタムツールを添付
  • ワークフローを追加:マルチステッププロセスを実行するワークフロー/アクションを含める
  • 新しいツールを作成:エージェントビルダーから直接新しいカスタムツールを構築
  • ツール設定を管理:エージェントがツールを使用する方法を設定
  • ツールライブラリを閲覧:パブリックライブラリから数千の事前構築ツールにアクセス

ツール vs. ツールキット

違いを理解することで、適切なアプローチを選択できます:
機能ツールツールキット
タイプカスタムツールとワークフロー事前構築された統合
作成ユーザー作成またはライブラリからEKBが事前設定
スコーププロジェクト固有またはパブリックプラットフォーム全体の統合
設定完全なカスタマイズオプション付きの事前設定
カスタムAPI呼び出し、ワークフロー、ビジネスロジックGmail、Slack、Google Driveなど
ツールを使用する場合:
  • カスタムビジネスロジックが必要
  • 再利用可能なワークフローを作成したい
  • カスタムAPIと統合する必要がある
  • 複数の操作を1つのツールにまとめたい
ツールキットを使用する場合:
  • 標準的な統合が必要(Gmail、Slackなど)
  • 事前設定された認証が必要
  • 共通の操作が必要(メール送信、タスク作成など)

ツールタブへのアクセス

  1. エージェントビルダーを開く
    • サイドバーのエージェントに移動
    • 既存のエージェントの編集またはエージェントを作成をクリック
    • エージェントビルダーが開きます
  2. ツールタブに移動
    • 左サイドバーでツールをクリック
    • ツールタブが選択済みツールと追加オプションを含めて表示されます

エージェントにツールを追加

既存のカスタムツールを追加

  1. ツールセレクターを開く
    • ツールタブの**+ ツールを追加**ボタンをクリック
    • ツールセレクターモーダルが開きます
  2. 利用可能なツールを閲覧
    • カスタムツール:プロジェクトで作成したツール
    • パブリックツール:パブリックライブラリのツール(9,000以上利用可能)
    • ワークフロー:プロジェクトの既存ワークフロー
  3. 検索とフィルタ
    • 検索バーを使用して特定のツールを見つける
    • カテゴリまたはタイプでフィルタ
    • 人気順または最近の追加で閲覧
  4. ツールを選択
    • ツールをクリックして詳細を表示
    • ツールの説明と入力を確認
    • 追加をクリックしてエージェントに添付

新しいカスタムツールを作成

  1. ツールセレクターから
    • ツールタブの**+ ツールを追加**をクリック
    • モーダルのカスタムツールを作成をクリック
    • ツールビルダーにリダイレクトされます
  2. 空の状態から
    • ツールがない場合、最初のツールを作成をクリック
    • 新しいツールのツールビルダーが開きます
  3. ツールを設定
    • 名前:ツールに説明的な名前を付ける
    • 説明:ツールの機能を説明
    • 入力:入力パラメータを定義
    • ステップ:ツールの実行ステップを設定
    • 保存:下書きとして保存するか、公開
  4. エージェントに戻る
    • 作成後、ツールがプロジェクトで利用可能になります
    • エージェントビルダーに戻り、ツールセレクターで追加

ワークフローを追加

  1. ツールセレクターを開く
    • ツールタブの**+ ツールを追加**をクリック
    • モーダルのワークフローを作成をクリック
  2. ワークフロートリガーを選択
    • トリガータイプを選択:
      • フォーム入力:ユーザーがフォームに入力
      • ファイルアップロード:ユーザーがファイルをアップロード
      • 手動:オンデマンドで実行
  3. ワークフローを設定
    • ワークフローステップを設定
    • 入力と出力を定義
    • トリガー設定を構成
  4. エージェントに追加
    • 作成後、ワークフローがツールリストに表示されます
    • 必要に応じてエージェントが実行できます

ツールの管理

追加済みツールの表示

ツールタブには以下が表示されます:
  • サイドバー:エージェントに追加されたすべてのツールを表示
    • カスタムツール
    • ワークフロー
    • プロジェクトのアクション
  • メインエリア:ツールの詳細と管理オプションを表示

ツールのステータス

ツールには異なるステータスがあります:
  • アクティブ:ツールの使用準備完了
  • 下書き:ツールが編集中(まだ公開されていない)
  • 公開済み:ツールが公開され、利用可能

ツールの設定

  1. ツール設定を編集
    • 追加済みツールの設定をクリック
    • ツール固有の設定を調整
    • 必要に応じて承認要件を設定
  2. ツール承認設定
    • 自動実行:トリガーされるとツールが自動的に実行
    • 承認を要求:エージェントが実行前に確認を求める
  3. 入力のデフォルト値
    • ツール入力のデフォルト値を設定
    • 必須とオプションの入力を構成

ツールの削除

  1. エージェントから削除
    • サイドバーのツールのXボタンをクリック
    • またはツール詳細の削除をクリック
    • 削除を確認
  2. カスタムツールを削除
    • カスタムツールの場合、完全に削除可能
    • カスタムツールの3点メニューをクリック
    • 削除を選択
    • 注意:これによりプロジェクトからツールが完全に削除されます

ツールのタイプ

カスタムツール

カスタムツールは以下を作成したツールです:
  • カスタムロジック:独自のビジネスルールとプロセス
  • API統合:独自のAPIに接続
  • マルチステップ操作:複数のアクションを組み合わせ
  • データ処理:データの変換と操作
カスタムツールの作成:
  1. 入力を定義(ツールが受け付けるパラメータ)
  2. ステップを設定(ツールが実行する内容)
  3. エラー処理を設定
  4. ツールをテスト
  5. 準備ができたら公開

ワークフロー

ワークフローは以下のマルチステッププロセスです:
  • シーケンスを実行:複数の操作を順番に実行
  • トリガーを処理:フォーム入力やファイルアップロードに応答
  • データを処理:複数のステップを経てデータを変換
  • サービスを統合:複数のサービスを接続
ワークフロートリガー:
  • フォーム入力:ユーザーがフォームで入力を提供
  • ファイルアップロード:ユーザーが処理のためにファイルをアップロード
  • 手動:エージェントによるオンデマンド実行

パブリックツール

パブリックツールライブラリには以下が含まれます:
  • 9,000以上のツール:コミュニティによる事前構築ツール
  • ** various カテゴリ**:コミュニケーション、生産性、データなど
  • すぐに使用可能:クローンしてニーズに合わせてカスタマイズ
  • 定期的に更新:新しいツールが頻繁に追加
パブリックツールの使用:
  1. パブリックライブラリを閲覧
  2. ニーズに合ったツールを見つける
  3. プロジェクトにクローン
  4. 必要に応じてカスタマイズ
  5. エージェントに追加

ベストプラクティス

ツールの整理

  1. 明確に命名:ツールの目的を説明する説明的な名前を使用
  2. 適切に文書化:各ツールに明確な説明を追加
  3. 関連ツールをグループ化:機能またはカテゴリ別にツールを整理
  4. バージョン管理:公開前にテストのために下書きを使用

ツール選択

  1. シンプルに始める:基本的なツールから始め、徐々に複雑さを追加
  2. 徹底的にテスト:本番エージェントに追加前にツールをテスト
  3. パフォーマンスを考慮:ツールが多すぎるとエージェントの応答が遅くなる
  4. 定期的に見直し:未使用のツールを削除してエージェントを効率的に維持

ツール設定

  1. 適切なデフォルト値を設定:適切なデフォルト値を構成
  2. 必要に応じて承認を使用:機密性の高い操作に承認を要求
  3. エラーを処理:ツールに適切なエラー処理があることを確認
  4. 入力を文書化:各入力の機能を明確に文書化

ユースケース

カスタマーサポートエージェント

必要なツール:
  • チケット作成ツール:サポートチケットを作成するカスタムツール
  • ナレッジベース検索:ドキュメントを検索するツール
  • イシューエスカレート:人間のエージェントにエスカレートするワークフロー

データ分析エージェント

必要なツール:
  • データ処理ツール:データ変換のためのカスタムツール
  • レポート生成:レポートを生成するワークフロー
  • データエクスポート:結果をエクスポートするツール

コンテンツ作成エージェント

必要なツール:
  • コンテンツ生成:コンテンツ作成のためのカスタムツール
  • 画像生成:画像を作成するツール
  • 公開ワークフロー:コンテンツを公開するワークフロー

トラブルシューティング

ツールが表示されない

問題:ツールがセレクターに表示されない 解決策:
  • ツールが公開されているか確認(下書きは表示されない場合がある)
  • 正しいプロジェクトにいることを確認
  • ツールリストをリフレッシュ
  • ツールの権限を確認

ツールが実行されない

問題:エージェントがツールを使用しない 解決策:
  • ツールがエージェントに追加されていることを確認
  • ツール設定を確認
  • エージェントのシステムプロンプトを確認(ツールを言及する必要がある場合がある)
  • ツールを個別にテスト

ツール実行エラー

問題:ツールの実行に失敗する 解決策:
  • ツール入力が正しいことを確認
  • ツール設定を確認
  • ツール実行ログのエラーメッセージを確認
  • サンプル入力でツールをテスト

承認が機能しない

問題:承認が必要な場合にツールが承認なしで実行される 解決策:
  • ツール設定の承認設定を確認
  • エージェントに承認リクエストの権限があることを確認
  • ツールの承認設定を確認

関連ドキュメント