ツール

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

概要

ツールにより以下が可能になります：

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

ツール 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. 入力を文書化：各入力の機能を明確に文書化

ユースケース

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

必要なツール：

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

データ分析エージェント

必要なツール：

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

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

必要なツール：

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

トラブルシューティング

ツールが表示されない

問題：ツールがセレクターに表示されない

解決策：

• ツールが公開されているか確認（下書きは表示されない場合がある）
• 正しいプロジェクトにいることを確認
• ツールリストをリフレッシュ
• ツールの権限を確認

ツールが実行されない

問題：エージェントがツールを使用しない

解決策：

• ツールがエージェントに追加されていることを確認
• ツール設定を確認
• エージェントのシステムプロンプトを確認（ツールを言及する必要がある場合がある）
• ツールを個別にテスト

ツール実行エラー

問題：ツールの実行に失敗する

解決策：

• ツール入力が正しいことを確認
• ツール設定を確認
• ツール実行ログのエラーメッセージを確認
• サンプル入力でツールをテスト

承認が機能しない

問題：承認が必要な場合にツールが承認なしで実行される

解決策：

• ツール設定の承認設定を確認
• エージェントに承認リクエストの権限があることを確認
• ツールの承認設定を確認

関連ドキュメント

• ワークフロー - ワークフローの作成方法を学ぶ
• ツールキット - 事前構築された統合を理解する
• エージェントビルダー - 一般的なエージェント設定ガイド