組み込み Agent
Elftia は、さまざまなシナリオに対応する事前設定済み Agent を集めた Agent ギャラリーを提供しています。これらの Agent はそのまま使用することも、それをもとにカスタマイズ版を作成することもできます。
Agent ギャラリー
Agent ギャラリーでは、プリセット Agent がユースケース別のカテゴリに整理されているため、目的に合うものをすばやく見つけられます。
Agent の閲覧
- サイドバーの Agent アイコンをクリックして Agent パネルを開く
- 上部に ギャラリー / マイ Agent の切り替えタブが表示される
- 「ギャラリー」タブを選択して、すべてのプリセット Agent を閲覧する
- 検索ボックスまたはカテゴリフィルターを使って、目的の Agent をすばやく見つける
Agent カテゴリ
| カテゴリ | 説明 | 含まれる Agent の種類 |
|---|---|---|
| Work | 仕事 | プロジェクト管理、タスク分解、会議メモ、週次レポート |
| Business | ビジネス | ビジネス分析、市場調査、企画提案 |
| Tools | ツール | ファイル処理、データ変換、自動化スクリプト |
| Language | 言語 | 翻訳、校正、文法チェック、多言語対応 |
| Office | オフィス | 文書作成、スプレッドシート処理、プレゼンテーション |
| Creative | クリエイティブ | コピーライティング、ストーリー執筆、ブレインストーミング |
| Coding | コーディング | コード生成、コードレビュー、バグ修正、テスト |
| Education | 教育 | ナレッジ Q&A、個別指導、学習計画 |
Agent の選択と使用
- ギャラリーで Agent カードをクリックする
- Agent の詳細を確認する:
- 説明 — Agent の機能と適用シナリオ
- ツール一覧 — Agent が使用できるツール
- 権限モード — ツール実行のセキュリティレベル
- モデル — Agent が使用する LLM モデル
- 「使用する」をクリックして会話を開始する
- 「お気に入り」をクリックして、Agent をクイックアクセスリストに追加することもできる
お気に入りと評価
- お気に入り — Agent カードのスターアイコンをクリックする。お気に入りにした Agent は「マイ Agent」リストの先頭に表示される
- 評価 — Agent を使用した後、評価を付けることで、他のユーザーが質の高い Agent を見つけやすくなる
Agent 設定フォーマット
各 Agent は本質的には Markdown ファイルであり、YAML フロントマターで設定パラメーターを定義し、本文がシステムプロンプトとして機能します。
ファイル構造
---
name: Code Review Assistant
description: Review code quality, identify potential issues, and suggest improvements
model: main
permissionMode: default
tools:
- Read
- Glob
- Grep
- ListDir
skills:
- code-standards
---
You are a professional code review assistant.
## Review Focus
1. Code quality and readability
2. Potential bugs and performance issues
3. Security vulnerabilities
4. Adherence to best practices
## Output Format
For each issue found, provide:
- Issue description
- Severity (High / Medium / Low)
- Suggested fix
設定フィールドリファレンス
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | はい | Agent 名 |
description | string | はい | Agent の説明（ギャラリーカードに表示） |
model | string | いいえ | モデル選択（エイリアスをサポート、デフォルト: main） |
permissionMode | string | いいえ | 権限モード（デフォルト: default） |
tools | string[] | いいえ | 許可するツール一覧（空の場合はすべてを継承） |
skills | string[] | いいえ | 自動ロードする Skill の名前一覧 |
モデルエイリアス
Agent 設定の model フィールドは以下のエイリアスをサポートしており、設定を特定のモデルに縛られないようにできます:
| エイリアス | 意味 | 説明 |
|---|---|---|
main | メインモデル | 現在のセッション設定のメインモデルを使用（デフォルト） |
inherit | 継承モデル | main と同じ。親 Agent のモデルを継承 |
background | バックグラウンドモデル | ユーザーが設定したバックグラウンドモデルを使用（軽量） |
sonnet | Sonnet ファミリー | 親モデルを Sonnet ファミリーに切り替える（Anthropic のみ） |
opus | Opus ファミリー | 親モデルを Opus ファミリーに切り替える（Anthropic のみ） |
haiku | Haiku ファミリー | 親モデルを Haiku ファミリーに切り替える（Anthropic のみ） |
:::tip セマンティックエイリアスを使用する
main、inherit、background などのセマンティックエイリアスを使用することをおすすめします。これらは特定のプロバイダーに縛られません。sonnet、opus、haiku は Anthropic モデルを使用している場合にのみ有効です。
:::
権限モード
| モード | 説明 |
|---|---|
default | センシティブなツール（Bash、Write、Edit）はユーザーの確認が必要 |
acceptEdits | ファイル編集は自動的に承認される。Shell と MCP ツールは引き続き確認が必要 |
bypassPermissions | すべてのツールが確認なしで自動実行される |
plan | 読み取り専用モード。Read、ListDir、Glob、Grep などの読み取り専用ツールのみ許可される |
Agent の保存場所
Agent 設定ファイルは以下の場所に配置できます:
| 場所 | パス | スコープ |
|---|---|---|
| プロジェクトレベル | .claude/agents/*.md | 現在のプロジェクトでのみ使用可能 |
| 個人レベル | ~/.claude/agents/*.md | すべてのプロジェクトで使用可能 |
| 組み込み | アプリにバンドル | すべてのユーザーが使用可能 |
ロード優先順位: プロジェクトレベル > 個人レベル > 組み込み。同じ Agent 名が複数の場所に存在する場合、プロジェクトレベルのバージョンが優先されます。
FAQ
| 問題 | 原因 | 解決策 |
|---|---|---|
| Agent がギャラリーに表示されない | Agent 設定ファイルが正しいパスにない | ファイルが .claude/agents/ ディレクトリにあることを確認する |
| Agent が特定のツールを使用できない | そのツールが tools フィールドに列挙されていない | フロントマターにツール名を追加する |
| モデルエイリアスが有効にならない | Anthropic のみがサポートするエイリアスを使用している | main または background のセマンティックエイリアスに切り替える |
| カスタム Agent が他のプロジェクトで表示されない | プロジェクトレベルのディレクトリに保存されている | ~/.claude/agents/（個人レベル）に移動する |
関連リンク
- Agent 概要 — Agent システムの概要
- カスタム Agent の作成 — Agent をゼロから作成する
- ツール権限とセキュリティ — 権限モードの詳細
- Skill システム — Agent に Skill を設定する