# Узел AI-сотрудника

## Введение

Узел AI-сотрудника используется в рабочем процессе для назначения AI-сотруднику выполнения определённой задачи с последующим выводом структурированной информации.

После создания рабочего процесса при добавлении узлов рабочего процесса можно выбрать узел AI-сотрудника.

![20260420142250](https://static-docs.nocobase.com/20260420142250.png)

## Настройка узла
### Подготовка

Перед настройкой узла AI-сотрудника необходимо разобраться, как создавать рабочие процессы, как настраивать LLM-сервис, а также узнать о назначении встроенных AI-сотрудников и о том, как создавать AI-сотрудников.

Можно ознакомиться со следующими документами:
  - [Рабочие процессы](/workflow)
  - [Настройка LLM-сервиса](/ai-employees/features/llm-service)
  - [Встроенные AI-сотрудники](/ai-employees/built-in/)
  - [Создание AI-сотрудника](/ai-employees/features/new-ai-employees)

### Задача
#### Выбор AI-сотрудника

Выберите AI-сотрудника, который будет отвечать за выполнение задачи в этом узле. В выпадающем списке выберите включённого в системе встроенного AI-сотрудника или AI-сотрудника, созданного вами самостоятельно.

![20260420143554](https://static-docs.nocobase.com/20260420143554.png)

#### Выбор модели

Выберите большую языковую модель, которая будет управлять AI-сотрудником. В выпадающем списке выберите модель, предоставляемую настроенным в системе LLM-сервисом.

![20260420145057](https://static-docs.nocobase.com/20260420145057.png)

#### Выбор оператора

Выберите пользователя в системе, который будет предоставлять AI-сотруднику права доступа к данным. При запросе данных AI-сотрудник будет ограничен правами этого пользователя.

Если триггер предоставляет оператора (например, `Custom action event`), то приоритетно используются права этого оператора.

![20260420145244](https://static-docs.nocobase.com/20260420145244.png)

#### Промпты и описание задачи

`Background` отправляется ИИ как системный промпт и обычно используется для описания фоновой информации задачи и ограничений.

`Default user message` — это пользовательский промпт, отправляемый ИИ; обычно описывает содержание задачи и сообщает ИИ, что нужно сделать.

![20260420174515](https://static-docs.nocobase.com/20260420174515.png)

#### Вложения

`Attachments` отправляются ИИ вместе с `Default user message`. Обычно это документы или изображения, которые необходимы для выполнения задачи.

Вложения поддерживают два типа:

1. `File(load via Files collection)` — использование первичного ключа для получения данных из указанной таблицы файлов и использования их в качестве вложения, отправляемого ИИ.

![20260420150933](https://static-docs.nocobase.com/20260420150933.png)

2. `File via URL` — получение файла по указанному URL и использование его в качестве вложения, отправляемого ИИ.

![20260420151702](https://static-docs.nocobase.com/20260420151702.png)

#### Навыки и инструменты

Обычно к AI-сотруднику привязано несколько навыков и инструментов; здесь можно ограничить использование лишь некоторых из них в текущей задаче.

По умолчанию установлен режим `Preset`, при котором используются предустановленные навыки и инструменты AI-сотрудника. При установке `Customer` можно выбрать только некоторые навыки или инструменты AI-сотрудника.

![20260426231701](https://static-docs.nocobase.com/20260426231701.png)

#### Поиск в интернете

Переключатель `Web search` управляет тем, использует ли ИИ в текущем узле возможность поиска в интернете. О поиске в интернете для AI-сотрудника см.: [Поиск в интернете](/ai-employees/features/web-search)

![20260426231945](https://static-docs.nocobase.com/20260426231945.png)

### Обратная связь и уведомления
#### Структурированный вывод

Пользователь может в соответствии со спецификацией [JSON Schema](https://json-schema.org/) определить структуру данных, которую в итоге выводит узел AI-сотрудника.

![20260426232117](https://static-docs.nocobase.com/20260426232117.png)

При получении данных узла AI-сотрудника другими узлами рабочего процесса варианты также будут формироваться в соответствии с этим `JSON Schema`.

![20260426232509](https://static-docs.nocobase.com/20260426232509.png)

##### Значение по умолчанию

По умолчанию предоставляется следующее определение `JSON Schema`, которое описывает объект, содержащий свойство с именем result строкового типа. Свойству также задан заголовок: Result.

```json
{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string",
      "description": "The text message sent to the user"
    }
  }
}
```

Согласно этому определению, узел AI-сотрудника выводит JSON-данные, соответствующие описанной структуре.

```json
{
  result: "Some text generated from LLM "
}
```

#### Настройки согласования

Узел поддерживает три режима согласования:

- `No required` — выводимое ИИ содержимое не требует ручной проверки. После завершения вывода ИИ рабочий процесс автоматически продолжается.
- `Human decision` — выводимое ИИ содержимое обязательно отправляется на ручную проверку проверяющему; рабочий процесс продолжается только после ручной проверки.
- `AI decision` — ИИ сам решает, отправлять ли выводимое содержимое на ручную проверку проверяющему.

![20260426232232](https://static-docs.nocobase.com/20260426232232.png)

Если режим согласования отличается от `No required`, для узла обязательно нужно настроить одного или нескольких проверяющих.

После того как ИИ в узле AI-сотрудника завершит вывод всего содержимого, всем настроенным для узла проверяющим будет отправлено уведомление. Достаточно, чтобы кто-то один из уведомлённых проверяющих выполнил действие согласования, и рабочий процесс сможет продолжиться.

![20260426232319](https://static-docs.nocobase.com/20260426232319.png)
