Интеграции подключают Atoms к инструментам и сервисам, которыми вы уже пользуетесь. В зависимости от коннектора Atoms может использовать внешнюю информацию, помогая вам создавать, добавлять возможности в ваше опубликованное приложение или поддерживать оба рабочих процесса.

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

Используйте учетную запись и область разрешений с минимально необходимыми привилегиями, достаточными для выполнения задачи. Не вставляйте пароли, токены доступа, закрытые ключи или несвязанные конфиденциальные данные в промпт. Если сервис содержит производственные данные или данные клиентов, тестируйте на нечувствительном образце и проверяйте точную цель перед разрешением записи.

Коннекторы и действия, которые вы видите, могут различаться в зависимости от учетной записи и релиза. Откройте каталог коннекторов в Atoms, чтобы посмотреть, что сейчас вам доступно.

Определите, что должно делать подключение

Прежде чем подключать сервис, определите, где он вам нужен.

Цель	Примеры
Дать Agent контекст, пока вы создаете	Находить файлы, суммировать задачи, просматривать issues или использовать данные проекта в промпте
Позволить Agent выполнять действия в другом сервисе	Создать задачу, обновить запись, добавить данные в таблицу или создать событие в календаре
Добавить сервис в опубликованное приложение	Хранить данные приложения, обрабатывать аутентификацию, обрабатывать платежи или запускать рабочий процесс приложения

Некоторые коннекторы поддерживают более одной цели. Перед подключением просмотрите описание коннектора и запрашиваемые разрешения.

Подключение интеграции

Откройте Settings → Connectors, чтобы использовать основную точку входа. Вы также можете выбрать Подключите ваши инструменты к Atoms на панели управления.

Для подключения или отключения интеграции может потребоваться доступ владельца рабочего пространства или авторизованного администратора. Если вы не владелец и не администратор, а элемент управления недоступен, обратитесь к владельцу рабочего пространства или авторизованному администратору.

С панели управления

1. Откройте панель управления Atoms.
2. Выберите Подключите ваши инструменты к Atoms.
3. Выберите коннектор, который хотите использовать. Следуйте элементу управления подключением, показанному на карточке этого коннектора.
4. Используйте элемент управления, показанный для этого коннектора. Если он открывает общую панель сведений, выберите Connect; интеграции конкретных провайдеров могут открывать собственный процесс настройки или авторизации.
5. При необходимости войдите во внешний сервис.
6. Проверьте учетную запись и разрешения, затем подтвердите подключение.
7. Вернитесь в Atoms и убедитесь, что коннектор отображается как подключенный. В Chat, где вы хотите его использовать, откройте средство выбора коннекторов и включите коннектор для этого Chat.

Использование подключенной интеграции

Укажите Agent, какой сервис использовать, и добавьте достаточно деталей, чтобы определить правильный объект. Полезные детали включают:

• Название проекта, рабочего пространства, репозитория, папки, календаря или таблицы
• Название задачи, ID issue, имя файла или идентификатор записи
• Диапазон дат, срок выполнения, владелец, статус или приоритет
• Что именно вы хотите, чтобы Atoms прочитал, суммировал, создал или обновил

Например:

• “Суммируй назначенные мне issues Linear с высоким приоритетом.”
• “Найди launch brief в Drive и перечисли открытые решения.”
• “Добавь эти одобренные лиды в таблицу кампании.”
• “Создай событие в календаре для дизайн-ревью в следующий вторник в 15:00.”

Atoms может использовать только действия, поддерживаемые коннектором, и данные, доступные подключенной учетной записи. Если возможность или действие, которое вам нужно, не показано для этого коннектора, остановитесь и не предполагайте, что оно поддерживается.

Проверяйте внешние изменения перед выполнением

Когда коннектор и действие поддерживают создание или обновление внешних данных, Atoms может показывать подтверждение перед выполнением.

Проверьте:

• Сервис и подключенную учетную запись
• Целевой файл, таблицу, календарь, проект или запись
• Информацию, которая будет создана или изменена
• Любую дату, время, получателя или другое важное значение

Если Atoms показывает подтверждение, проверьте его и выберите Confirm, чтобы продолжить, или отмените, чтобы оставить внешний сервис без изменений. Доступность записи зависит от коннектора и действия; коннекторы только для чтения не предлагают действий записи.

После записи проверьте результат во внешнем сервисе перед повторной попыткой. Если цель или значения неверны, остановите рабочий процесс и используйте собственные инструменты провайдера для истории, отмены или восстановления, если они доступны. Отключение коннектора останавливает дальнейшее использование; уже внесенные изменения оно не отменяет.

Управление подключением

Откройте каталог коннекторов и выберите подключенный сервис, чтобы просмотреть его текущий статус.

На панели сведений о коннекторе вы можете:

• Проверить, какая учетная запись подключена
• Просмотреть поддерживаемые коннектором действия и область разрешений
• Повторно подключиться, если срок авторизации истек
• Обновить или изменить доступ, если сервис это поддерживает
• Отключить учетную запись от Atoms

Отключение в Atoms прекращает дальнейшее использование подключения. Некоторые сервисы также могут потребовать, чтобы вы отозвали доступ Atoms в собственных настройках учетной записи или безопасности сервиса.

Примеры по сценариям использования

Таблица ниже — это редакционная группировка по сценариям использования, а не набор категорий каталога. Используйте каталог с поиском, чтобы увидеть актуальный список доступных коннекторов.

Категория	Распространенные применения	Примеры
Разработка	Контроль версий, репозитории, issues и процессы поставки	GitHub, Linear
Бэкенд и данные	Базы данных, аутентификация, хранилище и структурированные данные	Supabase
Платежи	Оформление заказа, биллинг и платежные процессы	Stripe
Управление работой	Задачи, проекты, владельцы и сроки выполнения	Asana, Todoist
Файлы и контент	Поиск, чтение и организация внешних файлов	Box, Dropbox
Аналитика и маркетинг	Трафик, эффективность поиска, кампании и отчетность	Google Analytics 4, Google Search Console, Google Ads

Доступность коннекторов со временем меняется. Используйте каталог в Atoms, чтобы увидеть актуальный список, и откройте коннектор, чтобы просмотреть его точные возможности.

Руководства по настройке

Выберите руководство для вашего сервиса:

• Подключение GitHub
• Подключение Supabase
• Подключение GA4
• Подключение Google Search Console
• Подключение Google Ads

При проблемах с подключением см. Устранение неполадок интеграции.