> 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.md).

# Agent ワークスペース

Agent は、明確な目標があり、ツールやファイルを使う必要があり、複数ステップにわたる可能性のあるタスクの処理に向いています。入口は左側ナビゲーションの【作業】で、旧版チュートリアルの上部タブではありません。

{% hint style="success" %}
いちばん手間の少ない設定方法は、まず Agent にやりたいことを伝え、そのうえで不足しているモデル、ツール、ナレッジベース、またはチャンネルを確認させることです。より厳密に制御したい場合は、Agent の編集ウィンドウまたは【設定】を開いて手動で調整します。
{% endhint %}

<figure><img src="/files/c067282a39e13b7507f895e713201e6a0f1b599e" alt="Agent 工作区中的 Agent、模型、工作目录和右侧面板"><figcaption></figcaption></figure>

<figure><img src="/files/374d31ca948ea4a9ed8231939473215db13112a2" alt="Agent 从说明交付物、选择工作目录到检查文件和结果的任务闭环图"><figcaption></figcaption></figure>

### ワークスペースは何で構成されるか

| 項目       | 役割                             | いつ注意が必要か                           |
| -------- | ------------------------------ | ---------------------------------- |
| Agent    | 役割、モデル、プロンプト、能力を保存する           | 同じ種類の作業を繰り返すとき                     |
| タスク      | 一連の作業記録                        | 各目標ごとに個別にタスクを作成し、コンテキストを保持しやすくする   |
| 作業ディレクトリ | Agent が直接扱えるファイル範囲             | コード、資料整理、ドキュメント生成などのファイル作業         |
| 入力欄      | 目標を送信し、添付ファイルを追加してツールを呼び出す     | タスクを開始するか、要求を追加する                  |
| 右側パネル    | ステータス、ファイル、サブタスク、メッセージの流れを確認する | 長いタスクを追跡し、成果物を確認し、またはトラブルシューティングする |

### タスクを開始する

{% stepper %}
{% step %}

#### 1. 【作業】を開いて Agent を選択する

適切な Agent がすでにある場合はそのまま選択します。ない場合は【エージェントを追加】をクリックし、【基本情報】でまず実行モードを選択してから、システムプロンプト、スキル、ナレッジベースの4つの手順で作成します。実行モードは作成後に切り替えできません。
{% endstep %}

{% step %}

#### 2. 作業ディレクトリを選択する

ローカルファイルを処理する必要がある場合は、今回のタスクのディレクトリを選択します。ファイルを扱わない場合は、アプリが作成した既定のワークスペースを使用できます。1つのタスクに1つのワークスペースを対応させることで、Agent が関係のないディレクトリを行き来して探し回るのを防げます。
{% endstep %}

{% step %}

#### 3. 結果でタスクを説明する

Agent に何を納品するか、どの資料を使えるか、どんな制約があるか、どうなれば完了かを伝えます。たとえば：

```
現在のディレクトリ内の会議記録を読み、決定事項、担当者、期限を整理して、action-items.md を生成してください。元のファイルは変更しないでください。
```

{% endstep %}

{% step %}

#### 4. 右側パネルで進行状況と成果物を確認する

【ステータス】にはアクティブなタスク、サブエージェント、ワークフロー、バックグラウンドコマンドが表示されます。【ファイル】ではテキスト成果物をプレビューして編集できます。開発者モードを有効にすると【呼び出しチェーン】も確認できます。
{% endstep %}
{% endstepper %}

### APIゲートウェイの注意

Agent の実行は Cherry Studio の APIゲートウェイに依存します。ゲートウェイが有効でない場合、アプリは【有効化して起動】を促します。あるいは【設定】→【APIゲートウェイ】でポート、実行状態、ローカルのセキュリティソフトによるブロックを確認できます。

{% hint style="warning" %}
APIゲートウェイは Agent の実行依存ですが、インターフェースをネットワークに公開することを意味するわけではありません。既定のローカル利用のままで十分です。他のプログラムから呼び出したい場合にのみ、URL と API キーをコピーする必要があります。
{% endhint %}

### 1つの Agent か、複数の Agent か

* 同じ役割、同じ能力セットだがタスクが異なる場合: 1つの Agent を再利用し、複数のタスクを新規作成します。
* 役割、資料範囲、または権限が異なる場合: 複数の Agent に分けます。
* 1つの目標で並行して調査したり、複数ステップで協力したりする必要がある場合: まず1つの Agent にサブエージェントまたはワークフローを使わせ、すぐに手動で多くの Agent を作成する必要はありません。

### ユーザー事例: プロジェクト資料の整理

プロダクトマネージャーは、要件説明、インタビュー記録、競合製品の資料を同じディレクトリに置き、「要件整理」Agent を作成し、製品ナレッジベースを紐づけて【逐次確認】権限を使用します。Agent はまず資料を読み取り、その後、要件一覧と確認待ちの質問を新しいファイルに書き出します。プロダクトマネージャーは右側の【ファイル】で直接文章を修正し、元の資料は変更されません。

<details>

<summary>なぜ Agent に、さっき紐づけた能力が見えないのですか？</summary>

Agent の編集内容は自動で保存されます。生成中の返信は中断されません。モデル、スキル、MCP、ナレッジベースなどの変更は次のメッセージから有効になります。それでも表示されない場合は、まず能力が有効になっているか確認し、続けて新しいメッセージを送ってください。

</details>

<details>

<summary>作業ディレクトリを削除すると、ディスク上のファイルも一緒に削除されますか？</summary>

タスクリストで作業ディレクトリを削除した場合、Cherry Studio 内のディレクトリ記録と、そのディレクトリ配下のタスク記録のみが削除され、ディスク上の実際のディレクトリは削除されません。Agent がタスク実行中に行うファイル操作は、選択した権限モードの影響を受け続けます。

</details>

<details>

<summary>作業ディレクトリを削除すると、ディスク上のファイルも一緒に削除されますか？</summary>

タスクリストで作業ディレクトリを削除した場合、Cherry Studio 内のディレクトリ記録と、そのディレクトリ配下のタスク記録のみが削除され、ディスク上の実際のディレクトリは削除されません。Agent がタスク実行中に行うファイル操作は、選択した権限モードの影響を受け続けます。

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