Руководство пользователя

Инструкция по работе с программным обеспечением

Программное обеспечение «Веридион» / Veridion

Версия ПО: 1.0. Формат поставки: on-premises (в инфраструктуре заказчика).

Правообладатель: АО «Веридион». Редакция документа: 1.0.

1 Назначение инструкции и условия работы

Инструкция описывает работу пользователя в веб-интерфейсе Veridion: подготовку данных, настройку агентов, постановку задач, ведение бесед и получение результатов. ПО установлено в инфраструктуре заказчика. Для работы необходимы устройство с веб-браузером, сетевой доступ к этому экземпляру Veridion и действующая учётная запись. Адрес системы и порядок предоставления доступа сообщает администратор организации. Установка серверных компонентов пользователем не требуется.

Модели в поставку Veridion не входят. Их подключает заказчик; для подготовки ответов и обработки данных необходимы соответствующие совместимые модельные сервисы.

Доступные разделы, интеграции, модели и ограничения загрузки определяются составом установленного экземпляра, настройками рабочего пространства и правами пользователя. Если элемент управления отсутствует, сначала проверьте выбранное пространство и доступность функции у администратора. Названия команд ниже приведены для русского интерфейса. На узком экране часть навигации переносится в нижнюю панель и дополнительные меню.

Основные понятия:

• Рабочее пространство — область совместной или личной работы с собственными данными и ресурсами.
• База знаний — коллекция документов, которые агент использует при подготовке ответов.
• Агент — настроенный исполнитель с определёнными источниками, инструментами и инструкциями.
• Навык — повторно используемая инструкция для агента с правилами выполнения работы.
• Беседа — последовательность сообщений с агентом в общем контексте.
• Задача — сохранённое поручение агенту, запускаемое вручную или по расписанию. Каждый запуск образует отдельную сессию.
• Результат — сохранённый файл либо другой материал, созданный в ходе работы.

2 Вход регистрация и завершение работы

Вход в систему

1. Откройте адрес Veridion, полученный от администратора.
2. В поле Почта укажите адрес своей учётной записи и нажмите Продолжить.
3. На шаге Введите пароль заполните поле Пароль и нажмите Войти.
4. После загрузки приложения проверьте название текущего рабочего пространства.

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

Создание учётной записи

Если самостоятельная регистрация разрешена и указанная почта ещё не зарегистрирована, интерфейс предложит задать пароль и заполнить профиль. Выполните требования к паролю, указанные в форме, заполните сведения и завершите регистрацию. В режиме регистрации по приглашениям используйте выданную ссылку. Если приложение сообщает, что требуется приглашение, обратитесь к администратору.

Восстановление пароля

1. На шаге ввода пароля нажмите Не помню пароль.
2. Укажите почту учётной записи и отправьте запрос на восстановление.
3. Откройте полученное письмо и перейдите по ссылке.
4. На странице Сброс пароля заполните поля Новый пароль и Повторите новый пароль, затем подтвердите изменение.
5. Вернитесь на страницу входа и войдите с новым паролем.

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

Для завершения работы откройте меню аккаунта и выберите Выйти. Перед выходом сохраните изменения в открытых формах и дождитесь окончания передачи файлов. Если система запросила повторный вход, авторизуйтесь заново.

3 Выбор рабочего пространства и навигация

Личное пространство создаётся для пользователя автоматически. Общее пространство предназначено для совместной работы. Задачи, агенты, проекты и другие ресурсы относятся к выбранному пространству.

Для переключения нажмите название текущего пространства в нижней части боковой панели и выберите нужное. Полный список находится в Аккаунт → Рабочие пространства. Перед переключением сохраните незавершённые изменения. После перехода проверьте название пространства ещё раз, прежде чем загружать документы или создавать задачу.

Основные разделы:

• Главная — быстрый запуск задач, обновления и недавние результаты.
• Задачи — доска или список поручений, статусы и история выполнения.
• Агенты — настройка исполнителей и навыков.
• Данные — базы знаний, интеграции и специализации.
• Результаты — библиотека сохранённых материалов.
• Проекты — группировка связанных задач, бесед и результатов.
• Встречи — запись, загрузка и расшифровка разговоров, если функция включена.
• Аккаунт — личные сведения, настройки и управление доступными пространствами.

4 Подготовка базы знаний

Создание и загрузка документов

1. Откройте Данные → Базы знаний.
2. Нажмите Создать базу знаний, введите название и нажмите Сохранить.
3. В открытой базе нажмите Загрузить документы и выберите файлы либо перетащите их в область загрузки.
4. Дождитесь завершения передачи. Ход фоновых операций отображается в панели Загрузки. При частичной ошибке проверьте, какие файлы добавлены, и повторите загрузку остальных.
5. Проверьте состояние подготовки каждого документа.

Система принимает распространённые форматы текстовых документов, PDF, презентаций, изображений и электронных таблиц. Допустимый формат и размер проверяются при загрузке. Для таблиц и отдельных других форматов работа с содержимым выполняется непосредственно как с файлом; обычное извлечение поисковых фрагментов для них может не требоваться.

Обработка документов

Для файлов, требующих извлечения содержимого, доступны состояния Не запущен, В очереди, Обрабатывается, Успешно, Ошибка и Прервано.

1. Если файл имеет состояние Не запущен, откройте его меню и выберите Начать парсинг.
2. Для нескольких файлов выделите их и используйте действие Парсинг → Запустить.
3. Для подготовки всей базы используйте действие запуска у общего индикатора обработки.
4. Дождитесь успешного завершения. При ошибке прочитайте её описание и устраните причину перед повторным запуском.

Обработка большого документа может занимать значительное время. Появление файла в списке подтверждает загрузку оригинала; возможность поиска по извлечённому содержимому возникает после успешной обработки соответствующего формата.

Просмотр и обслуживание

Откройте файл из списка для просмотра поддерживаемого формата. В его меню доступны действия с учётом прав пользователя: скачивание, получение ссылки, перемещение, запуск или остановка обработки, удаление. Выделение нескольких файлов позволяет применять групповые действия, в том числе скачивание архивом.

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

Для изменения названия базы используйте Переименовать в меню её карточки. Если требуется заменить документ, загрузите актуальную редакцию и проверьте её готовность; затем удалите устаревшую копию, если она больше не нужна. Присутствие нескольких редакций учитывайте при формулировании запроса.

Предоставление доступа

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

Общий доступ к базе предоставляет чтение и использование доступного содержимого при поиске. Управление файлами и разрешениями определяется правами владельца. Копирование ссылки на документ само по себе новых прав не выдаёт. Для прекращения общего доступа отзовите соответствующее разрешение в окне Доступ.

5 Подключение интеграций и специализаций

Интеграции связывают Veridion с внешними сервисами и источниками. Специализации предоставляют предметные источники и инструменты. Состав каталога зависит от конфигурации и разрешений пространства.

1. Откройте Данные → Интеграции либо Данные → Специализации.
2. На вкладке Доступные выберите нужную карточку.
3. Ознакомьтесь с назначением и нажмите Добавить интеграцию.
4. Заполните предлагаемые параметры. Если открыт внешний сервис, выполните вход и подтвердите требуемые разрешения.
5. Вернитесь в Veridion и проверьте подключение на вкладке Подключенные, включая состояние синхронизации и возможную ошибку.
6. Назначьте подключённый источник нужному агенту в его настройках.

Для управляемых источников личные реквизиты могут не требоваться. Параметры кастомной интеграции вводите по инструкции администратора. Полномочия внешнего подключения ограничиваются правами использованной учётной записи и выданными разрешениями.

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

6 Создание и настройка агента

1. Откройте Агенты и нажмите Создать агента.
2. Укажите название роли и краткое описание назначения.
3. Выберите доступные базы знаний, интеграции и специализации.
4. Настройте поиск в интернете, если он нужен и доступен.
5. Подключите необходимые навыки. Если предоставлен выбор модели, проверьте его до сохранения.
6. Проверьте сводку настроек и нажмите Создать агента.

Созданный агент появляется в списке исполнителей. Чтобы изменить доступные настройки, нажмите на карточку агента или кнопку с шестерёнкой, внесите изменения и сохраните их. Изменения источников и навыков влияют на последующие обращения. Выбирайте источники, соответствующие роли агента.

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

7 Работа с навыками

Создание собственного навыка

1. В разделе Агенты найдите блок Навыки и нажмите Создать навык.
2. Укажите уникальное название из строчных латинских букв, цифр, дефисов или нижних подчёркиваний.
3. Заполните краткое описание: когда применять навык и какой результат он должен давать.
4. В поле Содержимое навыка укажите входные данные, последовательность действий, ограничения и требования к результату.
5. При необходимости добавьте файлы-референсы в пределах ограничений формы.
6. Нажмите Создать.

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

Использование и изменение

Системные и полученные по общему доступу навыки могут быть доступны только для просмотра и применения. В собственном навыке измените доступные поля и нажмите Сохранить. Изменение инструкции учитывайте для всех агентов, которым она назначена. Отключение навыка в настройках агента сохраняет сам навык.

При наличии соответствующих команд можно загрузить готовый навык из ZIP-архива с файлом SKILL.md в корне либо установить его по точному пути из каталога навыков. Перед установкой проверьте назначение и необходимые инструменты. Для загрузки используйте Загрузить из архива, для каталога — Установить в форме установки. Доступность каталога и ограничения пакета определяются экземпляром системы.

Пароли и токены в содержимое навыка не включаются. Для доступа к внешнему сервису используйте предусмотренное подключение.

8 Беседа с агентом

1. Выберите агента в блоке Мои агенты и нажмите Создать беседу.
2. Сформулируйте вопрос или поручение. Укажите требуемый результат, исходные данные и ограничения.
3. При необходимости прикрепите файлы с устройства или выберите доступные документы базы знаний.
4. Дождитесь окончания загрузки вложений и отправьте сообщение.
5. Следите за ответом и ходом выполнения. Если агент запрашивает уточнение, заполните предложенную форму и отправьте ответ.
6. Проверьте ответ и приведённые ссылки на источники. Для уточнения продолжите ту же беседу; для независимой темы создайте новую.

Пример поручения: «На основе подключённой базы знаний подготовь краткое описание порядка обработки обращения клиента. Укажи документы-источники. Если данных недостаточно, перечисли недостающие сведения».

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

9 Создание и выполнение задачи

Однократная задача

1. Откройте Задачи и нажмите Создать задачу.
2. Заполните поручение: цель, материалы, ограничения и ожидаемый результат.
3. Добавьте вложения и дождитесь завершения их загрузки.
4. При необходимости воспользуйтесь Улучшить промпт, затем проверьте полученный текст.
5. Выберите Формат результата и исполнителя в поле Кто выполнит.
6. Выберите режим Один раз, при необходимости — проект и приоритет.
7. Оставьте Запустить сразу включённым и нажмите Создать и запустить. Чтобы сначала сохранить поручение, выключите этот параметр и нажмите Создать.

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

Формат результата является пожеланием к оформлению. Создание конкретного файла или представления зависит от поручения, доступных инструментов и успешности выполнения.

Задача по расписанию

В форме создания выберите Регулярно, задайте периодичность, время и часовой пояс. Проверьте итоговое описание расписания. При необходимости отдельно включите Запустить сразу для первого выполнения. Последующие сессии будут создаваться согласно сохранённому расписанию. В настройках существующей задачи расписание можно изменить; для однократной задачи при доступности используйте Сделать регулярной.

Контроль выполнения

На доске и в карточке используются состояния Не начато, Запускается, В работе, Нужно решение, Завершено, Ошибки и Отменено. Во время выполнения лента событий обновляется автоматически и показывает действия агента, обращения к инструментам и промежуточные материалы.

При состоянии Нужно решение откройте задачу, заполните обязательные поля запроса агента и отправьте ответ. Для остановки активной сессии нажмите Прервать. После ошибки прочитайте причину, проверьте параметры и используйте Перезапустить. Для нового выполнения завершённой задачи нажмите Запустить ещё раз.

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

Задачи можно искать по названию, фильтровать, просматривать как доску или список. Действие Удалить переносит задачу в архив; найти её можно через фильтр Архив. Для выполняющейся задачи интерфейс может предложить Прервать и удалить.

10 Просмотр и сохранение результатов

В завершённой задаче прочитайте финальный ответ и откройте созданные материалы. Для продолжения обсуждения нажмите Написать в чат: будет использован контекст соответствующей сессии.

Кнопка Скачать в карточке задачи может предлагать Сформировать .pdf, Сформировать .docx, Сформировать .md и Все файлы (.zip). Формирование документа использует последнее сообщение агента выбранной сессии. Архив содержит созданные результаты, если они есть; исходные вложения задачи в него не включаются.

В разделе Результаты:

1. Найдите материал в блоке Недавнее или полном списке.
2. При необходимости примените фильтры по автору и типу.
3. Откройте карточку или строку для просмотра.
4. Для файла выберите Скачать в меню материала.
5. Если доступна команда Продолжить в чате, используйте её для уточнения или переработки результата.

Библиотека содержит отдельно сохранённые материалы. Обычный текстовый ответ не обязательно создаёт самостоятельный элемент библиотеки. Возможности предварительного просмотра и скачивания зависят от типа результата. Перед удалением сохраните нужную файловую копию.

11 Группировка работы в проекты

Откройте Проекты, нажмите Создать проект, укажите название и цвет, затем нажмите Создать. На странице проекта запускайте связанные задачи или выбирайте проект в общей форме создания задачи.

Страница проекта собирает связанные задачи, результаты и Чаты агентов. Для просмотра полного набора задач используйте Показать все. Проект помогает организовать работу внутри пространства; доступ к исходным данным определяется настройками пространства и агента.

12 Встречи память и проактивные обновления

Эти возможности используются при их доступности в установленном экземпляре.

Встречи

1. Откройте Встречи и нажмите Загрузить запись.
2. Выберите аудио- или видеофайл разрешённого формата, задайте название и при необходимости количество голосов.
3. Нажмите Запустить расшифровку и дождитесь состояния Расшифровано.
4. Откройте встречу, прослушайте запись и проверьте вкладки Текстовая расшифровка и Саммари.
5. При необходимости уточните имена участников и скачайте расшифровку.
6. Для дальнейшей работы нажмите Поставить задачу, если саммари готово.

При наличии функции записи разрешите приложению доступ к микрофону, запишите встречу и завершите запись средствами интерфейса. Точность распознавания зависит от качества записи. Проверьте существенные имена, числа и поручения. Архивирование встречи может удалять запись и результаты обработки; перед подтверждением внимательно прочитайте предупреждение.

Память

В Аккаунт → Память можно просмотреть сохранённый долгосрочный контекст, записи и связи. Для исправления сообщите агенту точное сведение и попросите обновить память, затем проверьте результат. При наличии прав команда Забыть исключает запись из активной памяти. Она не удаляет исходные беседы, задачи или файлы. В общем пространстве память относится к совместной рабочей области.

Пульс

Во вкладке Пульс блока Обновления на Главной отображаются проактивно подготовленные находки. Откройте находку для просмотра подробностей. Если доступны предложения задач, изучите их и используйте Запустить или Отклонить. Команда Написать в чат позволяет обсудить находку с агентом. Содержание Пульса зависит от подключённых источников и настроек фонового агента.

13 Настройки и доступ участников

В Аккаунте редактируются доступные сведения профиля; в Настройках выбираются параметры интерфейса. Для изменения пароля используйте форму с текущим паролем, новым паролем и подтверждением.

Чтобы создать общее пространство, откройте Аккаунт → Рабочие пространства → Создать пространство, задайте название и оформление, затем нажмите Создать.

Для приглашения участника:

1. Убедитесь, что у него уже есть зарегистрированный аккаунт с нужным адресом почты.
2. В меню общего пространства выберите Добавить участников.
3. Укажите почту и нажмите Отправить приглашение.
4. Получатель входит под этой почтой и выбирает Принять приглашение в списке пространств либо на странице приглашения.
5. При необходимости измените роль принятого участника на вкладке Участники.

Используются роли Владелец, Администратор и Гость. Набор управляющих действий зависит от роли. Владелец управляет передачей прав и удалением общего пространства. Для прекращения доступа участника используйте Закрыть доступ. Если доступна административная команда Добавить с ролью, она предоставляет доступ сразу без принятия приглашения.

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

14 Ограничения и решение типовых проблем

Скорость выполнения зависит от объёма данных, сложности поручения и доступности подключённых сервисов. Ответы формируются с использованием языковых моделей и требуют проверки пользователем: возможны неточности, неполнота и ошибки интерпретации. Для ответственных выводов сопоставляйте результат с первичными документами и актуальностью источников.

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