> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Skills
> Создавайте, настраивайте, тестируйте и управляйте переиспользуемыми навыками AI Skills для повторяющихся задач клиентов.
Навык (Skill) обучает AI-агента выполнять конкретную повторяющуюся задачу, определяя, когда ее следует запускать и каким шагам должен следовать агент. Используйте Skills для таких процессов, как обработка возвратов, квалификация лидов, запросы по заказам, запись на прием или другие многоэтапные обращения клиентов.
## Когда следует создавать Skill?
Выбирайте рабочие процессы, в которых искусственный интеллект может существенно сократить ручной труд и где ожидаемый процесс можно четко описать.
### Подходящие сценарии
* Повторяющиеся, высокочастотные задачи, которые сейчас выполняет ваша команда
* Задачи, требующие нескольких уточняющих вопросов или проверок перед завершением
* Процессы с четкими бизнес-правилами, обязательной информацией и условиями завершения
* Задачи, требующие данных из внешней системы через коннектор данных
* Процессы, в которых при определенных условиях может потребоваться передача оператору
### Перед началом работы
* Выберите одну четко определенную бизнес-задачу
* Задокументируйте правильный процесс и важные граничные случаи
* Определите, какая информация о клиенте требуется для выполнения задачи
* Подготовьте и активируйте все необходимые коннекторы данных
* Определите, когда AI должен остановиться или передать диалог человеку
**Рекомендация:** Начните с одного или двух наиболее ценных навыков. Небольшой, хорошо протестированный Skill обычно надежнее, чем один Skill, пытающийся решать множество несвязанных задач.
***
## Создание и управление навыками
### Откройте страницу Skills
1. Откройте AI-агента, которого хотите настроить.
2. Перейдите в раздел **Settings**, затем выберите вкладку **Skills** .
3. Нажмите **New Skill**.
[Открыть страницу Skills в YCloud](https://www.ycloud.com/console/#/app/chatbot/agent/6a2906717c73707cc395680f/skills)
### Управление существующими навыками
В списке Skills отображаются название каждого навыка, триггер запуска (Start trigger), время последнего обновления и статус.
* **Поиск:** поиск навыка по названию.
* **Used / Unused:** используйте переключатель статуса, чтобы контролировать, может ли AI-агент использовать этот навык.
* **Редактирование:** нажмите на название навыка, чтобы обновить его триггер или инструкции.
* **Удаление:** откройте меню действий для навыка и выберите Delete.
Отключение навыка запрещает AI-агенту использовать его. Удаляйте Skill только тогда, когда его конфигурация больше не нужна.
***
## Настройка навыка
### 1. Укажите понятное название
Указывайте конкретный результат или задачу, а не общий отдел или тему. Понятные названия упрощают поиск и поддержку навыков.
| **Качество** | **Пример** | **Причина** |
| - | - | - |
| **Рекомендуется** | Обработать запрос на возврат средств | Описывает одну конкретную задачу клиента |
| **Не рекомендуется** | Обслуживание клиентов | Слишком общее название, не отражающее реальное действие навыка |
### 2. Определите триггер запуска (Start trigger)
Триггер запуска определяет, когда AI-агент должен и не должен использовать навык. Укажите намерение клиента, необходимый контекст и важные исключения.
> Используйте этот навык, когда клиент явно просит отменить подходящий заказ и получить возврат средств. Не используйте его для вопросов о правилах возврата, сбоях оплаты или заказах, которые уже были отправлены.
#### Чек-лист для триггера запуска
* Опишите намерение клиента на естественном языке.
* Добавьте распространенные формулировки запроса, если это полезно.
* Укажите, когда навык не должен срабатывать, если похожий запрос требует другого процесса.
* Избегайте размытых триггеров, таких как "по необходимости" или "для вопросов в поддержку".
### 3. Напишите пошаговые инструкции
Опишите полную процедуру, которой должен следовать AI-агент. Каждый шаг должен иметь одну понятную цель и начинаться с действия.
1. **Подтвердите получение** запроса клиента.
2. **Соберите** информацию, необходимую для идентификации заказа.
3. **Проверьте** , соответствует ли запрос правилам возврата средств.
4. **Используйте** подходящий коннектор данных для получения или обновления заказа.
5. **Подтвердите** результат и объясните дальнейшие шаги.
6. **Передайте диалог** или завершите его при выполнении соответствующего условия.
#### Рекомендации по составлению инструкций
* Пронумеруйте шаги в порядке их выполнения.
* Сосредоточьте каждый шаг на одном действии или решении.
* Явно указывайте необходимую информацию, вместо того чтобы полагаться на догадки AI.
* Определите, что делать при отсутствии данных, их недействительности или противоречивости.
* Четко формулируйте условия завершения и передачи диалога.
* Разделяйте длинные или условные инструкции на более мелкие шаги.
**Избегайте необоснованных предположений.** Если инструкции, профиль, база знаний или подключенные системы не содержат нужной информации, укажите AI-агенту спросить клиента, остановить процесс или передать диалог человеку.
***
## Использование команд в инструкциях навыка
В редакторе пошаговых инструкций (Step-by-Step instructions) введите **/** , чтобы вставить доступную команду. В меню отображаются встроенные действия и активные коннекторы данных, доступные AI Agent.
### Встроенные действия
| **Действие** | **Для чего используется** | **Пример условия** |
| - | - | - |
| **Hand Off** | Передать диалог оператору или команде | Возврат средств не соответствует правилам, клиент оспаривает результат или требуется подтверждение от человека |
| **Close Conversation** | Завершить диалог после успешного выполнения навыка | Результат подтвержден, и клиенту больше не требуется помощь |
| **Add to unsubscribe list** | Добавить текущий контакт в список отписавшихся | Контакт явно просит прекратить отправку маркетинговых сообщений |
Чтобы вставить действие, введите **/** в поле **Step-by-Step instructions**, затем выберите его в разделе **Built in actions**. Действие появится в виде команды в инструкциях навыка.
### Коннекторы данных
Коннекторы данных позволяют навыку запрашивать или обновлять внешние бизнес-данные. В командном меню отображаются только настроенные и активные коннекторы.
Для каждого шага коннектора четко опишите:
* Когда следует использовать коннектор
* Какие входные значения необходимо собрать или передать
* Как AI Agent должен интерпретировать результат
* Что делать, если запрос завершился ошибкой или не вернул подходящих данных
* Должен ли клиент подтвердить операцию перед изменением данных
Не указывайте навыку использовать коннектор, который не был настроен и активирован. Перед публикацией протестируйте успешные сценарии коннектора, пустые результаты, невалидные входные данные и ответы с ошибками.
***
## Предпросмотр, публикация и улучшение
### Тестирование в предпросмотре
Используйте панель предпросмотра (Preview) во время редактирования навыка. Протестируйте как запросы, которые должны активировать навык, так и похожие запросы, которые не должны его запускать. Перезапустите предпросмотр, если вам нужен чистый диалог.
#### Минимальный чек-лист для тестирования
* Типичный запрос клиента активирует правильный навык
* Похожий, но исключенный запрос не активирует навык
* AI Agent собирает всю необходимую информацию перед выполнением действия
* Шаги выполняются в запланированном порядке
* Ветки успешного и неуспешного выполнения коннектора данных работают корректно
* Навык переключается на человека, когда требуется оценка или подтверждение оператора
* Диалог закрывается только после полного завершения задачи
* AI Agent не выдумывает данные, соответствие критериям или результаты действий
### Включение и публикация
1. Вернитесь к списку навыков и установите статус навыка на **Used**.
2. Нажмите **Publish** , чтобы применить изменения навыка агента.
3. Протестируйте опубликованного агента в канале клиента, где он будет использоваться.
4. Просматривайте реальные диалоги и уточняйте триггер запуска (Start trigger) или инструкции при обнаружении повторяющихся сбоев.
Надежный навык создается итеративно. Начните с узкого процесса, протестируйте реалистичные пограничные случаи, опубликуйте и улучшайте навык, устраняя повторяющиеся проблемы по одной.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.