# Диалоги

* [Запуск исходящего диалога (для автоматизации)](#zapusk-iskhodyashego-dialoga-dlya-avtomatizacii)
* [Активация бота для отдельного пользователя в отдельном канале](#aktivaciya-bota-dlya-otdelnogo-polzovatelya-v-otdelnom-kanale)
* [Активировать Телеграм-Бот для всех его пользователей](#aktivirovat-telegram-bot-dlya-vsekh-ego-polzovatelei)
* [Отправить сообщение в диалог](#otpravit-soobshenie-v-dialog)
* [Отправка сообщения пользователем Телеграм-бота v2](#otpravka-soobsheniya-polzovatelem-telegram-bota-v2)
* [Диалог с одного бота с другим](#dialog-s-odnogo-bota-s-drugim)
* [Диалог с ботом v2](#dialog-s-botom-v2)
* [Подключение функции к диалогу](#podklyuchenie-funkcii-k-dialogu)
* [Добавить роль в диалог](#dobavit-rol-v-dialog)
* [Задать вопрос боту](#zadat-vopros-botu)
* [Задать вопрос человеку по телефону](#zadat-vopros-cheloveku-po-telefonu)
* [Создание напоминаний от бота](#sozdanie-napominanii-ot-bota)
* [Постоянная память 3.0](#postoyannaya-pamyat-3.0)
* [Графовая память](#grafovaya-pamyat)
* [Отложенный запуск функции](#otlozhennyi-zapusk-funkcii)

## Запуск исходящего диалога (для автоматизации)

Функция запустит диалог нужного Вам нейро-сотрудника с клиентом в канале WhatsApp или Telegram по определённому триггеру или отложенному таймеру.

```
{
    "name": "run_external_dialog",
    "description": "The function triggers an outgoing dialog between the neuro-employee and the client",
    "parameters": {
        "type": "object",
        "properties": {
            "employee_id": {
                "type": "integer",
                "description": "Neuro-employee ID"
            },
            "token": {
                "type": "string",
                "description": "Neuro-employee Token"
            },
            "client": {
                "type": "string",
                "description": "Client's phone number or Telegram nickname. May be empty."
            },
            "hello": {
                "type": "string",
                "description": "Text of greeting for a client from a neuro-employee"
            }
        },
        "required": ["employee_id", "token", "client", "hello"]
    },
},
```

## Активация бота для отдельного пользователя в отдельном канале

Активация бота для отдельного пользователя в отдельном канале

```
{
    "name": "activate_task",
    "description": "Активирует бота для отдельного пользователя в нужном канале.",
    "parameters": {
        "type": "object",
        "properties": {
            "job_id": {
                "type": "integer",
                "description": "Номер бота"
            },
            "channel": {
                "type": "string",
                "description": "Канал, через который будет активирована задача",
                "enum": ["Telegram Bot", "Telegram", "WhatsApp"]
            },
            "user_chat_id": {
                "type": "string",
                "description": "Идентификатор пользователя"
            },
            "hello_text": {
                "type": "string",
                "description": "Текст приветствия. Может быть пустым."
            }
        },
        "required": ["job_id", "channel", "user_chat_id", "hello_text"]
    },
},

```

## Активировать Телеграм-Бот для всех его пользователей

Активировать Телеграм-Бот для всех его пользователей

```
{
    "name": "activate_telegram_bot",
    "description": "Активирует бота для всех его пользователей.",
    "parameters": {
        "type": "object",
        "properties": {
            "job_id": {
                "type": "integer",
                "description": "Номер бота"
            },
            "hello_text": {
                "type": "string",
                "description": "Текст приветствия. Может быть пустым."
            }
        },
        "required": ["job_id", "hello_text"]
    },
},
```

## Отправить сообщение в диалог

Отправить сообщение в диалог

```
{
    "name": "send_message_in_dialog",
    "description": "Отправить сообщение в диалог",
    "parameters": {
        "type": "object",
        "properties": {
            "role": {
                "type": "string",
                "enum" : ["user", "assistant"],
                "description": "С какой стороны будет сообщение. По умолчанию - user"
            },
            "bot_reply": {
                "type": "integer",
                "description": "1 - требуется ответ от бота, 0 - не требуется ответ. По умолчанию - 0"
            },
            "add_in_messages": {
                "type": "integer",
                "description": "1 - добавить данное сообщение в контекст диалога, 0 - не добавлять в контекст диалога. По умолчанию - 1"
            },
            "message": {
                "type": "string",
                "description": "Текст сообщения"
            },
            "temperature": {
                "type": "integer",
                "description": "Креативность ответа бота. Целое число от 1 до 10. По умолчанию 0."
            },
            "from_chat_id": {
                "type": "string",
                "description": "ID чата, куда отправить сообщение. Не обязательный параметр."
            },
            "limit": {
                "type": "integer",
                "description": "Максимальная длина сообщения, по умолчанию 4000 символов"
            },
        },
        "required": ["role", "bot_reply", "add_in_messages", "message", "temperature", "limit"]
    },
},
```

## Отправка сообщения пользователем Телеграм-бота v2

Отправка сообщения пользователем Телеграм-бота v2

```
{  
    "name": "telegram_bot_broadcast_message",  
    "description": "Отправка массового сообщения пользователям Telegram",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "bot_token": {  
                "type": "string",  
                "description": "Токен Телеграм-бота",  
            }, 
            "chat_ids": {  
                "type": "string",  
                "description": "Список ID пользователей, разделенных запятыми",  
            }, 
            "message": {  
                "type": "string",  
                "description": "Сообщение для отправки", 
            }, 
            "max_threads": {  
                "type": "integer",  
                "description": "Максимальное количество потоков для отправки сообщений, по умолчанию 10", 
            }
        }, 
        "required": ["bot_token", "chat_ids", "message"],  
    },  
},
```

## Диалог с одного бота с другим

Запуск автоматического диалога с нейро-сотрудником

```
{ 
    "name": "employee_dialog", 
    "description": "Диалог с ИИ сотрудником", 
    "parameters": { 
        "type": "object", 
        "properties": { 
            "employee_id": { 
                "type": "integer", 
                "description": "ID сотрудника", 
            }, 
            "task": { 
                "type": "string", 
                "description": "Описание задачи", 
            }, 
            "human_auto_answers": { 
                "type": "string", 
                "description": "Список автоматических ответов сотруднику. Каждый ответ должен быть с новой строки.", 
            }, 
        }, 
        "required": ["employee_id", "hello_text", "human_auto_answers"], 
    }, 
}, 
```

## Диалог с ботом v2

Позволяет ботам обмениваться информацией между собой по запросу.

Например. Мы хотим находить всю информацию по ИНН и после красиво по заданному шаблону оформлять все в файл ПДФ

Создадим 3 бота. №1 главный ( через него будет обращаться к другим ботам) №2 помощник ищет всю информацию по ИНН №3 помощник оформляет текст в пдф по заданным шаблонам.

Ставим задачу главному боту. Он в зависимости от контекста задачи обращается к нужному боту. Найти информацию по ИНН 12345689. Главный бот обратится к помощнику боту №2.

Далее. Оформи информацию в пдф. Главный бот обратится к помощнику боту №3.

Обращения можно делать

* текстовым запросом
* голосовым.
* запрограммировать кнопку
* Автоматизировать весь цикл (по необходимости)

```
{
    "name": "dialog_with_emploee",
    "description": "Задать вопросы сотруднику",
    "parameters": {
        "type": "object",
        "properties": {
            "emploee_id": {
                "type": "integer",
                "description": "ID сотрудника"
            },
            "token": {
                "type": "string",
                "description": "Токен сотрудника"
            },
            "messages": {
                "type": "string",
                "description": "Одно или несколько сообщений сотруднику разделенных `##`"
            }
        },
        "required": ["emploee_id", "token", "messages"]
    },
},
```

## Подключение функции к диалогу

Подключение функции к диалогу

```
{
    "name": "add_function_in_dialog",
    "description": "Добавить функцию в диалог",
    "parameters": {
        "type": "object",
        "properties": {
            "query": {
                "type": "string",
                "description": "Запрос для поиска функции"
            },
        },
        "required": ["query"]
    },
},
```

## Добавить роль в диалог

Добавить роль в диалог

```
{
    "name": "add_role_in_dialog",
    "description": "Добавить новую роль в текущий диалог",
    "parameters": {
        "type": "object",
        "properties": {
            "name": {
                "type": "string",
                "description": "Имя роли"
            },
            "role": {
                "type": "string",
                "description": "Текст роли"
            },
            "functions_ids": {
                "type": "string",
                "description": "ID функций через запятую. Не обязательный параметр."
            },
        },
        "required": ["name", "role"]
    },
},
```

## Задать вопрос боту

Задать вопрос боту

```
{
    "name": "ask_emploee",
    "description": "Задать вопрос сотруднику",
    "parameters": {
        "type": "object",
        "properties": {
            "emploee_id": {
                "type": "integer",
                "description": "ID сотрудника"
            },
            "token": {
                "type": "string",
                "description": "Токен сотрудника"
            },
            "message": {
                "type": "string",
                "description": "Вопрос или сообщение сотруднику"
            }
        },
        "required": ["emploee_id", "token", "message"]
    },
},
```

## Задать вопрос человеку по телефону

Интеграция с voximplant

```
{
    "name": "ask_question_by_phone",
    "description": "Ask a question by phone",
    "parameters": {
        "type": "object",
        "properties": {
            "employee_id": {
                "type": "integer",
                "description": "Employee ID",
            },
            "voxapikeys_url": {
                "type": "string",
                "description": "Api key file URL",
            },
            "rule_id": {
                "type": "integer",
                "description": "Rule ID",
            },
            "phone": {
                "type": "string",
                "description": "Phone number starting with country code without spaces, only numbers",
            },
            "role": {
                "type": "string",
                "description": "AI prompt for manage dialog",
            },
            "hello_text": {
                "type": "string",
                "description": "Greeting in Russian",
            },
            "voice": {
                "type": "string",
                "enum" : ["Rachel", "Thomas"],
                "description": "Voice name. `Rachel` - female voice, `Thomas` - male voice",
            },
            "report_chat_id": {
                "type": "string",
                "description": "Set '#' if not given",
            },
            "report_promt_id": {
                "type": "string",
                "description": "Set '#' if not given",
            },
        },
        "required": ["employee_id", "voxapikeys_url", "rule_id", "phone", "role", "hello_text", "voice", "report_chat_id", "report_promt_id"],
    },
},
```

## Создание напоминаний от бота

В одном диалоге можно сделать неограниченное количество напоминаний.

Пример: при общении клиент может боту сказать: ""я занят, напиши мне завтра после обеда" и бот с ним свяжется в указанное время

```
{
    "name": "bot_scheduled_message",
    "description": "Отложенное сообщение от бота для текущего диалога",
    "parameters": {
        "type": "object",
        "properties": {
            "activation_datetime": {
                "type": "string",
                "description": "Дата и время отправки сообщения в формате `%Y-%m-%dT%H:%M:%S.%fZ`"
            },
            "message": {
                "type": "string",
                "description": "Текст сообщения от бота"
            },
        },
        "required": ["activation_datetime", "message"]
    },
},
```

## Постоянная память 3.0

Функция позволяет боту запоминать что-то из диалога с пользователем. И даже после перезагрузки бот будет держать это в памяти. Через 24 часа без функции памяти бот не сможет помнить о чем был диалог вчера.

```
{ 
    "name": "ai_memory_v3", 
    "description": "Call this function when you need to make adjustments to JSON memory.", 
    "parameters": { 
      "type": "object", 
      "properties": { 
        "key": { 
          "type": "string", 
          "description": "New or existing key from JSON memory", 
        },
        "value": { 
          "type": "string", 
          "description": "Plain text to be written by the specified key", 
        },
        "action": {
            "type": "string",
            "enum": ["+", '-', '.', '_'],
            "description": "Action type. `+` - means adding information to memory. `-` - means deleting information from memory. `.` - means changing information in memory. `_` - means clear all memory",
        },
        "reply_message": { 
          "type": "string", 
          "description": "Response in case of successful operation of the function. Can be empty.", 
        },
      }, 
      "required": ["key", "value", "action", "reply_message"], 
    }, 
}, 
```

## Графовая память

Графовая память

```
{  
    "name": "user_memory",  
    "description": "User memory",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "category": {  
                "type": "string",  
                "description": "Memory category",  
            }, 
            "action": {  
                "type": "string",  
                "description": "The action to perform",  
                "enum": ["create", "read", "update", "delete"],  
            }, 
            "content": {  
                "type": "string",  
                "description": "Text to remember. Required only in `create` and `update` mode",  
            }, 
            "id": {  
                "type": "integer",  
                "description": "Memory record ID. Required only in 'delete' mode",  
            }, 
        }, 
        "required": ["category", "action"],  
    },  
},
```

## Отложенный запуск функции

Отложенный запуск функции

```
{
    "name": "bot_scheduled_function",
    "description": "Отложенное выполнение функции ботом",
    "parameters": {
        "type": "object",
        "properties": {
            "activation_datetime": {
                "type": "string",
                "description": "Дата и время отправки сообщения в формате `%Y-%m-%dT%H:%M:%S.%fZ`"
            },
            "function_id": {
                "type": "integer",
                "description": "ID функции"
            },
            "parameters": {
                "type": "string",
                "description": "Параметры для вызова функции в виде JSON-строки: `{'param_name' : 'param_value'}`"
            },
            "reply_in_dialog": {
                "type": "boolean",
                "description": "Нужно ли возвращать результат в диалог. По умолчанию `True`"
            },
        },
        "required": ["activation_datetime", "function_id", "parameters", "reply_in_dialog"]
    },
},
```


---

# Agent Instructions: 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:

```
GET https://docs.iiagent.pro/funkcii/dialogi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.