# Подключение внешних приложений к вашим агентам

Source: https://support.kapsulehost.com/ru-ru/agents-connections

Подключения позволяют эксперту Kapsule Agents работать внутри приложений, которые вы уже используете, с вашего разрешения, и они полностью отделены от того, что эксперт может делать на вашей учетной записи KapsuleHost.

## Что такое подключение

Подключение, это подписанная ссылка между одним из ваших экспертов и одним внешним приложением. После подключения этот эксперт может использовать инструменты приложения в разговоре: читать документ, составлять сообщение, проверять запись. Без подключения у эксперта вообще нет доступа.

Две вещи стоит уточнить:

- Подключение предоставляет доступ к **этому приложению**, а не к вашей учетной записи KapsuleHost. Эти два набора разрешений никогда не смешиваются.
- Все, что **изменяет** что-то в подключенном приложении, по-прежнему проходит через ту же карточку подтверждения, что и изменение в вашей учетной записи KapsuleHost. Чтение происходит сразу; запись требует предварительного согласия.

> **Note:** Подключения находятся в разделе **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 | Нет |

Подключение приложения не предоставляет его всей команде. Оно становится доступным только экспертам в строке выше.

![Каталог подключений в Kapsule Agents](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## Подключение приложения

1. Откройте **Agents**, затем **Управлять Подключениями**.
2. Просмотрите вкладку **Popular**, переключитесь на **Все приложения** или введите текст в поле поиска. На каждой карточке указано название приложения и количество инструментов, которые оно предоставляет.
3. Нажмите **Connect** на нужном приложении. Кнопка изменится на **Opening...** во время подготовки окна входа.
4. Войдите в само приложение и одобрите запрашиваемый доступ.
5. Вы вернетесь на страницу подключений с подтверждением **[приложение] Connected**.

После подключения на карточке отображается значок **Connected**, метка учетной записи, под которой вы вошли, и когда подключение последний раз использовалось, или **Ещё не использовано**.

## Статусы подключений

| Статус | Что означает | Что делать |
|---|---|---|
| Connected | Работает. Ваши эксперты могут его использовать. | Ничего |
| Pending | Вход был начат, но никогда не завершен. | Нажмите **Завершить подключение** |
| Reconnect Needed | Доступ истек или был отозван на стороне приложения. | Нажмите **Reconnect** |

Состояние **Требуется переподключение**, это нормально со временем: большинство приложений истекают по расписанию. Переподключение восстанавливает его без потери данных.

## Как это остается в безопасности

Страница подключений описывает модель безопасности в три строки, и это стоит понимать, а не просто пропустить:

- **Обрабатывается сертифицированным партнером.** Вход в приложение обрабатывается нашим сертифицированным партнером по интеграции, который держит разрешение. Пароль от приложения никогда не касается KapsuleHost.
- **Подтверждение перед действием.** Agents просят перед выполнением. Все, что изменяет что-то, требует вашего согласия в первую очередь.
- **Немедленное отзыв.** Отключение перекрывает доступ сразу же, как здесь, так и в приложении.

> **Warning:** Относитесь к подключению как к ключу, который вы вырезали для кого-то. Подключайте те учетные записи, в которых вы хотите, чтобы ваши эксперты работали, а не каждую учетную запись, которой вы владеете. Если вы не уверены, нужно ли эксперту приложение для той работы, которую вы имеете в виду, не подключайте его: сначала спросите, потом подключите.

## Отключение приложения

1. Откройте **Agents**, затем **Управлять Подключениями**.
2. Нажмите **Disconnect** на подключенном приложении.
3. Появится подтверждение: *Ваша команда потеряет доступ к [приложение] сразу же. Все, что она уже использовала, остается в ваших предыдущих чатах.*
4. Нажмите **Disconnect** для подтверждения.

Доступ заканчивается немедленно. Что это **не** делает, так это стирает содержимое приложения из уже имеющихся разговоров: если эксперт процитировал документ в чате на прошлой неделе, этот текст остается в записях чата. Отключение касается будущего доступа, а не ретроактивного удаления.

## Когда подключения недоступны в вашей учетной записи

Если на странице подключений отображается одна спокойная карточка с надписью **Подключения еще недоступны**, подключение внешних приложений не было включено для вашей учетной записи. На карточке явно указано, что ничего не подключено и ничего не имеет доступа, что полностью соответствует действительности в этом состоянии. Ваши эксперты все еще работают; они просто не могут выходить за пределы KapsuleHost.

Остальная часть Agents не затронута. Чаты, [Skills](https://support.kapsulehost.com/ru-ru/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."** Ваши параметры в безопасности. Обновите страницу. Если проблема сохраняется, [откройте тикет поддержки](https://support.kapsulehost.com/ru-ru/opening-a-support-ticket).

**Эксперт говорит, что не может получить доступ к подключенному приложению.** Проверьте таблицу выше. Не каждый эксперт допущен к каждому приложению, и приложение, подключенное для Iris, не автоматически доступно Mara.

**Подключение зависает в статусе Pending.** Окно входа было закрыто до его завершения. Нажмите **Завершить подключение** и завершите его.

## Стоимость подключений

Использование подключенного приложения в разговоре оценивается как любая другая работа. Каждый вызов, который эксперт делает во внешнее приложение, оценивается с весом вызова подключения, который составляет часть того, что стоит длинный текст. Чтения вашей учетной записи KapsuleHost остаются бесплатными. Полное взвешивание находится в [How Agent Credits Work](https://support.kapsulehost.com/ru-ru/agents-credits).

## Связанные материалы

- [Обзор агентов Kapsule](https://support.kapsulehost.com/ru-ru/agents-overview)
- [Начало работы с Kapsule Agents](https://support.kapsulehost.com/ru-ru/agents-getting-started)
- [Использование навыков Agent](https://support.kapsulehost.com/ru-ru/agents-skills)