---
title: "Навыки"
---

# Навыки

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Навыки — это текстовые инструкции, которые AI-агент использует в определенных ситуациях.

В отличие от [системного промпта](https://timeweb.cloud/docs/ai-agents/manage-agents/instructions), полная инструкция навыка не передается модели с каждым запросом. В контекст постоянно добавляется только описание из поля «Когда применять». Если запрос подходит под это описание, агент дополнительно использует инструкцию из навыка.

Такой подход помогает сократить расход входящих токенов: объемные инструкции попадают в контекст только тогда, когда они нужны.

Навыки работают при [использовании виджета](https://timeweb.cloud/docs/ai-agents/manage-agents/embed-chatbots), [внешнего чата](https://timeweb.cloud/docs/ai-agents/manage-agents/external-chat) или [API](https://timeweb.cloud/docs/ai-agents/api-usage/native-api).

## Как работают навыки

К одному агенту можно подключить несколько навыков. Один навык также можно использовать с несколькими агентами.

При подготовке одного ответа агент может использовать сразу несколько навыков, если запрос соответствует условиям их применения.

Если инструкции в навыке и системном промпте противоречат друг другу, агент следует системному промпту.

Если агент использовал навык при подготовке ответа, в чате отобразится соответствующий лейбл.

## Создание навыка

Создать навык можно в разделе «[Навыки](https://timeweb.cloud/my/cloud-ai/skills)» или при создании агента.

### В разделе «Навыки»

1.  Перейдите в раздел «ИИ-сервисы» → «Навыки».
    
2.  Нажмите «Добавить».
    
3.  Задайте параметры навыка.
    
4.  Нажмите «Добавить».
    

После создания навык появится в разделе «ИИ-сервисы» → «Навыки».

### При создании агента

На шаге «Инструкция и навыки» выберите существующий навык или нажмите «Добавить новый». При создании нового навыка задайте его параметры и нажмите «Добавить».

![Создание навыка при создании агента](https://content.timeweb.com/assets/61121c20-f95c-4bc4-9f9e-e0c4d4bcf07f.png?width=874&height=486)

## Параметры навыка

При создании навыка укажите:

-   Название навыка — имя, под которым навык отображается в панели управления;
    
-   Когда применять — описание ситуаций, в которых агент должен использовать навык. Это описание передается агенту при каждом запросе;
    
-   Инструкция — текст инструкции, которую агент использует, если запрос соответствует описанию из поля «Когда применять»;
    
-   Агенты — список агентов, к которым нужно сразу подключить навык. Поле необязательное.
    

![Параметры навыка](https://content.timeweb.com/assets/f8501774-0dc3-4092-b9b7-d7ab73d432ed.png?width=734&height=906)

## Подключение навыка к агенту

Чтобы подключить к агенту ранее созданный навык:

1.  Перейдите в раздел «ИИ-сервисы» → «Агенты» и кликните на нужного агента.
    
2.  Перейдите на вкладку «Управление».
    
3.  В блоке «Ресурсы» нажмите «Изменить» в строке «Навыки».
    
4.  Выберите нужный навык и его версию.
    

## Редактирование и версии навыка

Чтобы изменить навык, перейдите в раздел «ИИ-сервисы» → «Навыки» и кликните на нужный навык. Откроется редактор, в котором можно изменить его параметры.

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

![Сохранение изменений](https://content.timeweb.com/assets/66e6d414-d3bc-48f7-b332-bb75a4721578.png?width=2182&height=1552)

Каждое изменение, кроме названия, создает новую версию навыка. Это позволяет вернуться к предыдущей инструкции.

Чтобы выбрать версию:

-   кликните на нее в правом меню редактора;
    
-   или измените версию при подключении навыка к агенту.
    

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

## Копирование навыка

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

Чтобы создать копию:

1.  Перейдите в раздел «ИИ-сервисы» → «Навыки».
    
2.  Откройте нужный навык и выберите версию, которую нужно скопировать.
    
3.  Вернитесь к списку навыков, нажмите на три точки рядом с нужным навыком и выберите «Дублировать».
    

Копия будет создана сразу и появится в списке.

## Удаление навыка

Чтобы удалить навык:

1.  Перейдите в раздел «ИИ-сервисы» → «Навыки».
    
2.  Нажмите на три точки рядом с нужным навыком и выберите «Удалить».
    
3.  Подтвердите удаление.