> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/agent-workspace/create-agent.md).

# Agent の作成とモデル分担

作成入口：左側ナビゲーション【仕事】→【エージェントを追加】。

新規作成ウィザードは【基本情報】、【システムプロンプト】、【スキル】、【ナレッジベース】の4ステップに分かれています。最初のステップでは実行モードの選択も必要です。実行モードによって、Agent が利用できるモデルの役割分担、権限モード、各種ツールが決まり、作成後は切り替えできません。

<figure><img src="https://raw.githubusercontent.com/SiinXu/cherry-studio-docs/2446b25878f69e98f33d50623a3c4cf5e836680a/.gitbook/assets/cherry-guide-agent-runtime-picker.png" alt="创建 Agent 时选择 Claude Agent、Pi 或 DeepSeek Harness 运行模式"><figcaption></figcaption></figure>

### 実行モードの選び方

| 実行モード              | 主な特徴                                      | モデル設定                     | 権限と制限                                             |
| ------------------ | ----------------------------------------- | ------------------------- | ------------------------------------------------- |
| 【強化版：Claude Agent】 | 機能が充実しており、複雑で多段階のタスクに適しています               | メインモデル、Plan モデル、Small モデル | すべての権限モードとハートビート検出をサポート                           |
| 【高速：Pi】            | 応答が速く、コストが低いため、日常的なファイル作業やコーディング作業に適しています | メインモデルのみ設定                | 【計画のみ】は提供されません。新規作成時の既定は【スマート承認】です                |
| 【DeepSeek Harness】 | 複数のモデルサービスと互換性があり、目標駆動の実行をサポートします         | メインモデルのみ設定                | 【スマート承認】とハートビート検出は提供されません；サポート `/compact`、`/goal` |

{% hint style="warning" %}
実行モードは作成後に変更できません。目標、モデルの互換性、または権限要件に根本的な変化がある場合は、既存の Agent を修正し続けるのではなく、新しい Agent を作成してください。
{% endhint %}

### 4ステップの入力方法

{% stepper %}
{% step %}

#### 1. 基本情報

名称は職務やタスクの種類に合わせて、「契約チェック」「コンテンツ企画」などとしてください。まず実行モードを選び、その後でページに表示される互換モデルを選択します。説明は用途の識別にのみ使います。メインモデルが主な推論と実行を担当します。
{% endstep %}

{% step %}

#### 2. システムプロンプトを作成

役割、目標、境界、出力方法を明確に書いてください。形容詞を並べるより、実行可能なルールを示すほうが効果的です。たとえば、まずリスクを列挙し、次に原文を引用し、最後に修正提案を出す；資料が不足している場合は明確に示し、推測しない、などです。
{% endstep %}

{% step %}

#### 3. スキルを選択

この Agent の長期的な作業方法に関係するスキルだけを選択してください。スキルは【設定】→【スキル】でインストールでき、後から Agent に検索とインストールを任せることもできます。
{% endstep %}

{% step %}

#### 4. ナレッジベースを紐付け

Agent が実際に検索する必要のあるナレッジベースだけを紐付けてください。ナレッジベース未紐付けの場合、その Agent のツール一覧にはナレッジベース検索と管理ツールは表示されません。
{% endstep %}
{% endstepper %}

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-90e09b4900c4d4ac6751921289d6b83d2945072b%2Fclipboard.png?alt=media" alt="Agent 编辑窗口中的主模型、Plan 模型和 Small 模型设置"><figcaption><p>まずメインモデルを選択してください。タスクに実際に計画分担や軽量処理が必要な場合のみ、Plan モデルと Small モデルを設定します。</p></figcaption></figure>

### 作成後に続けて設定

Agent 一覧でメニューを開き、編集を選ぶと、以下を調整できます：

* 【基本】：実行モードを確認し、そのモードがサポートするモデル、権限、ハートビート設定を調整する；
* 【プロンプト】：役割説明、処理ルール、行動の境界；
* 【内蔵ツール】：ファイル、検索、画像、通知、定期タスク、メモリ、子エージェント、ワークフローなど；
* 【ナレッジベース】：Agent がアクセスできるナレッジベースを制限する；
* 【MCP】：すでに接続済みの MCP サーバーを紐付ける；
* 【スキル】：インストール済みのスキルを選択する；
* 【詳細】：実際に必要なツールの環境変数を設定する。

{% hint style="info" %}
現在の編集ウィンドウは変更を自動保存します。ウィンドウを閉じる前に未保存の内容がある場合、アプリが先に保存を完了します。保存に失敗した場合、ウィンドウは開いたままでエラーが表示されます。
{% endhint %}

### 推奨の出発点

| 設定項目             | 製品のデフォルト値                       | 推奨開始値                         | 役割                     | 適用シーン                | 注意事項                                               |
| ---------------- | ------------------------------- | ----------------------------- | ---------------------- | -------------------- | -------------------------------------------------- |
| 実行モード            | 【強化版：Claude Agent】              | 迷ったらまず【強化版：Claude Agent】を使う   | モデルの役割分担、権限、ツール範囲を決定する | すべての Agent           | 作成後は切り替え不可                                         |
| メインモデル           | 作成時に選択したモデルを使用する                | ツールを安定して呼び出せることが確認されているモデルを選ぶ | 主な推論と実行                | すべての Agent           | セレクターは実行モードに応じて互換性のないモデルをフィルタリングする                 |
| Plan / Small モデル | メインモデルと同じ                       | まずはメインモデルと揃える                 | タスク分解、簡易判断、フォーマット整形    | 【強化版：Claude Agent】のみ | Pi と DeepSeek Harness ではこの2つの項目は表示されません            |
| 権限モード            | Claude/DSH は【逐次確認】；Pi は【スマート承認】 | 実際のプロジェクトディレクトリでは【逐次確認】を優先する  | ツールに承認が必要かどうかを決める      | ファイル、端末、ネットワーク作業     | 【フルアクセス】ではファイル削除やネットワークアクセスが発生する可能性があります           |
| ハートビート検出         | サポートされている実行モードでは初期状態で有効、間隔は30分  | 継続タスクがない場合はオフにできます            | Agent に定期的に作業を確認させる    | Claude Agent、Pi      | DeepSeek Harness はハートビート検出を提供しません；固定時間は定期タスクを使用します |

### ユーザー事例：契約チェック Agent

「契約チェック」Agent を作成し、メインモデルには検証済みのモデルを選択、プロンプトには「リスク条項、原文位置、影響、提案」の順で出力するよう指示し、会社の規程ナレッジベースを紐付け、権限は【逐次確認】のままにします。契約ごとに新しいタスクを作成し、対応するファイルディレクトリを選択して、異なる顧客資料が同じコンテキストに混在しないようにします。

<details>

<summary>なぜ作成時に MCP と権限の詳細設定が表示されなかったのですか？</summary>

作成ウィザードには一般的なステップのみが残されています。作成完了後に Agent の編集ウィンドウを開くと、【基本】【内蔵ツール】【ナレッジベース】【MCP】【スキル】【詳細】で引き続き設定できます。具体的なタブは実行モードの機能に応じて変わります。

</details>


---

# 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.cherryai.com.cn/docs/jp/advanced-basic/agent-workspace/create-agent.md?ask=<question>&goal=<endgoal>
```

`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.