> 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/cases/project-delivery.md).

# Agent プロジェクトファイルの納品

運用担当は、散在する資料を索引、要約、納品ファイルに整理する必要があります。原本の誤編集を防ぐために、Agent の作業ディレクトリ、変更可能な範囲、受入れ方法を事前に明確にしておく必要があります。

## 適したタスク

* 散在する資料を目録と索引に整理する；
* テンプレートに基づいて複数の文書を生成する；
* コードを修正し、変更内容を残す；
* ファイルの一括リネーム、変換、または検査。

<figure><img src="/files/c067282a39e13b7507f895e713201e6a0f1b599e" alt="Agent 工作区中的 Agent、模型、工作目录和右侧面板"><figcaption><p>Agent ワークスペースでは、タスク、モデル、作業ディレクトリ、納品ファイルを同じページにまとめて表示します。</p></figcaption></figure>

<figure><img src="/files/afb3ba69dc76ebdb7a71857b8251aca48c50e7d0" alt="Agent 状态面板中的子任务、后台命令和上下文用量"><figcaption><p>長時間のタスクは、まず［状態］パネルで実行中、承認待ち、または完了済みかを確認します。</p></figcaption></figure>

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-f5bee1202b5aed4675a5537b57f3a1fd9147cf23%2Fcherry-v2-guide-artifact-preview.png?alt=media" alt="Cherry Assistant 生成的发布前检查清单已经在对话中打开为网页预览"><figcaption><p>成果物が生成されたら、実際に開いて確認する必要があります。図のウェブプレビューにはすでにタイトル、チェック項目、提案が表示されており、空のプレースホルダーではありません。</p></figcaption></figure>

## 操作手順

{% stepper %}
{% step %}

### 1. 最小限の作業ディレクトリを選ぶ

現在のプロジェクトディレクトリだけを選択します。重要なファイルは先にバックアップまたはバージョン記録を取り、権限は［都度確認］から始めます。
{% endstep %}

{% step %}

### 2. 変更可・不可の範囲を明確にする

どのファイルが読み取り専用か、成果物をどこに置くか、どの操作は事前確認が必要か、完了基準は何かを明記します。
{% endstep %}

{% step %}

### 3. まず Agent に計画を立てさせる

リスクの高いタスクでは［計画のみ］を使用できます。ファイル一覧と手順を確認してから、編集を許可するモードに切り替えて実行します。
{% endstep %}

{% step %}

### 4. 右側で状態とファイルを確認する

長時間のタスクはまず［状態］が承認待ちかを確認します。成果物が生成されたら［ファイル］でプレビューします。問題ないことを確認してから引き渡し、「タスク完了」を受入れの代わりにしません。
{% endstep %}
{% endstepper %}

## サンプルタスク

```
現在のディレクトリを整理します。raw/ 内のファイルは読み取り専用です。deliverables/ の下に索引、要約、欠落資料一覧を作成します。削除、上書き、または一括リネームはすべて事前に確認を取ります。最後に新規追加・変更したファイルを一覧表示します。
```

## 推奨組み合わせ

| 機能       | 推奨される使い方                  | 理由                         |
| -------- | ------------------------- | -------------------------- |
| 作業ディレクトリ | 各プロジェクトごとに独立したディレクトリを使用する | ファイルの境界と納品先を明確にする          |
| 権限       | ファイル変更は［都度確認］のままにする       | 誤削除、上書き、境界外への書き込みを見つけやすくする |
| 状態パネル    | 終了前に成果物と失敗した手順を確認する       | 「Agent が完了したと言った」だけでは判断しない |
| 新しいタスク   | 新しい段階や新しい顧客ごとに別タスクを立てる    | 過去の要件が現在の納品に影響するのを防ぐ       |

{% hint style="danger" %}
［完全アクセス］は確認を減らせますが、誤操作の影響も広がります。分離され、信頼でき、復旧可能なディレクトリでのみ、一時的な使用を検討してください。
{% endhint %}


---

# 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/cases/project-delivery.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.
