Руководство по App Slack
OOMOL позволяет один раз подключить workspace Slack, а затем сделать авторизованные инструменты Slack доступными поддерживаемым AI-агентам и повторно используемым Skills через одобренные вызовы инструментов. В этом руководстве описано, как установить и подключить App Slack, какие разрешения Slack использует OOMOL, что можно делать со Slack, как устранять распространённые проблемы и как удалить App.
OOMOL требует, чтобы пользователи вошли в систему перед подключением внешних аккаунтов. Чтобы установить App Slack, войдите в OOMOL, откройте страницу подключения Slack и выберите Connect, чтобы запустить поток OAuth-авторизации Slack.
Предварительные требования
- Аккаунт OOMOL.
- Аккаунт Slack в workspace, который вы хотите подключить.
- Разрешение устанавливать или авторизовать apps Slack в этом workspace.
- Доступ к OOMOL Console по адресу https://console.oomol.com/.
- Если ваш workspace Slack ограничивает установку apps, владельцу или администратору workspace Slack может потребоваться одобрить App OOMOL до того, как вы сможете её авторизовать.
Добавление App
- Войдите в OOMOL Console.
- Откройте Slack в App Connections или откройте App Connections и найдите Slack.
- Выберите Slack, затем выберите Connect.
- OOMOL перенаправит вас в Slack. Войдите в Slack, если появится запрос.
- Выберите workspace Slack, который хотите подключить, если Slack попросит выбрать его.
- Проверьте экран авторизации Slack, включая запрашиваемые разрешения.
- Выберите Allow, чтобы авторизовать OOMOL.
- После перенаправления из Slack обратно в OOMOL убедитесь, что Slack отображается как подключённый в ваших подключениях OOMOL.
Если какой-либо шаг завершился ошибкой, см. Устранение неполадок.
После авторизации OOMOL сохраняет подключение, необходимое для вызова инструментов Slack от вашего имени. Затем вы можете использовать инструменты Slack из поддерживаемых OOMOL агентов и повторно используемых Skills через одобренные вызовы инструментов.
Что OOMOL делает в Slack
App OOMOL Slack делает действия Slack доступными после подключения workspace. В зависимости от выполняемого действия OOMOL может читать каналы и треды, доступные подключённому app, публиковать сообщения от имени App OOMOL, отвечать в тредах, планировать сообщения, загружать файлы, открывать личные сообщения и добавлять или удалять emoji-реакции.
OOMOL не начинает использовать Slack самостоятельно после установки. Инструмент Slack запускается, когда авторизованный пользователь, повторно используемый Skill, поддерживаемое действие агента или одобренный вызов инструмента OOMOL предоставляет нужные destination и content.
После установки
После перенаправления из Slack обратно в OOMOL проверьте в OOMOL Console, что подключение Slack отмечено как подключённое. Затем вы можете:
- Настроить
oo-cli, если хотите использовать подключённые инструменты Slack внутри поддерживаемой среды AI-агента. - Использовать тестовый канал, чтобы перечислить видимые каналы Slack, прочитать последние сообщения, опубликовать демонстрационное сообщение, ответить в треде, загрузить демонстрационный файл или добавить тестовую реакцию.
- Пригласить App OOMOL в любой private channel, где вы хотите дать ей возможность читать или публиковать, если политика workspace требует membership app для такого канала.
Использование
Инструменты Slack доступны только после подключения workspace Slack. Точный список инструментов, отображаемый в OOMOL, может меняться при обновлении коннектора, но текущий коннектор Slack включает инструменты для чтения conversations, чтения тредов, отправки сообщений, ответов в тредах, планирования сообщений, управления сообщениями, опубликованными bot, работы с файлами, чтения пользователей, открытия личных сообщений и управления emoji-реакциями.
Использование инструментов Slack с oo-cli
Чтобы сделать подключённые инструменты Slack доступными в поддерживаемой среде AI-агента, установите и настройте oo-cli после входа в OOMOL.
- Войдите в OOMOL Console.
- Откройте страницу установки oo-cli.
- Следуйте инструкциям на этой странице. Она предоставляет prompt для копирования в один клик, чтобы установить и настроить
oo-cliв поддерживаемой среде AI-агента. - После настройки
oo-cliи подключения Slack в OOMOL попросите агента использовать подключённые инструменты Slack с демонстрационными каналами, сообщениями и файлами.
Точный prompt агента зависит от среды. Например, можно попросить агента перечислить видимые каналы Slack, прочитать последние сообщения в тестовом канале, опубликовать демонстрационное сообщение, ответить в треде или добавить реакцию к тестовому сообщению.
Используемые разрешения
OOMOL использует разрешения Slack, чтобы авторизованный пользователь Slack мог подключить workspace как App в OOMOL, а затем сделать одобренные инструменты Slack доступными агентам и повторно используемым Skills.
Точные scopes, отображаемые во время Slack OAuth, являются источником истины для вашей установки. В зависимости от инструментов, включённых для вашего workspace, OOMOL может запрашивать разрешения в этих категориях:
| Область разрешений Slack | Используется | Почему OOMOL использует её |
|---|---|---|
| Метаданные workspace и conversations | List Conversations, List Channels, Get Conversation | Показывать conversations и каналы, к которым подключённый Slack app имеет доступ, чтобы пользователь или агент мог выбрать правильную destination перед чтением или публикацией. |
| История сообщений | Get Channel Messages, Get Thread | Читать сообщения и ответы в тредах из conversations, видимых подключённому Slack app, когда пользователь или одобренное действие агента запрашивает этот контекст. |
| Публикация и управление сообщениями | Post Message, Post Ephemeral Message, Reply Message, Update Message, Schedule Message, Delete Message | Отправлять сообщения, отвечать в тредах, планировать сообщения и управлять сообщениями, опубликованными подключённым Slack app, когда пользователь, Skill или одобренное действие агента предоставляет content и destination. |
| Доступ к файлам | Upload File, List Files, Get File, Delete File | Загружать файлы в Slack, перечислять файлы, видимые app, читать метаданные файлов или удалять файлы, когда одобренный вызов инструмента запрашивает эти действия. |
| Информация о пользователях и личные сообщения | List Users, Get User, Open Conversation | Идентифицировать пользователей Slack, видимых app, и открывать или продолжать личные conversations, когда пользователь, Skill или агент выбирает пользователя Slack. |
| Emoji-реакции | Add Reaction, Get Reactions, Remove Reaction | Добавлять, читать или удалять emoji-реакции на сообщения Slack, когда пользователь, Skill или одобренное действие агента запрашивает такое взаимодействие. |
Если администратор Slack не предоставляет требуемое разрешение, подключение Slack может завершиться ошибкой, или инструменты, зависящие от этого разрешения, могут быть недоступны до его предоставления.
Поддерживаемые инструменты Slack
| Инструмент | Поддерживаемая функция | Типичный сценарий | Предварительные требования |
|---|---|---|---|
| List Conversations | Перечисляет conversations Slack, видимые подключённому app. | Дать агенту выбрать правильный channel, private channel, group message или direct message перед следующим действием. | Slack подключён в OOMOL, и подключённый app имеет доступ к conversations. |
| List Channels | Перечисляет public channels Slack, видимые подключённому app. | Найти правильный public channel для отчёта, alert, summary или follow-up message. | Slack подключён в OOMOL, и public channels видны подключённому app. |
| Get Conversation | Читает метаданные conversation Slack. | Подтвердить имя, ID, тип, membership или другие доступные метаданные conversation перед другим действием. | Slack подключён в OOMOL, и conversation видна подключённому app. |
| Get Channel Messages | Получает последние сообщения из conversation Slack. | Резюмировать последние updates, собрать support requests или подготовить follow-up из тестового или одобренного рабочего канала. | Slack подключён в OOMOL, и подключённый app может читать историю conversation. |
| Get Thread | Получает сообщения в треде Slack. | Резюмировать обсуждение, подготовить ответ или извлечь action items из треда. | Slack подключён в OOMOL, и подключённый app может читать тред. |
| Post Message | Публикует сообщение Slack обычным текстом или Block Kit blocks. | Отправить status update, alert, summary или результат задачи в выбранный канал. | Slack подключён в OOMOL, destination известна, и пользователь, Skill или агент предоставляет content сообщения. |
| Post Ephemeral Message | Публикует сообщение, видимое только одному пользователю в conversation. | Отправить приватное подтверждение или prompt одному пользователю Slack, не публикуя его для всех. | Slack подключён в OOMOL, target conversation и user известны, и app имеет разрешение публиковать. |
| Reply Message | Отвечает в тред Slack. | Добавить результат задачи, ответ, summary или follow-up прямо в существующее обсуждение. | Slack подключён в OOMOL, parent message известен, и app может публиковать в conversation. |
| Update Message | Обновляет сообщение Slack, опубликованное bot. | Исправить, заменить или обновить status message, опубликованный bot. | Slack подключён в OOMOL, и target message было опубликовано подключённым app. |
| Schedule Message | Планирует сообщение Slack для публикации позже. | Поставить в очередь reminders, handoff notes или updates на будущее время. | Slack подключён в OOMOL, destination и scheduled time действительны, и app может публиковать туда. |
| Delete Message | Удаляет сообщение Slack, опубликованное bot. | Удалить тестовое сообщение bot, устаревший alert или некорректный update. | Slack подключён в OOMOL, и target message может быть удалено подключённым app. |
| Upload File | Загружает файл в Slack по file URL. | Поделиться отчётом, экспортированным результатом, изображением или документом в выбранной conversation. | Slack подключён в OOMOL, destination известна, и file URL доступен runtime коннектора. |
| List Files | Перечисляет файлы Slack, видимые подключённому app. | Найти файлы, опубликованные в канале или пользователем, перед использованием в другом действии. | Slack подключён в OOMOL, и app может видеть запрошенные файлы. |
| Get File | Читает метаданные файла Slack. | Проверить имя файла, владельца, тип или доступные метаданные перед следующим решением. | Slack подключён в OOMOL, и файл виден подключённому app. |
| Delete File | Удаляет файл Slack, когда подключённому app разрешено это делать. | Удалить тестовый файл или файл, загруженный bot, когда пользователь запрашивает cleanup. | Slack подключён в OOMOL, и подключённый app имеет разрешение удалить файл. |
| List Users | Перечисляет пользователей Slack, видимых подключённому app. | Найти пользователя перед отправкой ephemeral message или открытием direct message. | Slack подключён в OOMOL, и пользователи видны подключённому app. |
| Get User | Читает метаданные пользователя Slack. | Подтвердить правильного пользователя Slack перед ссылкой на него в Skill или агенте. | Slack подключён в OOMOL, и пользователь виден подключённому app. |
| Open Conversation | Открывает или продолжает direct message с одним пользователем Slack. | Подготовить задачу direct-message после выбора пользователя Slack. | Slack подключён в OOMOL, и app может открыть или получить доступ к direct message. |
| Add Reaction | Добавляет emoji-реакцию к сообщению Slack. | Отметить сообщение как acknowledged, queued, completed или needing follow-up. | Slack подключён в OOMOL, и сообщение видно подключённому app. |
| Get Reactions | Получает реакции для сообщения Slack. | Проверить, было ли сообщение acknowledged или triaged по реакции. | Slack подключён в OOMOL, и сообщение видно подключённому app. |
| Remove Reaction | Удаляет emoji-реакцию из сообщения Slack. | Убрать реакцию, которая больше не актуальна. | Slack подключён в OOMOL, и подключённый app может удалить реакцию. |
Чтение conversations и тредов
Сценарий: дать агенту возможность просмотреть последние сообщения Slack или конкретный тред перед резюмированием updates, извлечением action items, подготовкой ответа или маршрутизацией работы в другой подключённый инструмент.
Предварительные требования:
- Slack подключён в OOMOL.
- Подключённый Slack app может получить доступ к target conversation или треду.
- У агента, Skill или вызова инструмента есть правильный идентификатор channel, conversation, message или thread.
Что делают инструменты:
- Читают метаданные conversation, последние сообщения и ответы в треде, видимые подключённому Slack app.
- Возвращают данные Slack, доступные через авторизацию подключённого workspace.
- Не публикуют, не обновляют, не удаляют сообщения и не реагируют на них во время действий только для чтения.
Отправка и управление сообщениями
Сценарий: дать агенту возможность опубликовать status update, ответить в тред, запланировать reminder, отправить ephemeral message одному пользователю или обновить сообщение bot после завершения задачи.
Предварительные требования:
- Slack подключён в OOMOL.
- Target channel, conversation, user, message или thread известен.
- Пользователь, Skill или агент предоставил content сообщения и одобрил destination.
Что делают инструменты:
- Публикуют plain-text messages или Block Kit messages, когда предоставлен content.
- Отвечают внутри существующих тредов, когда предоставлен parent message.
- Планируют сообщения на будущее время, когда Slack принимает destination и timestamp.
- Обновляют или удаляют сообщения только когда подключённому app разрешено управлять target message.
Работа с файлами и реакциями
Сценарий: дать агенту возможность поделиться файлом в Slack, проверить метаданные файла или добавить реакцию, которая отмечает сообщение как acknowledged, queued, completed или needing follow-up.
Предварительные требования:
- Slack подключён в OOMOL.
- Target conversation, file, message или reaction name известен.
- Для загрузки файла файл должен быть доступен по URL, который runtime коннектора может получить.
Что делают инструменты:
- Загружают файлы в Slack, когда предоставлены file URL и destination.
- Читают метаданные файлов и реакции, видимые подключённому app.
- Добавляют или удаляют реакции, когда Slack разрешает это подключённому app.
- Удаляют файлы только когда подключённому app разрешено удалить target file.
Тестирование App
Вы можете тестировать App Slack с workspace Slack, где вам разрешено устанавливать apps. Используйте тестовый канал и демонстрационные сообщения, чтобы безопасно тестировать чтение, публикацию, обновление, файлы и реакции.
Примеры тестовых prompts
- Перечисли public channels Slack, видимые подключённому app.
- Получи последние сообщения из канала
#oomol-test. - Опубликуй
Hello from OOMOLв канал#oomol-test. - Ответь на последнее тестовое сообщение текстом
Received. - Добавь реакцию
white_check_markк тестовому сообщению. - Получи реакции для тестового сообщения.
- Запланируй сообщение Slack в тестовом канале на сегодня позже.
- Загрузи демонстрационный файл в тестовый канал.
- Перечисли пользователей Slack, видимых подключённому app.
- Открой direct message с тестовым пользователем.
Используйте при тестировании только демонстрационные данные. Не используйте реальные клиентские, пользовательские или конфиденциальные данные Slack в тестовых prompts.
Устранение неполадок
Не удаётся добавить App Slack
- Убедитесь, что вы вошли в правильный аккаунт OOMOL.
- Убедитесь, что вы входите в тот workspace Slack, который хотите подключить.
- Если ваш workspace Slack требует approval app, попросите владельца или администратора workspace Slack одобрить App OOMOL.
- Попробуйте отключить любое неудачное или частичное подключение Slack в OOMOL, затем подключите снова.
- Если проблема сохраняется, обратитесь в поддержку OOMOL и укажите e-mail аккаунта OOMOL, имя или ID workspace Slack, если доступно, время попытки, а также сообщение об ошибке или скриншот.
Инструмент Slack не находит channel или conversation
- Подтвердите, что подключённый Slack app может получить доступ к target conversation.
- Если target является private channel, подтвердите, что подключённый app добавлен в этот канал или имеет требуемые разрешения workspace.
- Подтвердите, что запрос использует правильный conversation ID, имя канала или вход поиска.
- Если вы недавно изменили разрешения Slack, переподключите Slack в OOMOL, чтобы обновить состояние авторизации.
Инструмент Slack не может читать сообщения
- Подтвердите, что подключённый Slack app имеет разрешение читать историю target conversation.
- Подтвердите, что app присутствует в private channel, если сообщение находится в private channel.
- Проверьте, что запрос использует правильный message timestamp, thread timestamp или conversation ID.
- Если workspace недавно изменил scopes app или доступ к каналам, переподключите Slack в OOMOL.
Инструмент Slack не может опубликовать или обновить сообщение
- Подтвердите, что подключённый Slack app может публиковать в target conversation.
- Подтвердите, что вызов инструмента содержит действительную destination и тело сообщения.
- Для действий update и delete подтвердите, что target message было опубликовано подключённым Slack app и может управляться им.
- Если Slack возвращает ошибку политики workspace или разрешения, попросите владельца или администратора workspace Slack проверить разрешения app.
Действие Slack с файлом завершается ошибкой
- Для upload actions подтвердите, что file URL доступен runtime коннектора.
- Подтвердите, что подключённый Slack app может получить доступ к target conversation.
- Для delete actions подтвердите, что подключённому app разрешено удалить target file.
Удаление App
Вы можете удалить App Slack из OOMOL или Slack. Мы рекомендуем удалить её в обоих местах, если вы больше не хотите, чтобы OOMOL имел доступ к Slack.
Удалить Slack из OOMOL
- Войдите в OOMOL Console.
- Откройте Connections.
- Найдите Slack среди подключённых apps.
- Откройте сведения подключения Slack.
- Выберите Disconnect, Remove или эквивалентное действие удаления, показанное в OOMOL.
- Подтвердите удаление.
Удалить OOMOL из Slack
- Войдите в Slack в подключённом workspace.
- Откройте Manage apps или страницу управления Slack app для вашего workspace.
- Найдите OOMOL.
- Откройте сведения App.
- Выберите действие для remove, uninstall или revoke App.
- Подтвердите удаление.
Если вы не можете удалять apps в Slack, попросите владельца или администратора workspace Slack удалить App.
Что происходит после удаления
- OOMOL больше не сможет использовать инструменты Slack для вашего workspace после удаления или деавторизации подключения Slack.
- Агенты, Skills или другие задачи, зависящие от Slack, могут завершаться ошибкой, пока вы не подключите Slack снова.
- Существующие сообщения, файлы, каналы и реакции Slack, созданные до удаления, остаются в Slack, если вы не удалите или не измените их в Slack.
- Удаление App не удаляет ваш аккаунт OOMOL.
Обработка данных
OOMOL получает доступ к данным Slack только после того, как пользователь Slack авторизует App и пользователю, Skill или одобренному действию агента требуется Slack. OOMOL использует данные Slack только для предоставления инструментов Slack, запрошенных через поддерживаемых OOMOL агентов, повторно используемые Skills и одобренные вызовы инструментов.
- OAuth-токены Slack хранятся зашифрованными.
- OAuth-токены Slack не раскрываются AI-агентам, prompts, файлам проекта или конечным пользователям.
- OOMOL может обрабатывать метаданные workspace Slack, метаданные conversations, сообщения, ответы в тредах, файлы, метаданные пользователей и реакции при вызове инструмента Slack.
- Данные Slack могут храниться только по необходимости в видимых пользователю результатах инструментов, записях использования, истории выполнения или операционных записях.
- Сохранённые данные шифруются в состоянии хранения и передаются через TLS/SSL.
- OOMOL не продаёт ваши данные Slack.
- OOMOL не использует ваши данные Slack для рекламы.
- OOMOL не использует приватный клиентский контент для обучения AI-моделей.
- OOMOL не синхронизирует и не реплицирует данные workspace Slack в фоне постоянно как часть этого коннектора. Доступ к данным Slack происходит, когда авторизованный пользователь, Skill или одобренное действие агента вызывает инструмент Slack.
- Когда вы удаляете или деавторизуете App Slack, OOMOL прекращает использовать отозванную авторизацию Slack. OOMOL удаляет или инвалидирует сохранённые токены авторизации Slack согласно обычному процессу удаления подключения.
- Некоторые журналы, записи поддержки, записи безопасности или записи, связанные с биллингом, могут сохраняться, как описано в политике конфиденциальности.
FAQ
Нужен ли платный workspace Slack?
Большинству инструментов OOMOL Slack требуется workspace Slack, который разрешает запрошенные разрешения app. Некоторые функции Slack, controls approval app, настройки retention или политики workspace могут зависеть от вашего плана Slack или настроек организации.
Можно ли подключить несколько workspaces Slack?
Используйте OOMOL Console, чтобы проверить текущие варианты подключения, доступные вашему аккаунту или workspace. Если нужна помощь с несколькими workspaces Slack, обратитесь в поддержку.
Может ли агент автоматически использовать Slack после подключения?
Подключение Slack делает инструменты Slack доступными в OOMOL, но использование инструментов всё равно зависит от выбранного агента, Skill, разрешений и approvals. Сервисы на основе аккаунтов по-прежнему требуют вашей авторизации.
OOMOL читает каждое сообщение Slack после подключения?
Нет. OOMOL не синхронизирует каждое сообщение Slack постоянно. Доступ к данным Slack происходит, когда авторизованный пользователь, Skill или одобренное действие агента вызывает инструмент Slack для conversation, к которой подключённый app имеет доступ.
Может ли OOMOL удалять сообщения или файлы Slack?
Текущий коннектор Slack включает действия удаления для сообщений, опубликованных bot, и файлов, которые подключённому app разрешено удалить. OOMOL не удаляет контент Slack, если пользователь или одобренный вызов инструмента не использует поддерживаемый инструмент удаления с нужной целевой информацией.
Связаться с поддержкой
Если вам нужна помощь с добавлением, использованием, тестированием или удалением App Slack, обратитесь в поддержку OOMOL:
- Email: support@oomol.com
- Страница поддержки: https://oomol.com/ru/support/
Укажите e-mail аккаунта OOMOL, имя или ID workspace Slack, если применимо, действие, которое вы пытались выполнить, а также сообщение об ошибке или скриншот.