> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ツール

> エージェントにカスタムツールとワークフローを追加する

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

## 概要

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

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

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

## ユースケース

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

**必要なツール：**

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

### データ分析エージェント

**必要なツール：**

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

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

**必要なツール：**

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

## トラブルシューティング

### ツールが表示されない

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

**解決策：**

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

### ツールが実行されない

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

**解決策：**

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

### ツール実行エラー

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

**解決策：**

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

### 承認が機能しない

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

**解決策：**

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

## 関連ドキュメント

* [ワークフロー](/tools/workflows-v2) - ワークフローの作成方法を学ぶ
* [ツールキット](/agents/toolkits/overview) - 事前構築された統合を理解する
* [エージェントビルダー](/agents/agents) - 一般的なエージェント設定ガイド