Outline — это командная база знаний и вики: документы, коллекции, полнотекстовый поиск. Коннектор «Outline» в СуперИнтеллекте даёт вашему ИИ-агенту прямой доступ к этой вики: он ищет по документам, читает и создаёт их, дозаписывает разделы, перемещает и архивирует страницы — обычными фразами в чате, по вашему API-ключу. Ниже разберём, что именно умеет агент с Outline, где взять токен и как за несколько минут подключить коннектор к ассистенту.
Зачем подключать Outline к ИИ-агенту
Обычно работа с вики выглядит так: открыть Outline, вспомнить, в какой коллекции лежит регламент, найти документ, прочитать, при необходимости отредактировать. Когда Outline подключён к ИИ-агенту, эти шаги схлопываются в одну фразу в чате. Агент сам находит нужный документ через полнотекстовый поиск, читает его, отвечает на вопрос по содержимому базы знаний и, если вы разрешили запись, создаёт или обновляет страницы.
Ключевые запросы, под которые заточена эта интеграция: «как подключить Outline к нейросети», «Outline интеграция с ИИ», «ИИ-агент для Outline». Всё это — про то, чтобы разговаривать со своей вики на естественном языке в едином окне СуперИнтеллекта, не переключаясь между вкладками.
Что умеет ИИ-агент с Outline
Коннектор Outline — это 10 инструментов, которые агент вызывает автоматически, когда понимает задачу из вашего сообщения. Работает и с облаком app.getoutline.com, и с self-hosted-инсталляцией. Вот полный набор возможностей:
- Полнотекстовый поиск по всем документам (outline_search_documents) — находит нужное по смыслу запроса, а не только по точному совпадению.
- Чтение документа и список документов (outline_get_document, outline_list_documents) — агент открывает конкретную страницу или показывает, что вообще есть в базе.
- Создание документа (outline_create_document) — новая страница из вашего описания или на основе данных из чата.
- Обновление документа, в том числе дозапись через append (outline_update_document) — агент правит текст целиком или добавляет раздел в конец, не стирая существующее.
- Перемещение и архивирование (outline_move_document, outline_archive_document) — переносит документ в другую коллекцию или убирает в архив вместо удаления.
- Список коллекций и содержимое коллекции (outline_list_collections, outline_get_collection) — агент ориентируется в структуре вашей вики.
- Встроенный ответ на вопрос по базе знаний (outline_answer_question) — агент отвечает на вопрос, опираясь на документы Outline.
Где взять API-ключ Outline
Коннектору нужны две вещи: URL вашего API Outline и API-ключ. URL — это адрес вашей инсталляции: для облака это app.getoutline.com, для self-hosted — домен, на котором развёрнут ваш Outline. API-ключ создаётся в настройках аккаунта.
- Войдите в Outline под аккаунтом, у которого есть доступ к нужным коллекциям и документам.
- Откройте Settings → API & Apps (Настройки → API и приложения).
- Нажмите New API key (Создать API-ключ), задайте название — например, «СуперИнтеллект-агент».
- Скопируйте ключ сразу: он показывается один раз. Если потеряли — создайте новый.
- Запомните URL вашего API: app.getoutline.com для облака или адрес вашего self-hosted-сервера.
Пошаговое подключение к ассистенту
Токен вставляется один раз, хранится на стороне платформы и привязывается к конкретному агенту. Сам процесс занимает пару минут.
- Откройте настройки нужного ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Outline и откройте карточку коннектора.
- Вставьте URL API и API-ключ, которые вы создали в предыдущем шаге.
- Настройте права: по умолчанию включено только чтение (read). Если агент должен создавать и обновлять документы — включите запись (write); для архивирования — delete. Оставляйте включённым только то, что реально нужно.
- Сохраните коннектор и убедитесь, что он привязан к этому ассистенту.
- В чате с ассистентом включите режим «ИИ-агент» — именно он разрешает агенту вызывать инструменты коннекторов.
Таблица: инструменты, права и где взять токен
| Что делает агент | Инструменты | Нужное право |
|---|---|---|
| Ищет по документам, читает страницу и список, отвечает на вопрос по базе | outline_search_documents, outline_get_document, outline_list_documents, outline_answer_question | read (по умолчанию) |
| Ориентируется в структуре: коллекции и их содержимое | outline_list_collections, outline_get_collection | read (по умолчанию) |
| Создаёт документы, обновляет и дозаписывает разделы, перемещает | outline_create_document, outline_update_document, outline_move_document | write |
| Архивирует документ (вместо удаления) | outline_archive_document | delete |
| Где взять доступ | URL API (app.getoutline.com или self-hosted) + API-ключ: Settings → API & Apps → New API key | — |
Примеры промптов
После подключения не нужно называть инструменты — достаточно обычной формулировки задачи. Агент сам выберет, что вызвать. Несколько рабочих примеров:
- «Найди в нашей вики регламент по онбордингу новых сотрудников и перескажи ключевые шаги.»
- «Что у нас написано про политику возвратов? Ответь со ссылкой на документ.»
- «Создай в коллекции „Продукт“ документ „Чек-лист релиза“ с разделами: подготовка, тестирование, деплой, откат.»
- «Добавь в конец документа „FAQ поддержки“ новый вопрос про сроки доставки и ответ на него.»
- «Перенеси документ „Черновик стратегии“ из коллекции „Личное“ в „Стратегия 2026“.»
- «Заархивируй устаревший регламент по старой CRM — он больше не актуален.»
Безопасность и права доступа
Главный принцип — минимально необходимые права. Начните с чтения и посмотрите, как агент справляется с поиском и ответами по базе. Запись включайте, когда действительно нужно, чтобы агент вёл документы. Архивирование (delete) — только если делегируете агенту чистку устаревших страниц.
- По умолчанию — только read: агент ничего не меняет в вашей вики.
- Write и delete включайте осознанно и по одному, а не «на всякий случай».
- API-ключ хранится на стороне платформы и привязан к конкретному ассистенту — он не «утекает» в переписку.
- Если ключ скомпрометирован — удалите его в Outline (Settings → API & Apps) и выпустите новый, затем обновите в коннекторе.
- Хотите ограничить область — заведите отдельный сервисный аккаунт Outline с доступом только к нужным коллекциям и создайте ключ под ним.
Частые вопросы
Работает ли коннектор с self-hosted Outline?
Да. Коннектор поддерживает и облако app.getoutline.com, и self-hosted-инсталляцию. При подключении вы указываете URL вашего API — для self-hosted это домен, на котором развёрнут ваш Outline.
Где именно взять API-ключ?
В Outline: Settings → API & Apps → New API key. Ключ показывается один раз — скопируйте его сразу и вставьте в карточку коннектора Outline в разделе «Интеграции» у ассистента. Если потеряли ключ, просто создайте новый.
Сможет ли агент случайно удалить документы?
Нет. Во-первых, по умолчанию включено только чтение. Во-вторых, коннектор не удаляет документы физически, а архивирует их (outline_archive_document) — документ можно восстановить из архива. Архивирование срабатывает только если вы включили право delete.
Увидит ли агент все документы вики?
Агент видит ровно то, к чему имеет доступ аккаунт, под которым выпущен API-ключ. Хотите ограничить область — создайте ключ под сервисным аккаунтом с доступом только к нужным коллекциям.
Почему агент не обращается к Outline?
Чаще всего в чате не включён режим «ИИ-агент» — без него ассистент не вызывает коннекторы. Проверьте также, что коннектор Outline сохранён и привязан к этому ассистенту, а API-ключ и URL указаны верно.
Нужно ли настраивать что-то на стороне Outline, кроме ключа?
Нет. Достаточно API-ключа и URL API. Никаких webhook'ов или дополнительных приложений в Outline настраивать не требуется — коннектор обращается к API напрямую.
Что дальше
Подключите Outline в разделе «Интеграции» у вашего ассистента, оставьте на старте только чтение и попробуйте задать вопрос по своей базе знаний. Когда убедитесь, что агент точно находит документы, включайте запись — и делегируйте ему ведение вики.
