概要
ツールにより以下が可能になります:- カスタムツールを追加:プロジェクトで作成したカスタムツールを添付
- ワークフローを追加:マルチステッププロセスを実行するワークフロー/アクションを含める
- 新しいツールを作成:エージェントビルダーから直接新しいカスタムツールを構築
- ツール設定を管理:エージェントがツールを使用する方法を設定
- ツールライブラリを閲覧:パブリックライブラリから数千の事前構築ツールにアクセス
ツール vs. ツールキット
違いを理解することで、適切なアプローチを選択できます:| 機能 | ツール | ツールキット |
|---|---|---|
| タイプ | カスタムツールとワークフロー | 事前構築された統合 |
| 作成 | ユーザー作成またはライブラリから | EKBが事前設定 |
| スコープ | プロジェクト固有またはパブリック | プラットフォーム全体の統合 |
| 設定 | 完全なカスタマイズ | オプション付きの事前設定 |
| 例 | カスタムAPI呼び出し、ワークフロー、ビジネスロジック | Gmail、Slack、Google Driveなど |
- カスタムビジネスロジックが必要
- 再利用可能なワークフローを作成したい
- カスタムAPIと統合する必要がある
- 複数の操作を1つのツールにまとめたい
- 標準的な統合が必要(Gmail、Slackなど)
- 事前設定された認証が必要
- 共通の操作が必要(メール送信、タスク作成など)
ツールタブへのアクセス
-
エージェントビルダーを開く
- サイドバーのエージェントに移動
- 既存のエージェントの編集またはエージェントを作成をクリック
- エージェントビルダーが開きます
-
ツールタブに移動
- 左サイドバーでツールをクリック
- ツールタブが選択済みツールと追加オプションを含めて表示されます
エージェントにツールを追加
既存のカスタムツールを追加
-
ツールセレクターを開く
- ツールタブの**+ ツールを追加**ボタンをクリック
- ツールセレクターモーダルが開きます
-
利用可能なツールを閲覧
- カスタムツール:プロジェクトで作成したツール
- パブリックツール:パブリックライブラリのツール(9,000以上利用可能)
- ワークフロー:プロジェクトの既存ワークフロー
-
検索とフィルタ
- 検索バーを使用して特定のツールを見つける
- カテゴリまたはタイプでフィルタ
- 人気順または最近の追加で閲覧
-
ツールを選択
- ツールをクリックして詳細を表示
- ツールの説明と入力を確認
- 追加をクリックしてエージェントに添付
新しいカスタムツールを作成
-
ツールセレクターから
- ツールタブの**+ ツールを追加**をクリック
- モーダルのカスタムツールを作成をクリック
- ツールビルダーにリダイレクトされます
-
空の状態から
- ツールがない場合、最初のツールを作成をクリック
- 新しいツールのツールビルダーが開きます
-
ツールを設定
- 名前:ツールに説明的な名前を付ける
- 説明:ツールの機能を説明
- 入力:入力パラメータを定義
- ステップ:ツールの実行ステップを設定
- 保存:下書きとして保存するか、公開
-
エージェントに戻る
- 作成後、ツールがプロジェクトで利用可能になります
- エージェントビルダーに戻り、ツールセレクターで追加
ワークフローを追加
-
ツールセレクターを開く
- ツールタブの**+ ツールを追加**をクリック
- モーダルのワークフローを作成をクリック
-
ワークフロートリガーを選択
- トリガータイプを選択:
- フォーム入力:ユーザーがフォームに入力
- ファイルアップロード:ユーザーがファイルをアップロード
- 手動:オンデマンドで実行
- トリガータイプを選択:
-
ワークフローを設定
- ワークフローステップを設定
- 入力と出力を定義
- トリガー設定を構成
-
エージェントに追加
- 作成後、ワークフローがツールリストに表示されます
- 必要に応じてエージェントが実行できます
ツールの管理
追加済みツールの表示
ツールタブには以下が表示されます:- サイドバー:エージェントに追加されたすべてのツールを表示
- カスタムツール
- ワークフロー
- プロジェクトのアクション
- メインエリア:ツールの詳細と管理オプションを表示
ツールのステータス
ツールには異なるステータスがあります:- アクティブ:ツールの使用準備完了
- 下書き:ツールが編集中(まだ公開されていない)
- 公開済み:ツールが公開され、利用可能
ツールの設定
-
ツール設定を編集
- 追加済みツールの設定をクリック
- ツール固有の設定を調整
- 必要に応じて承認要件を設定
-
ツール承認設定
- 自動実行:トリガーされるとツールが自動的に実行
- 承認を要求:エージェントが実行前に確認を求める
-
入力のデフォルト値
- ツール入力のデフォルト値を設定
- 必須とオプションの入力を構成
ツールの削除
-
エージェントから削除
- サイドバーのツールのXボタンをクリック
- またはツール詳細の削除をクリック
- 削除を確認
-
カスタムツールを削除
- カスタムツールの場合、完全に削除可能
- カスタムツールの3点メニューをクリック
- 削除を選択
- 注意:これによりプロジェクトからツールが完全に削除されます
ツールのタイプ
カスタムツール
カスタムツールは以下を作成したツールです:- カスタムロジック:独自のビジネスルールとプロセス
- API統合:独自のAPIに接続
- マルチステップ操作:複数のアクションを組み合わせ
- データ処理:データの変換と操作
- 入力を定義(ツールが受け付けるパラメータ)
- ステップを設定(ツールが実行する内容)
- エラー処理を設定
- ツールをテスト
- 準備ができたら公開
ワークフロー
ワークフローは以下のマルチステッププロセスです:- シーケンスを実行:複数の操作を順番に実行
- トリガーを処理:フォーム入力やファイルアップロードに応答
- データを処理:複数のステップを経てデータを変換
- サービスを統合:複数のサービスを接続
- フォーム入力:ユーザーがフォームで入力を提供
- ファイルアップロード:ユーザーが処理のためにファイルをアップロード
- 手動:エージェントによるオンデマンド実行
パブリックツール
パブリックツールライブラリには以下が含まれます:- 9,000以上のツール:コミュニティによる事前構築ツール
- ** various カテゴリ**:コミュニケーション、生産性、データなど
- すぐに使用可能:クローンしてニーズに合わせてカスタマイズ
- 定期的に更新:新しいツールが頻繁に追加
- パブリックライブラリを閲覧
- ニーズに合ったツールを見つける
- プロジェクトにクローン
- 必要に応じてカスタマイズ
- エージェントに追加
ベストプラクティス
ツールの整理
- 明確に命名:ツールの目的を説明する説明的な名前を使用
- 適切に文書化:各ツールに明確な説明を追加
- 関連ツールをグループ化:機能またはカテゴリ別にツールを整理
- バージョン管理:公開前にテストのために下書きを使用
ツール選択
- シンプルに始める:基本的なツールから始め、徐々に複雑さを追加
- 徹底的にテスト:本番エージェントに追加前にツールをテスト
- パフォーマンスを考慮:ツールが多すぎるとエージェントの応答が遅くなる
- 定期的に見直し:未使用のツールを削除してエージェントを効率的に維持
ツール設定
- 適切なデフォルト値を設定:適切なデフォルト値を構成
- 必要に応じて承認を使用:機密性の高い操作に承認を要求
- エラーを処理:ツールに適切なエラー処理があることを確認
- 入力を文書化:各入力の機能を明確に文書化
ユースケース
カスタマーサポートエージェント
必要なツール:- チケット作成ツール:サポートチケットを作成するカスタムツール
- ナレッジベース検索:ドキュメントを検索するツール
- イシューエスカレート:人間のエージェントにエスカレートするワークフロー
データ分析エージェント
必要なツール:- データ処理ツール:データ変換のためのカスタムツール
- レポート生成:レポートを生成するワークフロー
- データエクスポート:結果をエクスポートするツール
コンテンツ作成エージェント
必要なツール:- コンテンツ生成:コンテンツ作成のためのカスタムツール
- 画像生成:画像を作成するツール
- 公開ワークフロー:コンテンツを公開するワークフロー
トラブルシューティング
ツールが表示されない
問題:ツールがセレクターに表示されない 解決策:- ツールが公開されているか確認(下書きは表示されない場合がある)
- 正しいプロジェクトにいることを確認
- ツールリストをリフレッシュ
- ツールの権限を確認
ツールが実行されない
問題:エージェントがツールを使用しない 解決策:- ツールがエージェントに追加されていることを確認
- ツール設定を確認
- エージェントのシステムプロンプトを確認(ツールを言及する必要がある場合がある)
- ツールを個別にテスト
ツール実行エラー
問題:ツールの実行に失敗する 解決策:- ツール入力が正しいことを確認
- ツール設定を確認
- ツール実行ログのエラーメッセージを確認
- サンプル入力でツールをテスト
承認が機能しない
問題:承認が必要な場合にツールが承認なしで実行される 解決策:- ツール設定の承認設定を確認
- エージェントに承認リクエストの権限があることを確認
- ツールの承認設定を確認
関連ドキュメント
- ワークフロー - ワークフローの作成方法を学ぶ
- ツールキット - 事前構築された統合を理解する
- エージェントビルダー - 一般的なエージェント設定ガイド