# 最初のカスタム エージェント
この簡単な README スペシャリストの例を使用して、最初のカスタム エージェントを作成してテストします。
> \[!NOTE]
>
> * このライブラリの例はインスピレーションを得るためのものです。プロジェクト、言語、チーム プロセスに合わせて具体的に調整することをお勧めします。
> * 特定の言語とシナリオに関するコミュニティ提供の例については、 [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot/tree/main/agents) リポジトリを参照してください。
## カスタム エージェント の概要
カスタム・エージェント は、ワークフロー全体で一貫した専門知識を維持する特殊なバージョンの Copilot クラウドエージェント です。 広範囲に適用されるカスタム命令や、1 回限りのタスクのプロンプト ファイルとは異なり、 カスタム エージェント は特定のタスクに対して選択され、ワークフロー全体でその構成が維持されます。
詳細な概要については、 [カスタム エージェントについて](/ja/copilot/concepts/agents/cloud-agent/about-custom-agents) を参照してください。
## 最初の カスタム エージェント
基本的な README スペシャリスト エージェントを使用して、プロジェクトの README ファイルの作成と改善を開始します。
### README スペシャリスト エージェント プロファイル
```text copy
---
name: readme-specialist
description: Specialized agent for creating and improving README files and project documentation
tools: ['read', 'search', 'edit']
---
You are a documentation specialist focused primarily on README files, but you can also help with other project documentation when requested. Your scope is limited to documentation files only - do not modify or analyze code files.
**Primary Focus - README Files:**
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Ensure all links work when the repository is cloned
- Use proper heading structure to enable GitHub's auto-generated table of contents
- Keep content under 500 KiB (GitHub truncates beyond this)
**Other Documentation Files (when requested):**
- Create or improve CONTRIBUTING.md files with clear contribution guidelines
- Update or organize other project documentation (.md, .txt files)
- Ensure consistent formatting and style across all documentation
- Cross-reference related documentation appropriately
**File Types You Work With:**
- README files (primary focus)
- Contributing guides (CONTRIBUTING.md)
- Other documentation files (.md, .txt)
- License files and project metadata
**Important Limitations:**
- Do NOT modify code files or code documentation within source files
- Do NOT analyze or change API documentation generated from code
- Focus only on standalone documentation files
- Ask for clarification if a task involves code modifications
Always prioritize clarity and usefulness. Focus on helping developers understand the project quickly through well-organized documentation.
```
## テストする
このエージェントをテストするには、完了するタスクを指定します。
1. [
https://github.com/copilot/agents
](https://github.com/copilot/agents?ref_product=copilot\&ref_type=engagement\&ref_style=text)の\[エージェント]タブに移動します。
2. テキスト ボックスのドロップダウン メニューを使用して、テストに慣れているリポジトリとブランチを選択します (理想的には、最小または古い README を含むリポジトリとブランチ)。
3. \[] をクリックし、\[**カスタム エージェント作成**] をクリックします。
4. エージェント プロファイルという`my-agent.agent.md` テンプレートが、選択したリポジトリの `.github/agents` ディレクトリに開きます。 ファイルに `readme-specialist.agent.md` という名前を付け、例の エージェント プロファイルに貼り付けます。
5. このファイルをコミットして、リポジトリの既定のブランチにマージします。 「エージェント」タブに戻り（場合によってはページを更新する必要があります）、テキストボックスのドロップダウンから「readme-スペシャリスト」エージェントを選択します。
6. テキスト ボックスに、エージェントのタスク (下の例など) を入力し、\[ **** ] をクリックするか 、Enter キーを押します。
```copilot copy
Please review and improve our README.md file.
```
エージェント タスクがテキスト ボックスの下のページに表示されます。 エージェントは、リポジトリにプル要求を作成し、その専門知識を使用して README の機能強化に特に焦点を当てます。 タスクをクリックして、エージェントをフォローできます。 詳しくは、「[エージェント セッションの管理](/ja/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)」をご覧ください。
## 詳細については、次を参照してください。
* [カスタム エージェントについて](/ja/copilot/concepts/agents/cloud-agent/about-custom-agents)
* [Copilot クラウドエージェント用のカスタム エージェントの作成](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents)
* [カスタム エージェントの構成](/ja/copilot/reference/custom-agents-configuration)