Настройка Slack
В Slack Clark работает как полноценный AI-канал, а не просто бот уведомлений. Он отвечает в личных сообщениях, реагирует на упоминания в каналах, сохраняет контекст каналов, обрабатывает файлы, отвечает в тредах и поддерживает slash-команды для частых сценариев.
Добавить Clark в workspace
- Откройте ваш Clark workspace или обратитесь к владельцу workspace.
- Установите Slack app Clark в нужный Slack workspace.
- Подтвердите запрошенные разрешения.
- Пригласите Clark в каналы, где он должен помогать.
- Упомяните Clark в канале или напишите ему личное сообщение, чтобы проверить работу.
Для внутренних/custom-инсталляций Slack app требует bot token и signing secret на backend. Production-инсталляции используют Slack OAuth, чтобы каждый клиентский workspace был привязан к своему Clark workspace.
Нужные разрешения Slack
Clark нужны разрешения, соответствующие включённым возможностям:
| Permission | Зачем нужно |
|---|---|
app_mentions:read | Отвечать, когда Clark упоминают в каналах. |
channels:history, groups:history, im:history | Сохранять контекст каналов, приватных каналов и личных сообщений. |
chat:write | Отправлять ответы и сводки. |
files:read, files:write | Скачивать и возвращать документы, изображения и созданные файлы. |
im:read, im:write | Работать в личных сообщениях. |
reactions:write | Ставить короткие реакции статуса во время обработки. |
users:read | Определять имена пользователей для памяти, задач и атрибуции. |
Event Subscriptions
Slack app должен отправлять события на:
https://api.clark.gives/api/v1/slack/events
Подпишитесь на bot events:
| Event | Поведение |
|---|---|
app_mention | Clark отвечает в канале или треде. |
message.channels | Clark сохраняет контекст публичных каналов. |
message.groups | Clark сохраняет контекст приватных каналов. |
message.im | Clark отвечает в личных сообщениях. |
reaction_added | Реакции могут использоваться как feedback-сигналы. |
Slash-команды
Настройте команды на endpoint Clark:
https://api.clark.gives/api/v1/slack/slash/{command}
| Команда | Для чего |
|---|---|
/clark <message> | Задать вопрос Clark прямо из Slack. |
/tasks | Показать задачи текущего канала. |
/tasks all | Показать задачи по подключённым чатам. |
/summary | Создать ежедневную сводку канала. |
/summary week | Создать недельную сводку канала. |
/summary all | Создать сводку по всем чатам. |
/memory | Показать запомненные сущности канала. |
Автоматические сводки
Администраторы workspace могут включить автоматические сводки в настройках чата в панели. Clark делает ежедневный /summary с понедельника по четверг в локальное время конца дня только если за последние 24 часа в канале были сообщения. Каждый понедельник в 10:00 по часовому поясу CEO/администратора Clark делает /summary week за прошлую неделю. Результат можно отправлять в Slack или приватно CEO/администратору; сводка сохраняется в Memory.
Как Clark ведёт себя в Slack
В личных сообщениях Clark отвечает на обычные сообщения. В каналах он тихо сохраняет контекст и отвечает, когда его упоминают. Если сообщение находится в треде, Clark отвечает в тред, чтобы не засорять основной канал.
Файлы обрабатываются, когда Clark явно вовлечён: упомяните Clark при загрузке файла или отправьте файл в DM.
Поддерживаемые файлы Slack
Clark может обрабатывать:
- PDF, DOCX, XLSX, CSV, TXT и похожие office-файлы;
- изображения с текстом, скриншоты, чеки, сканы, доски и фотографии;
- аудиофайлы MP3, WAV, OGG, M4A и WebM.
Результаты обработки могут включать тип документа, сводку, извлечённые сущности, историю документа и данные, которые Clark сможет использовать позже.