Начало работы
Подключение внешних приложений к вашим агентам
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Что такое подключение
Подключение, это авторизованная связь между одним из ваших экспертов и одним внешним приложением. После подключения этот эксперт может использовать инструменты приложения в разговоре: читать документ, составлять сообщение, проверять запись. Без подключения эксперт не имеет доступа вообще.
Две вещи стоит уточнить:
- Подключение предоставляет доступ к этому приложению, а не к вашему аккаунту Kapsule. Эти два набора разрешений никогда не смешиваются.
- Все, что изменяет что-либо в подключённом приложении, всё равно проходит через ту же карточку подтверждения, что и изменение вашего аккаунта Kapsule. Чтение происходит сразу, запись требует предварительного подтверждения.
Подключения находятся в Agents, затем Manage Connections, или перейдите прямо на /agents/connections. На домашней странице Agents также отображается карточка Connections с несколькими примерами приложений.
Какие эксперты могут использовать какие приложения
Список намеренно консервативен, и каждый эксперт видит только приложения, необходимые для его работы. Некоторые ограничены инструментами только для чтения, даже если само приложение может делать больше:
| Эксперт | Внешние приложения, к которым он может получить доступ |
|---|---|
| Mara, Business Advisor | Stripe (только чтение) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (только чтение) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (только чтение) |
| Pip, Policy and Docs | Нет |
Подключение приложения не делает его доступным для всей команды. Оно становится доступным только экспертам в строке выше.
Подключение приложения
- Откройте Agents, затем Manage Connections.
- Просмотрите вкладку Popular, переключитесь на All Apps или введите текст в поле поиска. На каждой карточке показано имя приложения и количество инструментов, которые оно предоставляет.
- Нажмите Connect на нужном приложении. Кнопка изменится на Opening... при подготовке окна входа.
- Войдите в приложение и одобрите требуемый доступ.
- Вы вернётесь на страницу Connections с подтверждением [приложение] Connected.
После подключения карточка показывает статус Connected, метку аккаунта, под которым вы вошли, и когда подключение было последний раз использовано, или Not used yet.
Статусы подключения
| Статус | Что это означает | Что делать |
|---|---|---|
| Connected | Работает. Ваши эксперты могут его использовать. | Ничего |
| Pending | Вход был начат, но никогда не завершён. | Нажмите Finish Connecting |
| Reconnect Needed | Доступ истёк или был отозван приложением. | Нажмите Reconnect |
Статус Reconnect Needed является нормальным со временем: большинство приложений истекают по расписанию. Переподключение восстанавливает доступ без потери данных.
Как это остаётся безопасным
На странице Connections указана модель безопасности в трёх пунктах, и её стоит понимать, а не просто просматривать:
- Обработано сертифицированным партнёром. Вход в приложение обрабатывается нашим сертифицированным партнёром интеграции, который владеет грантом. Ваш пароль приложения никогда не попадает в Kapsule.
- Подтверждение перед действием. Agents просят подтверждение перед действием. Всё, что изменяет что-либо, требует вашего согласия.
- Мгновенное отзыв доступа. Отключение подключения немедленно прекращает доступ как здесь, так и в приложении.
Рассматривайте подключение как ключ, который вы нарезали для кого-то. Подключайте аккаунты, в которых вы хотите, чтобы работали ваши эксперты, а не все аккаунты, которыми вы владеете. Если вы не уверены, нужно ли эксперту приложение для выполнения поставленной задачи, не подключайте его: сначала спросите, потом подключайте.
Отключение приложения
- Откройте Agents, затем Manage Connections.
- Нажмите Disconnect на подключённом приложении.
- Появится подтверждение: Ваша команда теряет доступ к [приложению] немедленно. Всё, что оно уже использовало, остаётся в ваших прошлых разговорах.
- Нажмите Disconnect для подтверждения.
Доступ заканчивается немедленно. Что это не делает, так это не удаляет содержимое приложения из разговоров, которые вы уже проводили: если эксперт процитировал документ в разговоре на неделю назад, этот текст всё ещё находится в стенограмме разговора. Отключение касается будущего доступа, а не ретроактивного удаления.
Когда подключения недоступны в вашем аккаунте
Если страница Connections показывает одну спокойную карточку с надписью Connections Are Not Available Yet, подключение внешних приложений не было включено для вашего аккаунта. На карточке явно указано, что ничего не подключено и ничто не имеет доступа, что является абсолютной истиной в этом состоянии. Ваши эксперты всё ещё работают; они просто не могут выходить за пределы Kapsule.
Остальная часть 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." Ваши параметры в безопасности. Обновите страницу. Если проблема сохраняется, откройте заявку в поддержку.
Эксперт говорит, что не может получить доступ к подключённому приложению. Проверьте таблицу выше. Не каждый эксперт может использовать каждое приложение, и приложение, подключённое для Cora, не автоматически доступно Mara.
Подключение зависло на Pending. Окно входа было закрыто до его завершения. Нажмите Finish Connecting и завершите его.
Стоимость подключений
Использование подключённого приложения в разговоре измеряется как любая другая работа. Каждый вызов, который эксперт делает во внешнее приложение, оплачивается по весу вызова подключения, что составляет часть того, что стоит большой письменный текст. Чтения вашего аккаунта Kapsule остаются бесплатными. Полное распределение веса приведено в How Agent Credits Work.