> 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/russian/advanced-basic/agent-workspace.md).

# Рабочая область Agent

Agent подходит для задач с чёткой целью, требующих использования инструментов или файлов и, возможно, состоящих из нескольких шагов. Вход находится в левой навигации «Работа», а не во вкладке сверху из старой версии руководства.

{% hint style="success" %}
Самый простой способ настройки — сначала сказать Agent, что вы хотите сделать, а затем попросить его проверить, каких моделей, инструментов, базы знаний или каналов не хватает. Когда нужен точный контроль, откройте окно редактирования Agent или вручную настройте в разделе «Настройки».
{% endhint %}

<figure><img src="/files/cd42d0a0f7bbaba7c28b937ba34d1bb05f1f1e7a" alt="Agent 从说明交付物、选择工作目录到检查文件和结果的任务闭环图"><figcaption><p>Рабочий каталог, права доступа и критерии завершения проходят через всю задачу; при необходимости изменения вернитесь к этапу планирования и подтвердите их заново.</p></figcaption></figure>

## Из чего состоит рабочая область

| Раздел          | Роль                                                       | Когда нужно обратить внимание                                                           |
| --------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Agent           | Сохраняет роль, модель, подсказки и возможности            | Когда одну и ту же работу нужно выполнять повторно                                      |
| Задача          | Запись одной непрерывной работы                            | Для каждой цели открывайте отдельную задачу, чтобы сохранять контекст                   |
| Рабочий каталог | Диапазон файлов, которые Agent может обрабатывать напрямую | Файловые задачи, такие как код, систематизация материалов, генерация документов и т. п. |
| Область ввода   | Отправка цели, вложений и вызов инструментов               | Запуск задачи или добавление требований                                                 |
| Правая панель   | Просмотр состояния, файлов, подзадач и потока сообщений    | Отслеживание длительных задач, проверка результатов или устранение неполадок            |

<figure><img src="/files/6c2e5fc81d4d40e626d46469640005e00d81f095" alt="Agent 工作区中的 Agent、模型、工作目录和右侧面板"><figcaption><p>Перед началом задачи сначала проверьте Agent, модель, рабочий каталог и правую панель.</p></figcaption></figure>

## Начать задачу

{% stepper %}
{% step %}

### 1. Откройте «Работа» и выберите Agent

Если подходящий Agent уже есть, просто выберите его; если нет, нажмите «Добавить интеллектуального агента» и завершите создание за четыре шага: базовая информация, персона, навыки и база знаний.
{% endstep %}

{% step %}

### 2. Выберите рабочий каталог

Когда нужно обрабатывать локальные файлы, выберите каталог, в котором находится эта задача; если файлы не задействованы, можно использовать рабочую область по умолчанию, созданную приложением. Одна задача соответствует одной рабочей области, чтобы Agent не искал попеременно в несвязанных каталогах.
{% endstep %}

{% step %}

### 3. Опишите задачу через результат

Сообщите Agent, что нужно сдать, какие материалы можно использовать, какие есть ограничения и как понять, что работа завершена. Например:

```
Прочитайте протоколы совещаний в текущем каталоге, систематизируйте решения, ответственных и сроки, и создайте action-items.md. Не изменяйте исходные файлы.
```

{% endstep %}

{% step %}

### 4. Проверьте процесс и результаты на правой панели

В разделе «Состояние» отображаются активные задачи, подагенты, рабочие процессы и фоновые команды; в разделе «Файлы» можно просматривать и редактировать текстовые результаты; после включения режима разработчика можно также смотреть «Цепочку вызовов».
{% endstep %}
{% endstepper %}

## Подсказка про API Gateway

Работа Agent зависит от API-шлюза Cherry Studio. Если шлюз не включён, приложение предложит «Включить и запустить»; также можно перейти в «Настройки» → «API-шлюз» и проверить порт, состояние работы и блокировку местным защитным ПО.

{% hint style="warning" %}
API-шлюз — это рабочая зависимость Agent, но это не значит, что интерфейс нужно открывать в сеть. Оставьте использование по умолчанию, только локально; копировать URL и API-ключ нужно лишь тогда, когда вы явно хотите, чтобы к нему обращались другие программы.
{% endhint %}

## Один Agent или несколько Agent

* Одна и та же роль, один и тот же набор возможностей, но разные задачи: используйте одного Agent и создавайте несколько задач.
* Разные роли, разные области материалов или разные права доступа: разделите на несколько Agent.
* Для одной цели, требующей параллельного исследования или координации нескольких шагов: сначала дайте одному Agent использовать подагентов или рабочий процесс, не обязательно сразу вручную создавать много Agent.

## Пример пользователя: организация материалов проекта

Менеджер продукта поместил описание требований, записи интервью и материалы по конкурентам в одну папку, создал Agent «Организация требований», привязал базу знаний о продукте и использовал права доступа «Подтверждать по шагам». Agent сначала прочитал материалы, затем записал список требований и вопросы для уточнения в новый файл. Менеджер продукта прямо исправил текст в правом разделе «Файлы», а исходные материалы остались без изменений.

<details>

<summary>Почему Agent не видит только что привязанную возможность?</summary>

Изменения в Agent сохраняются автоматически. Ответ, который сейчас генерируется, не будет прерван; изменения в модели, навыках, MCP и базе знаний начнут действовать со следующего сообщения. Если всё ещё не появилось, сначала убедитесь, что возможность включена, а затем отправьте новое сообщение.

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