> ## 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.
# カスタムツールの作成
## カスタムツール作成の流れ
左側のナビゲーションバーで「**ツール**」をクリックし、「**カスタムツール**」を選択します。
現在、作成方法は「**手動入力**」と「**クイックインポート**」の2種類があります。
特に**APIドキュメントやURLがある場合は「クイックインポート」がおすすめ**です。よりスピーディかつ簡単にツールを作成できます。
### インポート方法
APIドキュメントファイルから自動的にツール設定を読み込みます
APIドキュメントのURLを指定して設定を取得します
APIドキュメントのテキストを直接貼り付けて設定します
**インポート例：外部の携帯番号所属エリア確認API**
API URL: [https://api.oioweb.cn/doc/common/teladress](https://api.oioweb.cn/doc/common/teladress)
インポート内容が不完全な場合、**必須項目は手動で補完する必要があります。**
カスタムツールでは、以下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リクエストを送信して動作確認を行います。
**公開（リリース）可能**
**保存は可能だが、公開は不可**
## ツールの公開と管理
保存およびデバッグが完了すると、作成したツールが一覧に表示されます。
### ツール一覧での操作
ツールの設定を変更します
ツールを削除します
ツールを公開します
下書き状態に戻します
### 重要な注意点
**デバッグに成功したツールのみ公開可能**です。
**公開されたツール**は、「プラニング」画面で**ドラッグ＆ドロップして使用可能**になります。
ツールが「非公開」状態になると、サイドバーには表示されなくなりますが、**過去に使用されたエージェントには影響しません**。