Підключіть Slack до робочого простору

Що ви створите

Наприкінці цього посібника у вас буде:

• Застосунок Slack, створений для вашого робочого простору, з потрібними дозволами й уже налаштованими подіями
• Живе з’єднання між Slack і Control Center
• Ваш власний обліковий запис Slack, прив’язаний до вашого користувача Control Center
• Агент, що відповідає вам у гілці Slack, і тікет, створений зі slash-команди

Передумови:

• Завершено Ваш перший робочий простір і Запустіть першого агента — робочий простір без агентів може отримати повідомлення зі Slack, але не має кому на нього відповісти
• CEO-агент робочого простору має адаптер і модель, задані в Налаштування → Робочий простір → Агенти. Міст прокидає CEO, а не агента, якого ви налаштували в попередньому посібнику, а агент без адаптера працює на вбудованому циклі з типовою моделлю Anthropic.
• Роль owner або admin у робочому просторі Control Center (підключення чат-застосунку говорить від імені всього робочого простору)
• Дозвіл створювати й установлювати застосунки у вашому робочому просторі Slack

Тут нічого не потребує публічної адреси, тунелю чи вхідного порту. Control Center з’єднується назовні зі Slack через Socket Mode, тож це працює й із ноутбука за NAT.

Крок 1: Отримайте токен конфігурації застосунку Slack

Це єдиний секрет, який доведеться отримати вручну. Він дає Control Center змогу створити, а згодом і редагувати застосунок за вас.

1. Відкрийте api.slack.com/apps
2. Прокрутіть до розділу токенів конфігурації застосунку внизу сторінки
3. Згенеруйте пару токенів для свого робочого простору Slack
4. Скопіюйте токен refresh — він починається з xoxe-

Крок 2: Дозвольте Control Center створити застосунок

1. У Control Center перейдіть у Налаштування → Робочий простір → Загальні і знайдіть картку Чат-мости
2. У блоці Slack натисніть Створити застосунок за мене
3. Вставте токен конфігурації застосунку
4. Перегляньте, яким буде бот:
   • Назва застосунку: як Slack показує застосунок у списку, наприклад Control Center · Acme
   • Ім’я бота: те, що люди вводять після @, наприклад control-center
   • Короткий опис і Що бот каже, що вміє
   • Slash-команда: за замовчуванням cc, тож команда — /cc
   • Особисті повідомлення: залиште увімкненими, щоб учасники могли писати боту в особистих повідомленнях
5. Натисніть Створити застосунок

Control Center складає все визначення застосунку — увімкнений Socket Mode, потрібні області доступу бота й підписки на події, slash-команду, вкладку Messages — і створює його у Slack.

Крок 3: Виконайте два кроки, які під силу лише Slack

У Slack немає API для генерації токена рівня застосунку чи встановлення застосунку, тож діалог подає обидва кроки як посилання:

1. Згенеруйте токен рівня застосунку — відкриває Basic Information → App-Level Tokens. Створіть токен з областю доступу connections:write і скопіюйте його. Він починається з xapp-
2. Встановіть застосунок — відкриває Install App. Установіть його у свій робочий простір, а потім скопіюйте Bot User OAuth Token. Він починається з xoxb-

Збережіть обидва значення для наступного кроку.

Крок 4: Підключіть

1. Поверніться в діалог і натисніть Вставити облікові дані
2. Введіть Токен бота (xoxb-…) і Токен застосунку (xapp-…)
3. Залиште Токен конфігурації застосунку порожнім — той, з кроку 1, уже збережено (Slack його оновив, і Control Center зберіг новий)
4. Натисніть Підключити

Control Center перевіряє токен бота в Slack, перш ніж щось зберегти, а потім відкриває сокет. Тепер у рядку показано ім’я бота та назву вашого робочого простору Slack із тегом Наживо.

Крок 5: Прив’яжіть власний обліковий запис Slack

Підключення робить бота доступним; прив’язка робить упізнаваним вас. Доки вашу ідентичність у Slack не прив’язано, бот не діятиме за вашими повідомленнями — він ніколи не приписує повідомлення тому, хто встановив застосунок.

Прив’язка особиста, тож вона живе на іншій сторінці, ніж підключення всього робочого простору.

1. Перейдіть у Налаштування → Робочий простір → Профіль і ідентичність і знайдіть картку Прив’язані облікові записи чату
2. Натисніть Прив’язати мій обліковий запис Slack
3. Скопіюйте команду, яку він показує, наприклад /cc link K7M2QP
4. У Slack надішліть цю команду боту в особистому повідомленні
5. Бот відповідає «Прив’язано — ви …»

Код одноразовий і втрачає чинність через 15 хвилин. Якщо ваша адреса електронної пошти в Slack збігається з користувачем Control Center, який уже є учасником цього робочого простору, міст прив’яже вас автоматично під час першого звернення до нього, і цей крок можна пропустити.

Якщо ви згадаєте бота до цього, він відмовиться й пояснить чому. Три відмови різні, тож прочитайте, яку саме ви отримали:

• Неприв’язаний відправник: бот підказує, як виконати прив’язку. Поверніться до цього кроку.
• Прив’язано, але ви не учасник цього робочого простору: попросіть адміністратора запросити вас.
• Учасник із роллю лише для читання (viewer або guest): бот не почне роботу від вашого імені.

Крок 6: Поставте агента на завдання

1. У Slack запросіть бота до каналу: /invite @control-center

2. Згадайте його зі справжнім запитом:

   @control-center підсумуй відкриті PR у репозиторії api

Міст:

1. Створює простір Control Center для цієї гілки Slack, названий за каналом Slack і вашим запитом
2. Прокидає агента на вході робочого простору (CEO-агента, якщо він є, інакше першого агента)
3. Передає відповідь агента потоком назад у гілку Slack у міру її написання

Відповідайте в тій самій гілці Slack, щоб продовжити, — подальші згадки не потрібні, бо гілка Slack тепер з’єднана мостом. Або напишіть боту в особистому повідомленні замість каналу; кожна розмова в особистих повідомленнях керує власним простором Control Center, із заголовком і рядком стану «is thinking…», поки агент працює.

Потокова передача потребує Slack streaming API, який є не в кожному тарифі. Якщо вашому застосунку в ній відмовлено, міст перестає намагатися для всього з’єднання й натомість надсилає кожну відповідь одним повідомленням, а картка Чат-мости показує «Потокова передача вимкнена для цього застосунку Slack — відповіді надходять одним повідомленням.» Усе інше працює так само.

Крок 7: Створіть тікет, не виходячи зі Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

Бот відповідає ключем створеного тікета. Це звичайний локальний тікет Control Center, створений вами, готовий до призначення агенту. /cc help перелічує все, що вміє команда.

Підсумок

Ви створили застосунок Slack із Control Center, підключили його через вихідний сокет, прив’язали свою ідентичність у Slack до користувача Control Center і керували агентом із гілки Slack. Усе, що сталося в Slack, існує і в Control Center: гілка Slack — це простір, відповідь — транскрипт, тікет — тікет.

Далі: Налаштувати інтеграцію Slack описує шлях вручну, ротацію токенів і усунення несправностей. А про модель під цим читайте в Чат-мости.