Подключения позволяют эксперту Kapsule Agents работать внутри приложений, которые вы уже используете, с вашего разрешения, и они полностью отделены от того, что эксперт может делать на вашей учетной записи KapsuleHost.
Что такое подключение
Подключение, это подписанная ссылка между одним из ваших экспертов и одним внешним приложением. После подключения этот эксперт может использовать инструменты приложения в разговоре: читать документ, составлять сообщение, проверять запись. Без подключения у эксперта вообще нет доступа.
Две вещи стоит уточнить:
- Подключение предоставляет доступ к этому приложению, а не к вашей учетной записи KapsuleHost. Эти два набора разрешений никогда не смешиваются.
- Все, что изменяет что-то в подключенном приложении, по-прежнему проходит через ту же карточку подтверждения, что и изменение в вашей учетной записи KapsuleHost. Чтение происходит сразу; запись требует предварительного согласия.
Подключения находятся в разделе Agents → Управлять Подключениями, или перейдите сразу на /agents/connections. На домашней странице Agents также отображается карточка подключений с несколькими примерами приложений.
Какие эксперты могут использовать какие приложения
Список намеренно консервативен, и каждый эксперт видит только приложения, которые нужны его должности. Некоторые ограничены инструментами только для чтения, даже если само приложение может делать больше:
| Эксперт | Внешние приложения, которые он может использовать |
|---|---|
| Mara, Business Advisor | Stripe (только чтение) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (только чтение) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (только чтение) |
| Pip, Policy and Docs | Нет |
Подключение приложения не предоставляет его всей команде. Оно становится доступным только экспертам в строке выше.
Подключение приложения
- Откройте Agents, затем Управлять Подключениями.
- Просмотрите вкладку Popular, переключитесь на Все приложения или введите текст в поле поиска. На каждой карточке указано название приложения и количество инструментов, которые оно предоставляет.
- Нажмите Connect на нужном приложении. Кнопка изменится на Opening... во время подготовки окна входа.
- Войдите в само приложение и одобрите запрашиваемый доступ.
- Вы вернетесь на страницу подключений с подтверждением [приложение] Connected.
После подключения на карточке отображается значок Connected, метка учетной записи, под которой вы вошли, и когда подключение последний раз использовалось, или Ещё не использовано.
Статусы подключений
| Статус | Что означает | Что делать |
|---|---|---|
| Connected | Работает. Ваши эксперты могут его использовать. | Ничего |
| Pending | Вход был начат, но никогда не завершен. | Нажмите Завершить подключение |
| Reconnect Needed | Доступ истек или был отозван на стороне приложения. | Нажмите Reconnect |
Состояние Требуется переподключение, это нормально со временем: большинство приложений истекают по расписанию. Переподключение восстанавливает его без потери данных.
Как это остается в безопасности
Страница подключений описывает модель безопасности в три строки, и это стоит понимать, а не просто пропустить:
- Обрабатывается сертифицированным партнером. Вход в приложение обрабатывается нашим сертифицированным партнером по интеграции, который держит разрешение. Пароль от приложения никогда не касается KapsuleHost.
- Подтверждение перед действием. Agents просят перед выполнением. Все, что изменяет что-то, требует вашего согласия в первую очередь.
- Немедленное отзыв. Отключение перекрывает доступ сразу же, как здесь, так и в приложении.
Относитесь к подключению как к ключу, который вы вырезали для кого-то. Подключайте те учетные записи, в которых вы хотите, чтобы ваши эксперты работали, а не каждую учетную запись, которой вы владеете. Если вы не уверены, нужно ли эксперту приложение для той работы, которую вы имеете в виду, не подключайте его: сначала спросите, потом подключите.
Отключение приложения
- Откройте Agents, затем Управлять Подключениями.
- Нажмите Disconnect на подключенном приложении.
- Появится подтверждение: Ваша команда потеряет доступ к [приложение] сразу же. Все, что она уже использовала, остается в ваших предыдущих чатах.
- Нажмите Disconnect для подтверждения.
Доступ заканчивается немедленно. Что это не делает, так это стирает содержимое приложения из уже имеющихся разговоров: если эксперт процитировал документ в чате на прошлой неделе, этот текст остается в записях чата. Отключение касается будущего доступа, а не ретроактивного удаления.
Когда подключения недоступны в вашей учетной записи
Если на странице подключений отображается одна спокойная карточка с надписью Подключения еще недоступны, подключение внешних приложений не было включено для вашей учетной записи. На карточке явно указано, что ничего не подключено и ничего не имеет доступа, что полностью соответствует действительности в этом состоянии. Ваши эксперты все еще работают; они просто не могут выходить за пределы KapsuleHost.
Остальная часть Agents не затронута. Чаты, Skills и чтение учетной записи работают как обычно.
Если это не сработает
"Permission was not granted, so nothing was connected." Вы отменили или отклонили на экране одобрения самого приложения. Ничего не было создано. Нажмите Connect еще раз и одобрите доступ.
"Connections are unavailable right now. Try again in a moment." Служба интеграции недоступна. Это намеренно закрыто: вместо того чтобы показать полусконструированный список, страница ничего не показывает. Подождите минуту и перезагрузите страницу.
"Connections could not be loaded." Ваши параметры в безопасности. Обновите страницу. Если проблема сохраняется, откройте тикет поддержки.
Эксперт говорит, что не может получить доступ к подключенному приложению. Проверьте таблицу выше. Не каждый эксперт допущен к каждому приложению, и приложение, подключенное для Iris, не автоматически доступно Mara.
Подключение зависает в статусе Pending. Окно входа было закрыто до его завершения. Нажмите Завершить подключение и завершите его.
Стоимость подключений
Использование подключенного приложения в разговоре оценивается как любая другая работа. Каждый вызов, который эксперт делает во внешнее приложение, оценивается с весом вызова подключения, который составляет часть того, что стоит длинный текст. Чтения вашей учетной записи KapsuleHost остаются бесплатными. Полное взвешивание находится в How Agent Credits Work.