> 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/workspaces-tasks-files.md). # 作業ディレクトリ、タスクとファイル Agent の「記憶」と「ファイル」は同じものではありません。タスクは会話の過程を保存し、作業ディレクトリはこのタスクで直接扱えるファイルを保存し、Agent の記憶はタスクをまたいで安定した事実と経験を保持します。 ## どの作業ディレクトリを選ぶか 新しいタスクを開始するとき、作業ディレクトリのセレクターには既存のディレクトリ、【新しい作業ディレクトリを追加】、【作業ディレクトリを使わない】が表示されます。 | タスク種別 | 推奨される選択 | 理由 | | --------------------------- | --------------------- | -------------------------------- | | コードの修正、資料の整理、ドキュメントの生成 | このプロジェクトのみを含むディレクトリ | Agent がファイルを見つけやすく、アクセス範囲を制御しやすい | | 一時的なQ\&Aやローカルファイルが不要な場合 | 【作業ディレクトリを使わない】 | 不要なファイルがタスクに入り込むのを減らす | | 一時的な成果物が必要だが、既存のディレクトリがない場合 | アプリが作成した既定のワークスペースを使う | 成果物を個人ディレクトリと分ける | {% hint style="danger" %} 手間を省くためにデスクトップのルート、ユーザーのホームディレクトリ、あるいは大量の機密資料を含むディレクトリを選ばないでください。作業ディレクトリは Agent が操作できるファイルの範囲を決め、権限モードは操作に確認が必要かどうかを決めます。両方を一緒に確認してください。 {% endhint %}
Agent 工作区中的任务列表、工作目录和主操作区

開始前に現在の Agent、タスク、作業ディレクトリを先に確認し、ファイルを間違ったプロジェクトに書き込まないようにします。

## タスクの管理 * 【新しいタスク】をクリックして新しいコンテキストを開始する； * タスクは名前変更、固定、作業ディレクトリごとのグループ化ができます； * タスクを右クリックすると【新しいタブで開く】または【新しいウィンドウで開く】を選べます； * 1つの Agent には少なくとも1つのタスクが保持されます； * 作業ディレクトリの記録を削除すると、その下のタスク記録は削除されますが、ディスク上のディレクトリ自体は削除されません。 ## 右側パネルでファイルを処理する Agent がファイルを生成または変更したら、右側の【ファイル】を開いてワークスペースを閲覧できます。編集可能な UTF-8 テキストファイルは、プレビューと編集を切り替えられ、入力すると自動保存されるため、別途保存ボタンを押す必要はありません。 ディスク上のファイルが編集中に他のプログラムによって変更された場合、Cherry Studio は再読み込みを促します。再読み込みを選ぶと現在の下書きは破棄されます。下書きを保持する場合、自動保存は競合の処理が完了するまで一時停止します。 ## 成果物とタスクの状態 右側の【状態】には、Agent が宣言した成果物、サブエージェント、ワークフロー、バックグラウンドコマンド、コンテキスト使用量が集約されます。長いタスクの実行中は、ここでまず継続作業中か、権限待ちか、それともすでに失敗しているかを判断できます。
Agent 右侧状态面板中的产物、任务与后台执行信息

長いタスクはまず【状態】を見て、実行中、承認待ち、またはすでに失敗かを判断します。

## 何をもって完了とするか * タスクの上部に表示されるのは今回のプロジェクトディレクトリです； * 右側の【ファイル】で約束された納品ファイルを見つけられます； * 右側の【状態】に承認待ちまたは失敗のステップがありません； * 元資料が上書きされておらず、納品ファイルは個別に開けます。 ## ユーザーケース：インタビュー素材の整理 「インタビュー整理」Agent 用に新しいタスクを作成し、作業ディレクトリは今回のインタビューのフォルダのみを選択します。Agent には元の記録を保持し、新しく `summary.md` と `quotes.md`。タスク完了後、右側の【ファイル】で引用と文章を確認し、少量の誤字を直接修正します。次の被取材者では別の新しいタスクを開き、コンテキストの混在を避けます。
右側に【ファイル】がないのはなぜですか？ 現在のタスクにはアクセス可能な作業ディレクトリがないか、またはディレクトリがすでにアクセス不能です。まずタスクの上部で作業ディレクトリを再選択し、それから Agent にファイルを読み込ませるメッセージを送ってください。
どのファイルは直接編集できませんか？ バイナリファイル、非 UTF-8 テキスト、そしてサイズの大きいファイルは、プレビューまたは外部で開くことしかできません。それらも 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/workspaces-tasks-files.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.