> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/bystryi-start.md). # БЫСТРЫЙ СТАРТ Для того, чтобы создать своего первого агента необходимо сделать несколько простых вещей: {% stepper %} {% step %} ### Создайте агента Нажмите на кнопку **Новый агент**
{% endstep %} {% step %} ### Пропишите инструкцию В созданном агенте необходимо прописать **инструкцию** о его роли и поведении:
* В блоке **ОБЩИЕ СВЕДЕНИЯ** заполняется информация о компании, ее деятельности и какие-то общие параметры, характерные для всего диалога с клиентом. Сюда так же можно добавить контактные данные и адреса. * В блоке **ЦЕЛИ И ЗАДАЧИ** описывается информация о тех целях и задачах, которые агент должен выяснить, например, его целью может быть серия вопросов клиенту и получение номера телефона, или отправка какой-то информации по итогам разговора. Чем подробнее вы опишите цели и задачи - тем точнее агент будет их выполнять. * В блоке **ПРИВЕТСТВИЕ** можно указать необходимость приветствия и конкретный текст. * Блок **ЯЗЫК ОТВЕТОВ** позволяет задавать конкретный язык на котором отвечает агент и языковые правила. * В блоке **СТИЛЬ ОТВЕТА** задается стилистика и манера ответов агента. {% hint style="info" %} **Важно знать!** Написание инструкций для ИИ-агентов или "промптов" - это целая "наука". Там есть свои правила и лучшие практики. Но основной совет - чем точнее, но лаконичнее будет описан конкретный сценарий - тем лучше будет работать. В тексте не должно быть похожих или двузначных указаний. Подробно о лучших практиках написания инструкций можно посмотреть в разделе [Системная инструкция](/ru/osnovnye-nastroiki/prompts.md) {% endhint %} Вы также можете воспользоваться функцией [генерации инструкции](/ru/osnovnye-nastroiki/prompts/avtomaticheskaya-generaciya-instrukcii-i-bazy-znanii.md). В этом случае Вам достаточно описать вводные данные, роль агента, что он должен делать, при необходимости добавить ссылку на Ваш сайт, в этом случае платформа подтянет основную информацию и дополнит инструкцию. {% endstep %} {% step %} ### Параметр **Время ожидания:**
Параметр **Время ожидания** отвечает за паузу, которая возникает перед ответом агента. Данная пауза позволяет объединить несколько сообщений клиента в одну мысль, т.к. часто бывает, что люди пишут одну мысль разными сообщениями, например: > *"Добрый день!"* > > *"У меня есть вопрос"* > > *"Подскажите сколько будет стоить ваш товар"* > > *"И есть ли скидки"* Задержка преобразует данные сообщения в такой вид, что позволит ответить одним сообщением а не четырьмя: > "*Добрый день!* *У меня есть вопрос. Подскажите сколько будет стоить ваш товар и есть ли скидки*" Кроме того, часто компании не хотят, чтобы клиент понимал, что отвечает агент, поэтому дополнительная задержка в ответе позволяет имитировать поведение человека. {% endstep %} {% step %} ### Добавьте файлы в базу знаний База знаний - полезный инструмент для хранения дополнительной информации о компании и ее продуктах. В разделе база знаний нужно нажать на кнопку **Создать** и заполнить файл базы знаний какой-то информацией о вашей компании, услугах, условиях работы или продуктах:
Для чего нужна база знаний, если есть инструкция? База знаний позволяет сократить размер инструкции, что позволяет повысить точность ответов (при большой инструкции внимание агента к деталям инструкции становится хуже) и оптимизировать стоимость диалога (т.к. чем меньше инструкция - тем дешевле диалог). {% hint style="info" %} Подробнее о настройке и всех возможностях базы знаний мы говорим в разделе **База Знаний** {% endhint %} {% endstep %} {% step %} ### Подключите канал Савви умеет интегрироваться с разными каналами, из которых он получает сообщения и куда отправляет ответы. Подробнее об интеграциях: **CRM-системы:** * [amoCRM](/ru/kanaly/crm-sistemy/amocrm.md) * [Kommo](/ru/kanaly/crm-sistemy/kommo.md) * [Битрикс24](/ru/kanaly/crm-sistemy/bitriks24.md) * [RetailCRM](/ru/kanaly/crm-sistemy/retailcrm.md) **Мессенджеры:** * [WhatsApp](/ru/kanaly/messendzhery/whatsapp.md) * [Telegram](/ru/kanaly/messendzhery/telegram.md) * [Max](/ru/kanaly/messendzhery/max.md) **Социальные сети:** * [VK](/ru/kanaly/socialnye-seti/vk.md) * [Instagram](/ru/kanaly/socialnye-seti/instagram.md)\* * Facebook\* **Чаты для сайта:** * [Jivo](/ru/kanaly/chaty-dlya-saita/jivo.md) * [Cавви Виджет](/ru/kanaly/chaty-dlya-saita/savvi-vidzhet.md) **Маркетплейсы:** * [Wildberries](/ru/kanaly/marketpleisy/wildberries.md) * [OZON](/ru/kanaly/marketpleisy/ozon.md) * [Яндекс.Маркет](/ru/kanaly/marketpleisy/yandeks.market.md) * [Авито](/ru/kanaly/marketpleisy/avito.md) **Хелпдеск-системы:** * Helpdeskeddy * [UseDesk](/ru/kanaly/khelpdesk-sistemy/usedesk.md) * [PlanFix](/ru/kanaly/khelpdesk-sistemy/planfix.md) {% endstep %} {% endstepper %} \* принадлежат компании Meta, признанной экстремистской организацией и запрещённой на территории Российской Федерации. --- # 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.suvvy.ai/ru/bystryi-start.md?ask=&goal= ``` `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.