Руководство по настройке
Создайте админ-аккаунт для знаний, подключите Notion, Slack и Google Drive через MCP, проверьте источники и разверните агента. Ранний доступ.
На этой странице
Ранний доступ / предпросмотр. Это руководство описывает текущий процесс настройки. Экраны и параметры коннекторов могут измениться до общего релиза.
Это руководство проведёт вас от нуля до работающего обоснованного агента: создание админ-аккаунта, подключение знаний через MCP-коннекторы, проверка индексации и развёртывание агента в веб-виджете, Slack или через API. Дополняет справочник Agent API.
1. Создайте админ-аккаунт для знаний
Перейдите на admin.praktickai.app и зарегистрируйтесь по рабочей почте. В консоли администратора вы управляете коннекторами, источниками знаний, API-ключами и ограничениями (guardrails). Первое рабочее пространство создаётся автоматически; пригласите коллег в Настройки → Участники.
В качестве владельца рабочего пространства используйте общий командный адрес (например, ai-admin@вашакомпания.ru), чтобы доступ пережил кадровые изменения.
2. Разберитесь в MCP-коннекторах
MCP (Model Context Protocol) — открытый стандарт для подключения ИИ-ассистентов к внешним инструментам и данным. Вместо экспорта файлов вы один раз авторизуете коннектор, и PraktickAI читает контент вживую, соблюдая предоставленные разрешения. Коннекторы для знаний работают только на чтение: агент индексирует и цитирует контент, но никогда его не редактирует.
| Коннектор | Что читает | Авторизация | Область для предоставления |
|---|---|---|---|
| Notion | Выбранные страницы и базы | OAuth | Чтение контента общих страниц |
| Slack | Выбранные публичные каналы | OAuth (установка бота) | Чтение сообщений в выбранных каналах |
| Google Drive | Выбранные папки и документы | OAuth | Доступ только для чтения к выбранным файлам |
Предоставляйте минимально необходимую область. Поделитесь одним teamspace в Notion, добавьте бота Slack только в нужные каналы и выберите конкретные папки Drive вместо всего аккаунта.
3. Подключите Notion
В консоли администратора откройте Коннекторы → Notion → Подключить и завершите OAuth. На экране согласия Notion выберите только те страницы или базы, которые агенту разрешено читать. В консоли они появятся как доступные ресурсы.
Коннекторы → Notion → Подключить → (Notion OAuth) → выбрать страницы → Сохранить4. Подключите Slack
Откройте Коннекторы → Slack → Подключить и установите бота PraktickAI в рабочее пространство. Пригласите бота в каждый нужный канал командой `/invite @PraktickAI`. Читаемы только каналы, где бот является участником.
/invite @PraktickAI # выполните в каждом канале для индексации5. Подключите Google Drive
Откройте Коннекторы → Google Drive → Подключить и авторизуйтесь через свой аккаунт Google. В выборе папок укажите конкретные папки или документы — коннектор запрашивает доступ только для чтения и никогда не изменяет ваши файлы.
6. Добавьте и проверьте источники
Для каждого авторизованного коннектора добавьте конкретный ресурс как источник знаний в Знания → Добавить источник (или через `POST /v1/agent/knowledge/sources/`). Каждый новый источник начинает в статусе `syncing` и переходит в `synced` после индексации.
curl https://api.praktickai.app/v1/agent/knowledge/sources/ \
-H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxx"Убедитесь, что источник показывает `status: synced` и ненулевое число `documents`, затем задайте тестовый вопрос в Знания → Playground и подтвердите, что ответ ссылается на ожидаемый источник.
Если источник остаётся пустым, перепроверьте, что разрешение бота/OAuth действительно покрывает этот контент — самая частая проблема в том, что бот Slack не приглашён в канал или страница Notion не открыта интеграции.
7. Разверните агента
Когда источники синхронизированы, разверните агента через один или несколько каналов:
| Канал | Как | Подходит для |
|---|---|---|
| Веб-виджет | Скопируйте сниппет из Развёртывание → Веб-виджет на свой сайт | Помощь клиентам на вашем сайте |
| Slack | Включите Развёртывание → Slack, чтобы коллеги упоминали агента через @ | Внутренние вопросы-ответы по знаниям компании |
| API | Вызывайте `POST /v1/agent/messages/` из бэкенда | Собственные приложения и существующие чат-интерфейсы |
<script
src="https://admin.praktickai.app/widget.js"
data-agent-key="pub_xxxxxxxxxxxx"
async
></script>Веб-виджет использует публичный ключ (`pub_...`), а не ваш секретный API-ключ. Его безопасно встраивать в браузер, и он позволяет только отправлять сообщения вашему агенту.
8. Проверяйте ответы и настройте ограничения
В разделе Guardrails вы управляете поведением агента, когда он не уверен. Рекомендуемые значения по умолчанию для нового развёртывания:
- Только с обоснованием: отказываться отвечать, когда ни один источник не подходит, вместо догадок.
- Запасное сообщение: дружелюбное "Передам это коллеге", когда grounded равно false.
- Передача человеку: почтовые ответы с низкой уверенностью направлять в черновик (см. порог автоотправки в Email API).
- Журнал проверки: первые недели просматривайте журнал ответов и отмечайте неудачные, что настраивает поиск.
Начните консервативно — ответы только с обоснованием и высокий порог автоотправки писем — и ослабляйте настройки по мере того, как журнал ответов покажет надёжность агента.
Готово — ваш агент теперь отвечает из подключённых знаний. Продолжите справочником Agent API для собственного решения или справочником Email API для автоматизации ответов из почты.