Atoms

Подключайте и управляйте Интеграциями

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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

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

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

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

Проверьте:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если возникли проблемы с подключением, см. Устранение неполадок Интеграции.

Была ли эта страница полезной?

Связанные статьи