> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/functions/sending-result/python-v.2/shablony-python-script.md).

# Шаблоны Python Script

При добавлении действия **Python Script** автоматически открывается модальное окно с выбором готового шаблона. Выберите шаблон, который ближе всего к вашей задаче, и нажмите **«Использовать шаблон»**.

Шаблон заполнит редактор стартовым кодом — его можно изменить под свои нужды в ручную или с помощью **редактора кода с ИИ**.

| Шаблон                             | Что делает                                                                                                |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Базовый скрипт**                 | Стандартный пример v2 с args, debug, stdout и result. Отправная точка для любого скрипта.                 |
| **Вернуть результат в AI**         | Готовит structured tool\_result, который модель использует для финального ответа.                         |
| **Отправить сообщение напрямую**   | Отправляет ответ в мессенджер без дополнительной генерации через LLM.                                     |
| **Промолчать**                     | Выполняет side-effects и завершает flow без сообщения клиенту.                                            |
| **Действия с диалогом**            | Ставит на паузу, возобновляет, блокирует, добавляет теги, планирует delayed messages и уведомляет админа. |
| **Чтение и запись переменных**     | Читает переменные агента / диалога из args и записывает их обратно плоским патчем variables.              |
| **Интеграция с внешним API**       | Отправляет заявку во внешнюю систему (CRM / webhook) через HTTP POST с авторизацией.                      |
| **Квалификация лида**              | Считает балл лида, обновляет переменные и теги, эскалирует горячие лиды менеджеру.                        |
| **Проверка рабочего времени**      | Автоответ в нерабочее время и follow-up на начало ближайшего рабочего окна.                               |
| **Валидация контактных данных**    | Валидирует и нормализует телефон / email и записывает их обратно в form\_data.                            |
| **Извлечение данных из сообщения** | Достаёт номер заказа, email и телефон из текста через regex и сохраняет в переменные.                     |
| **Отправить галерею файлов**       | Отправляет клиенту несколько изображений и документ одним действием send\_message.                        |
| **База знаний (FAQ)**              | Ищет ответ по ключевым словам и отвечает напрямую либо передаёт вопрос LLM.                               |
| **Расчёт стоимости заказа**        | Считает сумму, скидку и доставку и отправляет клиенту разбивку стоимости.                                 |

{% hint style="info" %}
Если ни один шаблон не подходит — выберите **«Базовый скрипт»** и опишите задачу в панели **«Генерация кода с ИИ»**. ИИ предложит готовый вариант на основе вашего описания.
{% endhint %}


---

# 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://doc.nextbot.ru/functional/functions/sending-result/python-v.2/shablony-python-script.md?ask=<question>&goal=<endgoal>
```

`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.