> 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 %}
## タスクを開始する
{% 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 はまず資料を読み込み、その後、要件リストと確認待ちの質問を新しいファイルに書き出します。プロダクトマネージャーは右側の【ファイル】で直接テキストを修正し、元の資料は変更しません。
なぜ Agent は、さっき紐づけた能力を見られないのですか？
Agent の編集内容は自動保存されます。生成中の返信は中断されません。モデル、スキル、MCP、ナレッジベースなどの変更は次のメッセージから有効になります。まだ表示されない場合は、まず能力が有効になっているか確認し、そのうえで新しいメッセージを送ってください。
作業ディレクトリを削除すると、ディスク上のファイルも一緒に削除されますか？
タスクリストで作業ディレクトリを削除しても、Cherry Studio 内のディレクトリ記録とそのディレクトリ下のタスク記録が削除されるだけで、ディスク上の実際のディレクトリは削除されません。Agent がタスク実行中に行うファイル操作は、選択した権限モードの影響を引き続き受けます。
---
# 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=&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.