> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ИИ-агент

> Ваш всегда доступный помощник, который обрабатывает сообщения гостей, отвечает на вопросы и знает, когда попросить помощи

## Познакомьтесь со своим ИИ-напарником

ИИ-агент Trellis -- как опытный сотрудник, который никогда не спит. Он читает каждое сообщение гостя, понимает контекст -- какой объект, какое бронирование, какое время суток -- и отвечает точными, полезными ответами.

Но он также знает свои пределы. Когда что-то выходит за рамки его компетенции -- жалоба, запрос на возврат, проблема безопасности -- он эскалирует вашей команде вместо того, чтобы угадывать.

***

## Что может ИИ-агент

<CardGroup cols={2}>
  <Card title="Отвечать на вопросы гостей" icon="comments">
    Инструкции по заезду, пароль Wi-Fi, парковка, правила дома, местные рекомендации -- ИИ обрабатывает типовые вопросы мгновенно, на языке гостя.
  </Card>

  <Card title="Составлять ответы для проверки" icon="pen-to-square">
    Для сообщений, требующих личного подхода, ИИ составляет ответ и ждет вашего одобрения, правки или отклонения.
  </Card>

  <Card title="Работать на нескольких языках" icon="globe">
    Гости пишут на своем языке; ИИ отвечает соответственно в поддерживаемых подключенных каналах.
  </Card>

  <Card title="Искать доступность" icon="magnifying-glass">
    Гости спрашивают "есть ли у вас что-нибудь на следующие выходные?" -- ИИ проверяет активные объекты по свободным датам, вместимости и деталям объекта. Цены доступны через поддерживаемые интеграции цен или расчета.
  </Card>

  <Card title="Просмотр внешних сайтов" icon="globe-pointer" href="/ru/platform/connected-accounts">
    ИИ может войти в Airbnb, Booking.com и другие платформы, чтобы проверить объявления, скачать отчёты или подтвердить информацию - используя сохранённые [подключённые аккаунты](/ru/platform/connected-accounts).
  </Card>

  <Card title="Создавать и обновлять задачи" icon="clipboard-list" href="/ru/platform/tasks">
    При обращении гостя о проблеме ИИ может создать [задачу](/ru/platform/tasks) и назначить ее нужному сотруднику. Он также может публиковать комментарии в лентах активности задач.
  </Card>

  <Card title="Создавать шаблоны задач" icon="layer-group" href="/ru/platform/tasks#task-templates">
    Опишите нужный шаблон -- "создай чек-лист генеральной уборки ванной с требованиями фото" -- и ИИ построит его с разделами, шагами и настройками фотоверификации.
  </Card>

  <Card title="Управление отделами" icon="folder-tree" href="/ru/platform/tasks#types-of-tasks">
    Создавайте, переименовывайте или удаляйте отделы задач в соответствии с вашими операциями. ИИ также может переназначить задачи из одного отдела в другой - например, перенести задачу из уборки в обслуживание при изменении объёма работ.
  </Card>

  <Card title="Обновление времени смен" icon="clock" href="/ru/platform/tasks#time-tracking">
    Записывайте, когда члены команды начали и закончили смену. ИИ автоматически рассчитывает фактические отработанные часы, когда указаны оба времени.
  </Card>

  <Card title="Эскалировать при необходимости" icon="flag">
    Жалобы, запросы на возврат, проблемы безопасности или что-либо за рамками инструкций ИИ немедленно эскалируются вашей команде.
  </Card>

  <Card title="Учиться и улучшаться" icon="graduation-cap">
    ИИ запоминает важные детали из прошлых взаимодействий и улучшается со временем по мере уточнения инструкций.
  </Card>
</CardGroup>

***

## Как ИИ отвечает гостям

<Steps>
  <Step title="Гость отправляет сообщение">
    Сообщение поступает в ваш [единый почтовый ящик](/ru/platform/inbox) через любой канал -- Airbnb, Booking.com, WhatsApp, email или SMS.
  </Step>

  <Step title="ИИ собирает контекст">
    Он изучает:

    * Бронирование гостя (даты, объект, количество гостей, финансы и все пользовательские поля из PMS)
    * Детали объекта (удобства, правила дома, процедуры заезда)
    * Ваши инструкции агента (тон, политики, что эскалировать)
    * Историю разговора (что обсуждалось ранее)
    * Базу знаний (добавленные вами документы)
    * Доступность в реальном времени по портфелю (когда гость спрашивает о свободных датах)
  </Step>

  <Step title="ИИ составляет ответ">
    Используя весь контекст, он пишет точный, соответствующий бренду и полезный ответ. Никаких шаблонных ответов -- каждый ответ адаптирован к конкретному гостю и объекту.
  </Step>

  <Step title="Ответ доставляется">
    В зависимости от настроек:

    * **Режим проверки:** Черновик появляется для одобрения, правки или отклонения
    * **Режим автопилота:** Ответ отправляется автоматически после короткой задержки
  </Step>
</Steps>

***

## Поиск бронирований

Когда ИИ-агент ищет бронирования -- для отчетов, вопросов гостей или операционных запросов вроде "завтрашние выезды" -- он автоматически фильтрует только **активные бронирования**. Результаты включают подтвержденные, текущие и завершенные пребывания, исключая запросы, отмены и неявки.

<Note>
  Если вы специально запрашиваете бронирование по коду подтверждения, ИИ ищет по всем статусам -- включая отмененные и запросы -- чтобы вы всегда могли найти любое бронирование.
</Note>

***

## Поиск доступности

Когда гость спрашивает о свободных датах -- "есть ли у вас место у моря на следующие выходные?" -- ИИ-агент ищет доступность среди активных объектов на запрошенные даты. Он возвращает подходящие варианты с деталями объекта, такими как расположение, спальни, ванные и вместимость.

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

<Tip>
  Убедитесь, что данные объектов и календарь актуальны. ИИ использует данные в реальном времени для предоставления точных результатов.
</Tip>

***

## Пользовательские поля

ИИ-агент имеет доступ ко всем пользовательским полям бронирований, синхронизированным из PMS. Агент может ссылаться на любые пользовательские данные -- коды доступа, особые пожелания или заметки -- при ответах гостям.

Дополнительная настройка не требуется. Пока интеграция PMS синхронизирует пользовательские поля в Trellis, ИИ-агент автоматически включает их в контекст.

<Note>
  В ответах гостям пользовательские поля используются как контекст. Некоторые внутренние обновления пользовательских полей бронирования доступны только если подключенная PMS и сопоставления полей поддерживают запись.
</Note>

***

## Чтение файлов Slack

Когда команда делится файлами в подключенном канале Slack -- документами, таблицами или изображениями -- ИИ-агент может читать и понимать их.

* **Текстовые файлы** -- агент читает полное содержимое текстовых файлов (документы, CSV, логи) и может ссылаться на конкретные детали.
* **Изображения** -- агент описывает увиденное на изображениях -- полезно для фотографий обслуживания, документов гостей или скриншотов.

<Note>
  Чтение файлов Slack работает только с каналами, подключенными к вашему рабочему пространству. ИИ обрабатывает текстовые файлы и изображения -- другие типы файлов не поддерживаются.
</Note>

***

## Настройка ИИ-агента

### Написание хороших инструкций

Инструкции агента указывают ИИ, как представлять ваш бизнес. Чем лучше инструкции, тем лучше работает ИИ.

<Tip>
  Думайте об инструкциях как об адаптации нового сотрудника. Что бы вы сказали ему в первый день? Это то, что нужно знать ИИ.
</Tip>

**Включите в инструкции:**

<AccordionGroup>
  <Accordion title="Голос и тон бренда">
    Вы неформальные и дружелюбные? Профессиональные и формальные? Теплые, но лаконичные? Дайте ИИ четкое представление о стиле общения. Включите примеры фраз.
  </Accordion>

  <Accordion title="Процедуры заезда и выезда">
    Пошаговые инструкции по прибытию -- коды дверей, ключницы, парковка, вход в здание и любые особенности.
  </Accordion>

  <Accordion title="Правила дома и политики">
    Тишина, курение, животные, максимальная вместимость, часы работы бассейна, вывоз мусора и все, что должны соблюдать гости.
  </Accordion>

  <Accordion title="Частые вопросы">
    Самые частые вопросы: пароль Wi-Fi, парковка, ближайший магазин, поздний выезд, использование джакузи.
  </Accordion>

  <Accordion title="Правила эскалации">
    Укажите конкретно, что ИИ НЕ должен обрабатывать: запросы на возврат, претензии по ущербу, жалобы на шум, проблемы безопасности или все, что требует одобрения руководителя.
  </Accordion>
</AccordionGroup>

### Настройка автопилота

Вы контролируете степень автономии ИИ для каждого типа контакта:

| Тип контакта   | Рекомендуемая начальная настройка                                                          |
| -------------- | ------------------------------------------------------------------------------------------ |
| **Гости**      | Начните с режима проверки. Переключитесь на автопилот, когда убедитесь в качестве ответов. |
| **Владельцы**  | Оставайтесь в режиме проверки. Общение с владельцами часто требует личного подхода.        |
| **Подрядчики** | Режим проверки для большинства команд. Автопилот если взаимодействия типовые.              |

<Warning>
  При включенном автопилоте ИИ отправляет ответы автоматически после настраиваемой задержки. Убедитесь, что инструкции тщательно проработаны и протестированы.
</Warning>

***

## База знаний

База знаний дает ИИ-агенту доступ к документам и информации помимо инструкций.

**Что добавить в базу знаний:**

* Гиды по объектам (детальные процедуры заезда для каждого объекта)
* Путеводители по району и местные рекомендации
* Сезонная информация (даты открытия бассейна, горнолыжные абонементы)
* Процедуры уборки и обслуживания
* Стандартные операционные процедуры

<Steps>
  <Step title="Перейдите в Базу знаний">
    Перейдите в **База знаний** в левой боковой панели.
  </Step>

  <Step title="Создайте или загрузите документы">
    Пишите документы прямо в Trellis или загружайте существующие. Организуйте их в папки по объекту, теме или команде.
  </Step>

  <Step title="Предоставьте доступ агенту">
    Выберите, какие документы может использовать каждый агент. Это позволяет иметь разных агентов для разных целей.
  </Step>
</Steps>

***

## Память агента

Со временем ИИ-агент учится из взаимодействий и формирует память важных деталей.

<Tabs>
  <Tab title="Ручная память">
    Добавляйте записи сами, чтобы научить ИИ конкретным вещам. Например: "Семья Ивановых -- постоянные гости, всегда просят ранний заезд" или "В блоке 4Б сложный термостат -- нужно удерживать 3 секунды."
  </Tab>

  <Tab title="Выученная память">
    ИИ автоматически извлекает важные детали из разговоров -- предпочтения гостей, решенные проблемы и заметки по объектам. Они сохраняются и используются в будущих взаимодействиях.
  </Tab>
</Tabs>

Вы можете просматривать, редактировать и удалять записи памяти в любое время из раздела База знаний.

***

## Множественные агенты

Для крупных операций можно создать несколько ИИ-агентов -- каждый с разными инструкциями, разрешениями и фокусом.

**Типичные настройки:**

| Агент                         | Назначение                                                                                                      |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Коммуникации с гостями**    | Обрабатывает все входящие сообщения гостей дружелюбным тоном. Знает процедуры заезда, правила и местные советы. |
| **Обновления для владельцев** | Общается с владельцами профессиональным, деловым тоном. Предоставляет данные о показателях и обслуживании.      |
| **Внутренние операции**       | Помогает команде с операционными вопросами -- поиск бронирований, информация об объектах, генерация отчетов.    |

<Info>
  У каждого агента могут быть разные разрешения на инструменты. Гостевой агент может только читать данные объектов, а внутренний -- создавать задачи и обновлять записи.
</Info>

***

## Бот Google Meet

ИИ-агент может присоединяться к звонкам Google Meet и отвечать на вопросы в реальном времени.

### Как это работает

Бот присоединяется к вызову как участник и слушает **слово-активатор**. Когда кто-то его произносит, бот обрабатывает сказанное и отвечает естественной речью.

* **Слово-активатор** -- бот активируется по имени агента (например, "Люси"). Также работает "Trellis".
* **Полный доступ к инструментам** -- бот может искать бронирования, проверять объекты, просматривать задачи и базу знаний.
* **Осведомленность о совещании** -- бот понимает, что говорят несколько человек, и отвечает тому, кто к нему обратился.
* **Память разговора** -- все обсуждаемое сохраняется в истории сессии агента.

<Warning>
  В целях безопасности бот Google Meet не может отправлять сообщения гостям, создавать бронирования или удалять документы. Это ассистент для консультаций, не автономный агент.
</Warning>

### Настройка бота Google Meet

<Steps>
  <Step title="Перейдите в интеграции агента">
    Перейдите в **База знаний > Агенты**, выберите агента и откройте вкладку **Интеграции**.
  </Step>

  <Step title="Подключите Google Meet">
    Найдите раздел Google Meet и активируйте. Бот автоматически использует имя и инструкции агента.
  </Step>

  <Step title="Выберите голос">
    Выберите голос из доступных вариантов. Каждый голос имеет свой тон и стиль - попробуйте несколько, чтобы найти подходящий вашему бренду.

    | Голос      | Описание                                               |
    | ---------- | ------------------------------------------------------ |
    | **Aoede**  | Теплый и чистый -- дружелюбный тон (по умолчанию)      |
    | **Charon** | Спокойный и размеренный -- для деловых звонков         |
    | **Fenrir** | Уверенный и прямой -- для операционных брифингов       |
    | **Kore**   | Мягкий и успокаивающий -- для общения с гостями        |
    | **Leda**   | Яркий и выразительный -- для энергичных взаимодействий |
    | **Orus**   | Глубокий и ровный -- для формальных встреч             |
    | **Puck**   | Разговорный и естественный -- универсальный            |
    | **Zephyr** | Легкий и плавный -- для неформальных стендапов         |
  </Step>

  <Step title="Пригласите бота в звонок">
    При запуске Google Meet добавьте бота как участника через Trellis. Он присоединяется и ждет слово-активатор.
  </Step>

  <Step title="Задайте вопрос">
    Скажите имя агента и задайте вопрос -- например, "Люси, какой код двери у блока 4Б?" Бот ответит естественной речью, используя данные объектов.
  </Step>
</Steps>

### Идентификация бота в звонке

В видеоплитке бота отображается имя агента и текущий статус:

* **Подключение** -- бот присоединяется
* **Слушает** -- бот ждет слово-активатор
* **Говорит** -- бот отвечает на вопрос
* **Ошибка** -- что-то пошло не так (проверьте конфигурацию)

Вкладка интеграций также показывает количество активаций каждого бота.

<Tip>
  Бот Google Meet идеален для стендапов команды, звонков с владельцами и операционных совещаний, где нужен быстрый доступ к информации без переключения экранов.
</Tip>

***

## Боковая панель ИИ-чата

Помимо обработки сообщений гостей, вы можете общаться с ИИ-агентом из любого места в Trellis. Используйте боковую панель для:

* Вопросов об объектах, бронированиях или гостях
* Быстрых сводок разговоров или задач
* Создания задач, комментариев или обновлений простым запросом
* Управлять отделами - создавать новые, переименовывать существующие или удалять ненужные
* Создания или редактирования [шаблонов задач](/ru/platform/tasks#task-templates) описанием
* Составления сообщений для проверки
* Получения операционных рекомендаций

<Tip>
  Боковая панель контекстно-зависима. Если вы открываете ее при просмотре объекта, ИИ уже знает, какой объект вы смотрите.
</Tip>

### Переключение режима ответа во время разговора

Вы можете сменить режим ответа ИИ в любой момент. Откройте выбор режима в области ввода и выберите другой режим. Каждое сообщение ассистента показывает, какой режим ответа использовался.

### Детали активности

Пока ИИ работает над запросом, боковая панель показывает активность в реальном времени. Вы видите операционные шаги: поиск бронирования, обращение к базе знаний, проверку доступности.

Действия отображаются хронологически. Нажмите на любое действие, чтобы посмотреть детали.

<Tip>
  Детали активности помогают убедиться, что ИИ использует правильные данные workspace. Если ответ кажется неточным, разверните действия и проверьте источники.
</Tip>

### Управление вкладками чата

Вкладки чата показывают кнопку **Архивировать** и кнопку **закрыть** при наличии сообщений. Используйте Архивировать для сохранения разговора, или закройте без архивации.

***

## Голосовые совещания

ИИ-агент может присоединяться к видеозвонкам и участвовать в реальном времени голосом -- как живой сотрудник на звонке.

<CardGroup cols={2}>
  <Card title="Голосовые ответы в реальном времени" icon="microphone">
    ИИ слушает и отвечает естественной речью во время совещания.
  </Card>

  <Card title="Те же знания, другой канал" icon="brain">
    Агент совещания использует ваши инструкции, базу знаний и данные объектов.
  </Card>
</CardGroup>

<Tip>
  Голосовые совещания работают лучше всего при полных инструкциях агента и актуальной базе знаний.
</Tip>

***

## Советы для лучших результатов

<CardGroup cols={2}>
  <Card title="Будьте конкретны в инструкциях" icon="bullseye">
    Размытые инструкции ведут к размытым ответам. Вместо "будь полезным" напишите "всегда указывай адрес объекта и код двери в ответах о заезде."
  </Card>

  <Card title="Регулярно обновляйте инструкции" icon="arrows-rotate">
    По мере развития бизнеса -- новые объекты, измененные политики, сезонные обновления -- обновляйте инструкции агента.
  </Card>

  <Card title="Еженедельно проверяйте ответы ИИ" icon="chart-line">
    Даже на автопилоте просматривайте выборку ответов каждую неделю. Ищите закономерности для улучшения и обновляйте инструкции.
  </Card>

  <Card title="Используйте базу знаний для деталей" icon="book-open">
    Держите инструкции агента на высоком уровне (тон, политики, эскалация), а детальные гиды -- в базе знаний. Так проще обновлять.
  </Card>
</CardGroup>