> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentify.jp/llms.txt
> Use this file to discover all available pages before exploring further.
# 🛠️ ツール
左側のナビゲーションパネルにある「ツール」メニューをクリックすると、以下のような**統合ツールライブラリ**が表示されます。
ユーザー自身が作成した独自のツール
システムが提供するプリセット済みのツールセット
この画面では、**自分で開発したツール**や**利用権限を持つ外部ツール**など、アカウントに関連付けられたすべてのツールが一括して表示されます。
## 公式ツール
公式ツールは、よく使われる業務処理をすぐに利用できるように用意されたプリセットツールです。
Web サイトから必要な情報を定期的に取得し、Agent やナレッジベースと連携できます。
複数の文書が指定条件を満たしているかを確認し、レビュー業務を支援します。
## 🔌 ツールモジュール
利用したいツールは、**キャンバス（画面上のフロー設計画面）にドラッグ＆ドロップ**することで簡単に組み込むことができます。
## カスタムツールの作成
左側のナビゲーションバーで「**ツール**」をクリックし、「**カスタムツール**」を選択します。
現在、作成方法は「**手動入力**」と「**クイックインポート**」の2種類があります。
特に**APIドキュメントやURLがある場合は「クイックインポート」がおすすめ**です。よりスピーディかつ簡単にツールを作成できます。
### インポート方法
APIドキュメントファイルから自動的にツール設定を読み込みます
APIドキュメントのURLを指定して設定を取得します
APIドキュメントのテキストを直接貼り付けて設定します
インポート内容が不完全な場合、**必須項目は手動で補完する必要があります。**
カスタムツールでは、以下5種類のHTTPリクエスト方式をサポートしています。
**定義:** サーバー上の特定リソースへのアクセスを要求するために使用されます。主に情報の取得・検索に用いられ、サーバーの状態を変更しません。
**使用シーン:** ユーザー一覧の取得、記事詳細の表示など
**例:** 商品価格の取得：`GET https://api.example.com/products/123`
**定義:** サーバーにデータを送信して新しいリソースを作成したり、データ処理を行うために使用されます。
**使用シーン:** 新規ユーザー登録、フォーム送信、ファイルアップロードなど
**例:** 新規ユーザーの作成：`POST https://api.example.com/users`
**定義:** 既存リソースを完全に置換または新規作成する際に使用されます。送信するデータはリソースの全情報が必要です。
**使用シーン:** ユーザー情報の更新、ファイルの置き換えなど
**例:** ユーザープロフィールの更新：`PUT https://api.example.com/users/456`
**定義:** 指定されたリソースを削除するために使用されます。べきとう性を持ち、複数回実行しても結果は変わりません。
**使用シーン:** ファイル削除、ユーザーアカウント削除など
**例:** ブログ記事の削除：`DELETE https://api.example.com/blogs/789`
**定義:** リソースの一部のみを更新する場合に使用されます。PUT よりも柔軟性が高く、変更したい項目だけ送信すればよいのが特徴です。
**使用シーン:** 記事タイトルの変更、ユーザー設定の一部更新など
**例:** 記事タイトルの変更：`PATCH https://api.example.com/articles/1010`
使用するリクエスト方式は、各APIの仕様書（インターフェース定義）を参考に正しく選んでください。
Webリクエストにおいて、認証はリクエスト元の正当性を検証する手段です。以下の方式に対応しています。
**定義:** ユーザー名とパスワードを使った基本的な認証方式です。
**操作方法:** ユーザー名とパスワードを「:」（コロン）で連結し、**Base64でエンコード**します。
**例:**
```http theme={null}
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
```
**定義:** 事前に取得したアクセストークンを `Authorization` ヘッダーに設定して認証する方式です。
現時点では、プラットフォームは OAuth 2.0 の認可フローに対応していません。OAuth 2.0 が必要な外部 API を利用する場合は、外部側で取得済みのアクセストークンを Bearer Token として設定してください。
**例:**
```http theme={null}
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
```
**定義:** 任意のリクエストヘッダーを使用して、開発者が独自に定義した認証方式です。
**操作方法:** リクエストヘッダーに任意のキーと値を追加します。
**例:**
```http theme={null}
X-Custom-Auth: my-custom-value
```
用途に応じて、適切な認証方式を選択してください。
### 対応データ型
現在サポートされているパラメータのデータ型は、**string（文字列）**、**boolean（真偽値）**、**any（任意型）** の3種類です。
テキストデータを扱う型
true/falseの2値を扱う型
任意のデータ型を受け入れる型
入力または出力のパラメータで明確な型が判別できない場合は、**デフォルトで string 型**として扱われます。
### パラメータの送信方法
フォームデータとしてリクエストボディを送信します。
一般的に `application/x-www-form-urlencoded` または `multipart/form-data` の形式で使用され、主にフォーム送信に用いられます。
JSON、XML、プレーンテキストなどの生データをそのままリクエストボディに含めて送信します。
この場合、`Content-Type` は通常 `application/json` または `text/plain` が使われます。
ツールを保存した後は、**デバッグと検証** に進みます。
対応する入力項目を入力し、APIリクエストを送信して動作確認を行います。
**公開（リリース）可能**
**保存は可能だが、公開は不可**
## ツールの公開と管理
保存およびデバッグが完了すると、作成したツールが一覧に表示されます。
### ツール一覧での操作
ツールの設定を変更します
ツールを削除します
ツールを公開します
下書き状態に戻します
### 重要な注意点
**デバッグに成功したツールのみ公開可能**です。
**公開されたツール**は、ワークフロー（フロー設計）画面で**ドラッグ＆ドロップして使用可能**になります。
ツールが**非公開状態**になると、サイドバーには表示されなくなりますが、**過去に使用されたエージェントには影響しません**。