> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/skills.md).
# スキル
スキル：複数ステップの SOP を定義し、Agent がフローに沿って対話を導きます
## これは何ですか？
スキルとは、Agent の複数ステップから成る推論フローです。自然言語で一連の SOP を定義しておくと、Agent は対話中に関連する状況に出会ったときに、このフローに沿って一つずつ処理を進めます。
ツールが Agent の「単一の能力」だとすれば、スキルは「複数の能力をつなぎ合わせて一つの完結した処理フローにしたもの」です。
## 例で説明します
たとえば、Agent に「顧客への見積もり」を処理させたいとします。
**スキルがない場合**：Agent はあちこちで断片的に答えてしまい、重要な情報を漏らすことがあります。
**スキルがある場合**：見積もりの SOP を次のように定義しておきます——
```
1. まず顧客が必要とする製品の型番を確認する
2. 製品の価格表を照会する（ツールを使用）
3. 顧客の数量ニーズを確認する
4. 数量に応じて割引ルールを適用する
5. 見積書の概要を生成する
6. 顧客に調整が必要かどうかを尋ねる
```
Agent はこのフローに沿って対話を導き、各ステップを漏らさないようにします。
## スキルの中で何が使えますか？
スキルの中では、Agent にすでにマウントされているツールやナレッジベースを参照できます。これにより、フローの途中でデータの照会やアクションの実行が必要になったときに、自動で完了させられます。
| 組み合わせ | 説明 |
| ------------ | ----------------------------------- |
| **ツール** | スキルのフロー中で外部サービスを呼び出す必要があるときに使用します |
| **ナレッジベース** | スキルのフロー中で参考資料を検索する必要があるときに使用します |
| **リソースファイル** | スキルに参考ドキュメントを添付でき、Agent は実行時に参照できます |
## どんなときにスキルが適していますか？
* **固定された SOP のあるフロー**：見積もり、クレーム対応、問題の切り分け
* **複数回にわたる情報収集が必要な場合**：予約フロー（日付、時間、人数を尋ねる必要があります）
* **条件分岐が必要な場合**：状況に応じて異なる処理ルートに進みます
* **ステップの抜け漏れを防ぎたい場合**：フォーム入力の案内、審査フロー
## どんなときにスキルが不要ですか？
* シンプルな一問一答（ナレッジベースで十分です）
* 一つのデータを照会する、または一つのアクションを実行するだけの場合（ツールで事足ります）
> **応用的な説明**：スキルの定義方法は、フローチャートやコードではなく、純粋なテキストのプロンプト（Prompt）です。つまり、自然言語で一連のフロー全体を記述すれば、Agent がそれを理解して実行します。スキルは、補助的な参考としてリソースファイルのアップロードにも対応しています。
## 私は何をすればよいですか？
1. **スキルを作成する** — 手動で記述するか、スキル定義ファイルをアップロードします
2. **フローを記述する** — 自然言語で完全な処理ステップを書き出します
3. **リソースをマウントする** — 必要に応じて、参考ドキュメントやツールを添付します
4. **Agent にマウントする** — Agent の設定でこのスキルを有効にします
5. **テストする** — 利用者との対話をシミュレーションし、フローがスムーズかどうかを確認します
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/skills.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.