Интеграция с ботом Lark
Привяжите агента AACWorkflow к боту Lark (飞书), а затем общайтесь с ним из личного чата или группы Lark — упоминайте его через @, ведите обычную переписку или введите /issue, чтобы создать задачу AACWorkflow, не покидая Lark.
Привяжите любого агента к боту Lark (飞书), и ваша команда сможет работать с ним прямо из Lark — писать боту в личку, упоминать его через @ в группе или вводить /issue, чтобы создать задачу AACWorkflow, не открывая приложение. Ответы агента возвращаются в чат в виде живой карточки, которая обновляется по мере его работы.
Каждый бот привязан один к одному к единственному агенту AACWorkflow. Привязка второго агента создаёт второго бота; у одного агента никогда не бывает двух ботов.
Что делает интеграция
| Поверхность | Поведение |
|---|---|
| Агент → Интеграции | На странице агента есть вкладка Интеграции (и соответствующий раздел в левой боковой панели). Владельцы и администраторы видят там Привязать к Lark; после привязки она превращается в бейдж Подключено к Lark со ссылкой Управлять в Lark. |
| Написать боту в личку | Участник рабочего пространства пишет боту напрямую в Lark. Каждая переписка становится сессией чата AACWorkflow с агентом; агент отвечает в том же треде. |
| Упоминание через @ в группе | Добавьте бота в группу Lark и упомяните его через @. Читается только сообщение с упоминанием — бот не слушает всю группу. |
Команда /issue | Ввод /issue <заголовок> (при желании с телом) создаёт новую задачу AACWorkflow в рабочем пространстве, приписанную вам. |
| Живая карточка ответа | Бот публикует интерактивную карточку и продолжает её обновлять по мере работы агента — прогресс, итоговый ответ или ошибку. |
Привязка агента (владелец / администратор)
Привязка использует процесс «отсканировать и установить» — не нужно копировать секреты приложения и проходить шаги в консоли разработчика.
- Откройте агента в Агенты → ваш агент.
- Перейдите на вкладку Интеграции (или воспользуйтесь разделом Интеграции в левой боковой панели) и нажмите Привязать к Lark.
- Появится QR-код. На телефоне откройте Lark → Сканировать, затем авторизуйте нового бота PersonalAgent.
- Когда сканирование завершится, диалог закроется, и агент покажет Подключено к Lark. Ваша личность в Lark автоматически привязывается к вашему аккаунту AACWorkflow, так что вы можете сразу начать общаться с ботом.
QR-код одноразовый и истекает через короткое время. Если он истёк до того, как вы авторизовались, нажмите Сканировать снова для нового кода.
После подключения агента кнопка Привязать к Lark заменяется ссылкой Управлять в Lark. Используйте её, чтобы открыть страницу приложения бота в Lark, когда нужно скорректировать области доступа, переименовать его или запросить дополнительные разрешения — повторное сканирование намеренно отключено, чтобы вы не оставили существующего бота без связи.
Использование бота (участники)
Первое сообщение: привяжите свою личность в Lark
Когда вы впервые пишете боту, он отвечает карточкой с просьбой привязать вашу личность в Lark. Нажмите на ссылку, войдите в AACWorkflow, и ваш аккаунт Lark свяжется с вашим членством в AACWorkflow. Именно это позволяет агенту действовать от вашего имени — например, /issue создаёт задачу под вашим именем.
Пользоваться ботом могут только те, кто является участником рабочего пространства. Если вы не участник или пропустили привязку личности, бот не ответит — ваше сообщение отбрасывается (и записывается для аудита, без его содержимого).
Чат и /issue
- Спросите агента о чём угодно — напишите боту в личку или упомяните его через @ в группе. Переписка — это обычная сессия чата с агентом; агент отвечает в карточке.
- Создайте задачу — отправьте
/issue Fix the login redirect, и AACWorkflow создаст эту задачу в рабочем пространстве, назначив её так же, как любую новую задачу. Добавьте строки после заголовка для описания. - Наблюдайте за работой — карточка ответа обновляется сама по мере работы агента, так что вы видите прогресс и результат на месте.
Если агент офлайн (его среда выполнения не подключена) или архивирован, бот отвечает коротким уведомлением о статусе вместо того, чтобы молча отбросить ваше сообщение.
Управление и отключение
Управление в рамках всего рабочего пространства находится в Настройки → Интеграции:
- Подключённые боты — список всех ботов в рабочем пространстве и агента, к которому привязан каждый из них. Этот список виден всем участникам.
- Отключить доступно только владельцу / администратору. Отключение останавливает получение ботом сообщений Lark и разрывает его соединение; запись об установке сохраняется для аудита, и вы можете позже снова привязать того же агента.
Права доступа
- Привязка / отключение требуют роли владельца или администратора рабочего пространства. Участники видят список подключённых ботов, но не элементы управления привязкой или отключением.
- Общение с ботом требует быть участником рабочего пространства с привязанной личностью в Lark. Все остальные отбрасываются.
- Интеграция никогда не хранит тела отброшенных сообщений — только причину отбрасывания, для аудита.
Feishu и Lark international — бок о бок. Облако, к которому принадлежит каждый бот — материковый Feishu (open.feishu.cn) или Lark international (open.larksuite.com), — определяется автоматически при сканировании QR-кода и используется для каждого вызова к этому боту. AACWorkflow Cloud обслуживает оба сразу, так что команды на любом из тенантов могут выполнить привязку без какой-либо дополнительной настройки.
Далее
Интеграция с GitHub
Подключите GitHub App один раз, и PR, содержащие идентификатор задачи в ветке, заголовке или теле, автоматически привяжутся к задаче — а при вливании PR задача перейдёт в «Готово».
Интеграция со Slack-ботом
Подключите агента AACWorkflow к собственному приложению Slack — создайте приложение из манифеста, установите его, вставьте bot- и app-level-токены, а затем @-упоминайте его, пишите ему в личку или вводите /issue прямо из Slack.