Настройка ИИ-ассистента для рабочей области

Для кого: администраторы рабочей области (облако и локальная установка) · Время: 5 минут для встроенного ассистента, около 15 минут, чтобы подключить собственный ИИ компании

Обзор

ИИ-ассистент отвечает на вопросы о рабочей области, кратко пересказывает записи и переводит тексты — на английском, русском и узбекском. Сотрудники пользуются им в трёх местах:

• Спросить ИИ: кнопка в верхней панели (или Ctrl+J) открывает панель для вопросов, например «Какие сделки закрываются в этом месяце?». В ответах есть ссылки на отчёты и записи, из которых взяты данные.
• Кратко: в сделках, организациях, обращениях и проектах — короткая сводка: где сейчас запись, какие риски и какой следующий шаг.
• Перевести: в обращениях и статьях базы знаний — перевод на язык читателя.

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

Вы решаете две вещи: откуда берутся ответы (провайдер ИИ) и кто какими функциями пользуется. Обе настройки находятся в разделе Настройки рабочей области → ИИ-ассистент.

Перед началом

• Вы — администратор рабочей области.
• Чтобы подключить собственный ИИ компании, подготовьте его данные: URL, название модели и API-ключ, если сервис его требует. Их может дать ваша IT-служба или поставщик ИИ.

Часть 1. Выберите провайдера ИИ

Откройте Настройки рабочей области → ИИ-ассистент. В карточке Провайдер ИИ выберите один из четырёх вариантов:

При желании укажите Название ассистента — например, имя ассистента вашей компании. Оно заменит «Спросить ИИ» на кнопке в верхней панели и в панели вопросов и будет подписью к сводкам и переводам.

Затем нажмите Проверить подключение. Проверка отправляет один короткий запрос с настройками на экране (ничего не сохраняется и не учитывается в лимите) и показывает:

• Подключено за … мс и пример ответа, если всё работает;
• может ли модель читать данные пространства через инструменты. Модели без этой возможности тоже отвечают, но только на общие вопросы; им запрещено придумывать цифры.

Когда проверка прошла, нажмите Сохранить провайдера. Ассистент сразу начнёт работать через нового провайдера.

Примеры для сервисов, совместимых с OpenAI

Указывайте адрес, оканчивающийся на /v1; /chat/completions Digital Workspace добавит сам. Чтобы ассистент мог читать данные пространства, модель должна поддерживать вызов инструментов (function calling).

В облачной версии адрес должен быть публичным и начинаться с https://. Внутренние адреса не принимаются, чтобы ассистента нельзя было направить на внутренние системы. В локальной установке можно использовать внутренние адреса и http://.

Часть 2. Подключите собственного агента компании

Выберите Ваш агент, если у компании уже работает собственный ИИ-ассистент. Digital Workspace отправляет каждый вопрос, запрос на сводку и перевод на URL агента и показывает его ответ. Передайте разработчикам это описание; полный формат есть и в карточке, в блоке Что получает и возвращает ваш агент.

1. Запрос. POST с JSON: task (ask, summary, translation или test), instructions, messages (переписка), workspace (название, slug) и user (имя, язык).
2. Ответ. Верните 200 с { "answer": "…" }. Простой текст тоже подойдёт.
3. Аутентификация. API-ключ передаётся как Authorization: Bearer <ключ> или в заголовке, указанном в поле Заголовок ключа.
4. Проверка отправителя. Если ключ задан, в каждом запросе есть X-DW-Timestamp и X-DW-Signature. Подпись — это sha256= и HMAC-SHA256 в hex от метка времени + "." + тело запроса с вашим ключом. Агент должен проверять подпись и отклонять метки времени старше пяти минут.

Разрешить агенту читать данные пространства (по умолчанию выключено): если включить, запрос дополнительно содержит инструменты встроенного ассистента — отчёты, записи и статьи справки. Вместо ответа агент может вернуть { "tool_calls": [ … ] }. Digital Workspace выполняет эти инструменты от имени спрашивающего, с его правами, и отправляет результаты обратно сообщениями tool, пока агент не ответит. Агент никогда не подключается к вашей базе данных. Если переключатель выключен, агент получает только переписку, текст для сводки или перевода и имя спрашивающего.

Часть 3. Решите, кто чем пользуется

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

Эти правила действуют для любого выбранного провайдера.

Конфиденциальность и безопасность

• Ассистент видит только то, что доступно спрашивающему. Зарплаты не передаются никогда. Кадровые данные видны только тем, у кого есть доступ к HR, а конфиденциальные документы — только тем, кто может их открыть.
• API-ключи хранятся в зашифрованном виде, потом показываются только как ••••1234 и никогда не передаются в браузер. Чтобы заменить ключ, введите новый; чтобы удалить — отметьте Удалить сохранённый ключ.
• Журнал запросов внизу страницы показывает каждый запрос: когда, кто, какая функция, какие записи были прочитаны и какой провайдер ответил.

Для IT-службы: одна настройка на весь сервер (локальная установка)

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

Администраторы пространств по-прежнему могут выбрать для своего пространства другого провайдера.

Устранение неполадок