> ## Documentation Index
> Fetch the complete documentation index at: https://aitextura.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Профили

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

Профили — это карточки клиентов, которые ИИ-сотрудник заполняет **автоматически** прямо во время диалога. Никаких ручных действий не нужно: пока сотрудник общается с клиентом, он параллельно извлекает нужные данные и записывает их в структурированную таблицу.

Вы сами решаете, что именно собирать. Имя и язык — по умолчанию. Всё остальное — поля, которые вы настраиваете под свои задачи.

<Frame>
  <img src="https://mintcdn.com/aitextura/moFwcmvQDh_GTfp2/assets/images/ru/screenshots/profiles_1.png?fit=max&auto=format&n=moFwcmvQDh_GTfp2&q=85&s=af85b5c200c6ddfe380fdf2560bfd590" width="1200" height="739" data-path="assets/images/ru/screenshots/profiles_1.png" />
</Frame>

<CardGroup cols={2}>
  <Card title="Персона" icon="robot" href="/ru/guides/persona">
    Используйте данные профилей в инструкции сотрудника
  </Card>

  <Card title="ИИ-сотрудники" icon="users" href="/ru/guides/ai-employees">
    Управление сотрудниками и их настройками
  </Card>

  <Card title="Чаты" icon="comments" href="/ru/guides/chats">
    История диалогов с клиентами
  </Card>

  <Card title="Дашборд" icon="chart-line" href="/ru/guides/dashboard">
    Сводная аналитика по всем сотрудникам
  </Card>
</CardGroup>

<Note>
  **«Профили» — это два разных места в интерфейсе.**

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

  На этой странице описаны оба раздела.
</Note>

***

## Видео-инструкция

### Функция «Профили»

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/dZ11rzx_PrE" title="Профили — как использовать функцию" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

### Аналитика и профили

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/KOc5gB76GxA" title="Аналитика и профили в AI Textura" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

Короткое видео: как настроить поля профиля в агенте, что хранится в разделе **Профили** и как использовать собранные данные для аналитики.

***

## Настройка полей профиля

Откройте нужного ИИ-сотрудника → вкладка **Профили**. На этой вкладке вы описываете, **какие поля** профиля клиента сотрудник должен заполнять и **когда** это делать. Поля привязаны к конкретному агенту: разные сотрудники могут собирать разный набор данных.

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/38-agent-profiles.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=fbb2671a00e5014dadde01bf4debde78" alt="Вкладка «Профили» в настройках агента: список полей, типы и режим обновления" width="1440" height="900" data-path="public/screenshots/38-agent-profiles.png" />
</Frame>

Каждое поле, заданное здесь, появится отдельной колонкой в общем разделе **Профили** и будет автоматически прикрепляться к метаданным каждого чата этого сотрудника.

### Режим обновления

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

| Режим        | Когда обновляется                       | Когда использовать                                                                                                                             |
| ------------ | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Realtime** | После каждого сообщения клиента         | Если сотруднику нужно использовать данные прямо сейчас — например, обращаться к клиенту по имени или учитывать предпочтения в том же разговоре |
| **Плановая** | По расписанию (например, раз в 24 часа) | Если данные нужны только для аналитики и отчётности                                                                                            |

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

<Tip>
  Если не знаете, что выбрать — используйте **плановое обновление раз в 24 часа**. Этого достаточно для большинства сценариев и значительно экономит бюджет по сравнению с Realtime.
</Tip>

***

### Типы полей

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

| Тип          | Поведение                                 | Пример                                      |
| ------------ | ----------------------------------------- | ------------------------------------------- |
| **Variable** | Обновляется при каждом новом упоминании   | Язык, предпочтения, статус, текущий интерес |
| **Constant** | Фиксируется один раз и больше не меняется | Номер договора, дата рождения, тип клиента  |

<Warning>
  Константу нельзя изменить после первого заполнения. Если не уверены — выбирайте **Variable**.
</Warning>

***

### Параметры поля

Каждое поле состоит из четырёх параметров:

| Параметр     | Что писать                                                               |
| ------------ | ------------------------------------------------------------------------ |
| **Название** | Понятное имя поля: «Имя», «Язык», «Статус обращения»                     |
| **Описание** | Инструкция для ИИ — когда и что заполнять. Это **самый важный параметр** |
| **Ключ**     | Генерируется автоматически, менять не нужно                              |
| **Тип**      | Variable или Constant                                                    |

<Warning>
  **Описание поля — ключевой момент.** Пишите его **от лица клиента**: не «когда клиент называет язык», а «язык, на котором я общаюсь». Чем точнее описание — тем точнее сотрудник понимает, в какой момент заполнять поле.

  Также укажите формат ответа. Например: «да/нет» или «выбери один из вариантов: русский, английский, другой». Без этого сотрудник может записать произвольный текст, который будет сложно анализировать.
</Warning>

***

### Как добавить поле

<Steps>
  <Step title="Откройте вкладку «Профили»">
    Перейдите в карточку нужного ИИ-сотрудника и выберите вкладку **Профили**.
  </Step>

  <Step title="Добавьте новое поле">
    Нажмите кнопку добавления нового поля.
  </Step>

  <Step title="Введите название">
    Задайте понятное имя — например, «Имя», «Язык», «Бюджет».
  </Step>

  <Step title="Заполните описание">
    Подробно опишите **от лица клиента**, когда и что заполнять. Укажите формат ответа.
  </Step>

  <Step title="Выберите тип">
    **Variable** — если значение может меняться. **Constant** — если фиксируется один раз.
  </Step>

  <Step title="Сохраните">
    Повторите для каждого нужного поля. Количество полей не ограничено.
  </Step>
</Steps>

<Tip>
  Рекомендуется добавлять только те поля, которые действительно нужны — это повышает точность заполнения и экономит токены.
</Tip>

***

### Примеры полей

<Accordion title="Посмотреть примеры настройки полей">
  | Поле           | Тип      | Описание для ИИ                                                                          |
  | -------------- | -------- | ---------------------------------------------------------------------------------------- |
  | Имя            | Variable | Моё имя                                                                                  |
  | Язык           | Variable | Язык, на котором я общаюсь. Выбери один вариант: русский, английский, другой             |
  | Предпочтения   | Variable | Предпочтения или пожелания, которые я упомянул. Обновлять при каждом упоминании          |
  | Жалоба         | Variable | Когда я говорю о любой проблеме. Описать кратко, не более четырёх слов. Обновлять всегда |
  | Статус         | Variable | Текущий статус обращения. Выбери один вариант: новый, в работе, решён                    |
  | Бюджет         | Variable | Когда я говорю о бюджете или сумме. Записать число                                       |
  | Номер договора | Constant | Номер договора или бронирования, который я назвал                                        |
  | Резюме         | Variable | Два предложения о чём диалог. Смотреть по всей истории. Всегда обновлять                 |

  Это примеры — набор полей полностью зависит от вашего бизнеса и того, что важно отслеживать.
</Accordion>

***

## Поля профиля и метаданные чата

Поля, настроенные на вкладке **Профили** агента, автоматически попадают в **метаданные каждого чата** этого сотрудника. Это значит:

* В разделе **Профили** (левое меню) вы видите эти поля как столбцы таблицы.
* В Персоне можно ссылаться на эти поля как на переменные — сотрудник подставит значения прямо в диалог (см. [Персона](/ru/guides/persona)).
* В чатах метаданные доступны через меню действий чата → «Профиль клиента».

### Какие типы полей бывают

| Тип поля в настройке               | Хранится в метаданных как                                    | Пример                                                                    |
| ---------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------- |
| Текст (Variable)                   | Свободный текст                                              | `Имя`, `Город`, `Резюме`                                                  |
| Текст с форматом ответа (Variable) | Один из заданных вариантов                                   | `Язык: русский / английский / другой`, `Статус: новый / в работе / решён` |
| Текст (Constant)                   | Фиксированное значение, не меняется после первого заполнения | `Номер договора`, `Дата рождения`                                         |
| Число (Variable)                   | Числовое значение                                            | `Бюджет`, `Количество гостей`                                             |
| Краткое описание (Variable)        | Несколько слов или одно предложение                          | `Жалоба` (≤ 4 слов), `Резюме` (2 предложения)                             |

<Tip>
  Тип поля задаётся не явным селектором, а через **формулировку описания** для ИИ. В описании укажите, в каком формате нужен ответ — «выбери один из вариантов: …», «запиши число», «не более четырёх слов» — и сотрудник будет придерживаться этого формата при записи в метаданные.
</Tip>

***

## Аналитика профилей

Раздел **«Профили»** в левом меню платформы — это аналитический инструмент. Здесь хранятся заполненные карточки всех клиентов по всем сотрудникам.

<Frame>
  <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/50-profiles.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=43a033e067fb5538f3c6dab4a6e7dde7" alt="Раздел «Профили»: KPI-плашки, вкладки представлений и таблица данных" width="1440" height="900" data-path="public/screenshots/50-profiles.png" />
</Frame>

### KPI-плашки

В верхней части страницы расположены четыре сводные карточки:

| Показатель         | Что показывает                                                                   |
| ------------------ | -------------------------------------------------------------------------------- |
| **Всего профилей** | Общее количество клиентов за всё время                                           |
| **Заполненность**  | Средний процент заполненности полей — насколько полно сотрудник извлекает данные |
| **За неделю**      | Новые профили за текущую неделю                                                  |
| **За месяц**       | Новые профили за текущий месяц                                                   |

### Вкладки представлений

Над таблицей расположены вкладки:

* **Все данные** — стандартный вид со всеми полями всех сотрудников.
* **Сохранённые представления** — пользовательские «вью» с заранее настроенными фильтрами, столбцами и сортировкой. Удобно, когда у вас несколько сценариев анализа: «Лиды по отелю», «Жалобы за неделю», «Заявки в работе».

<Tip>
  Создайте собственное представление: настройте фильтры и порядок столбцов под нужную задачу, затем сохраните — и в следующий раз откроете его одним кликом.
</Tip>

### Таблица профилей

Каждая строка — один клиент. Стандартные столбцы: профиль, сотрудник, Chat ID, имя, язык, резюме. Плюс все пользовательские поля, которые вы настроили на вкладке **Профили** в каждом агенте (например, `отрасль бизнеса`, `цель приобретения сервиса`).

<Frame>
  <img src="https://mintcdn.com/aitextura/ZqV6039fSNcB60qj/public/screenshots/81-profiles-detail.png?fit=max&auto=format&n=ZqV6039fSNcB60qj&q=85&s=ed6726b58ecd1c7eee7d0c7b60c95695" alt="Детальный вид профиля клиента: все поля, история, переход в чат" width="1440" height="900" data-path="public/screenshots/81-profiles-detail.png" />
</Frame>

Возможности таблицы:

* **Фильтрация по сотруднику** — смотрите данные отдельного сотрудника или филиала
* **Поиск** по имени, содержимому полей, любому тексту
* **Переход в чат** — нажмите на Chat ID, чтобы открыть полную историю диалога
* **Управление столбцами** — скрывайте ненужные колонки
* **Drag-and-drop порядок столбцов** (новинка v2.1.0) — перетаскивайте заголовки колонок мышью, чтобы расположить их так, как удобно именно вам. Изменённый порядок сохраняется в текущем представлении
* **Режимы отображения** — переключайтесь между видами **Карточки** и **Таблица**

<Tip>
  Если поле не заполняется — проверьте его описание в настройках сотрудника. Скорее всего, ИИ не понимает, когда именно нужно записывать данные.
</Tip>

***

## Использование в Персоне

Данные из профилей можно использовать прямо в инструкции сотрудника — через **переменные профиля** в разделе [Персона](/ru/guides/persona). Например, если известно имя клиента, сотрудник может обращаться к нему персонально прямо во время диалога.

Это позволяет создавать по-настоящему персонализированное общение: учитывать предпочтения, адаптировать стиль и предлагать релевантные решения на основе собранных данных.

***

## Частые вопросы

<Accordion title="Realtime дороже планового?">
  Да, значительно. Realtime обновляет профиль после каждого сообщения и расходует заметно больше токенов. Плановый режим обрабатывает данные пакетами — это экономичнее.
</Accordion>

<Accordion title="Можно ли изменить значение константы?">
  Нет. В этом и суть типа Constant — значение фиксируется один раз и не меняется. Если не уверены, лучше выбрать Variable.
</Accordion>

<Accordion title="Профили общие для всех сотрудников?">
  Нет, каждый сотрудник ведёт собственные профили клиентов.
</Accordion>

<Accordion title="Сколько полей можно добавить?">
  Количество не ограничено, но рекомендуется добавлять только действительно нужные поля — это повышает точность и снижает расход токенов.
</Accordion>
