Устранение неполадок Интеграции

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

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

Начните с этих проверок

1. Проверьте, где происходит сбой. Agent не может использовать сервис в Chat, или функция не работает только в вашем приложении? Подключение сервиса для Chat само по себе не подтверждает, что ваше приложение настроено правильно. Если сбой происходит только в приложении, см. Подключение и управление Интеграциями.
2. Откройте Интеграцию. В Chat вашего проекта откройте меню параметров рядом с полем ввода сообщения, затем выберите Connectors → Add connectors. Найдите и выберите сервис. Проверьте, подключен ли он или по-прежнему предлагает Connect. Некоторые сервисы открывают собственный экран управления.
3. Проверьте доступ в самом сервисе. Убедитесь, что учетная запись, которую вы собирались подключить, может открыть именно тот файл, репозиторий, календарь, объект недвижимости или другой задействованный ресурс.
4. Сохраните ошибку, прежде чем что-либо менять. Запишите точное сообщение, дату и время с часовым поясом, затронутый проект или Chat, а также время последней успешной попытки. Удалите конфиденциальную информацию со скриншотов.

Откройте параметры ввода Chat, выберите Connectors (1), затем Add connectors (2), чтобы просмотреть доступные Интеграции.

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

Храните учетные данные в тайне. Никогда не вставляйте пароли, коды входа, API-ключи, токены доступа или другие секретные данные в Chat или в запрос в поддержку. Вводите учетные данные только в процессе входа сервиса или в специально предназначенное защищенное поле конфигурации.

Найдите свою проблему

Вы не можете найти или запустить Интеграцию

1. Используйте Add connectors для поиска в каталоге. Более короткий список в меню Chat не является полным каталогом.
2. Если Atoms сообщает, что функция доступна только внутри проекта, откройте нужный проект и попробуйте там.
3. Если элемент управления отключен, прочитайте его пояснение. Если требуется другая роль или разрешение, попросите владельца проекта или рабочего пространства помочь. Не отключайте другой сервис только для обхода ограничения.

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

Авторизация не завершается

1. Выберите Connect один раз и найдите окно входа сервиса. Если ваш Браузер сообщает о заблокированном всплывающем окне, разрешите всплывающие окна для сайта Atoms и попробуйте снова. В Chrome следуйте инструкциям по разрешению всплывающих окон для определенного сайта; вам не нужно включать их для каждого сайта.
2. Выберите нужную учетную запись и проверьте запрашиваемый доступ. Завершите процесс авторизации сервиса, прежде чем закрывать его окно.
3. Если сервис явно сообщает, что ваша организация заблокировала приложение или запрашиваемый доступ, сохраните сообщение и свяжитесь со своим администратором. Не обходите политику вашей организации.
4. Вернитесь в Atoms и снова откройте Интеграцию, чтобы проверить ее состояние. Закрытие окна входа не является подтверждением того, что авторизация прошла успешно.

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

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

Проверьте результат: Интеграция отображается как подключенная. На экранах сведений о коннекторе, использующих стандартный макет, Connect заменяется на Disconnect и Try it out. У других сервисов могут быть собственные макеты. Если по-прежнему предлагается Connect или отображается ошибка, зафиксируйте этот результат и обратитесь в поддержку после одной новой попытки.

Подключена неправильная учетная запись

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

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

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

Интеграция подключена, но Agent не может найти ваши данные

1. Проверьте подключение. Откройте сведения об Интеграции в Connectors и убедитесь, что она подключена. Проверьте выбранную учетную запись или ресурс, если они отображаются.
2. Проверьте точный ресурс. Откройте его напрямую в сервисе с нужной учетной записью. Подтвердите его расположение и права доступа, включая правильную организацию, рабочее пространство, папку или объект, если это применимо.
3. Сделайте запрос конкретным. Укажите сервис и точное имя ресурса или ссылку, если коннектор это поддерживает. Сначала запросите одно поддерживаемое действие чтения, а не ищите и не изменяйте сразу несколько ресурсов.

Например, если коннектор поддерживает чтение документов: “Use [service] to read [document name or link] and tell me its title. Do not change it.”

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

Agent может читать данные, но не может их изменить

Успешное чтение не подтверждает, что коннектор поддерживает запрошенное изменение или имеет разрешение на его выполнение.

1. См. Подключение и управление Интеграциями или список коннектора What you can do, если он отображается. Убедитесь, что запрошенное действие поддерживается.
2. Проверьте, разрешено ли подключенной учетной записи вносить это изменение в точный ресурс. Попросите владельца ресурса или администратора предоставить только необходимый доступ.
3. Прочитайте любое сообщение об ошибке или запрос на подтверждение. Если требуется дополнительная авторизация, следуйте документированному процессу сервиса. Переподключение не может добавить действие, которое коннектор не поддерживает.

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

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

Подключение, которое раньше работало, перестало работать

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

1. Снова откройте Интеграцию в Atoms и проверьте, остается ли она подключенной.
2. Попробуйте открыть ресурс напрямую в сервисе. Если доступ был удален, решите этот вопрос с владельцем ресурса или администратором.
3. Если ошибка говорит, что срок авторизации истек, она была отозвана или недействительна, следуйте разделу Безопасное переподключение. Если ошибка связана со сбоем сервиса, ограничением или неподдерживаемым действием, сначала устраните эту причину.

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

Результаты устарели или запрос продолжает завершаться ошибкой

1. Сравните результат с самим сервисом. При необходимости подтвердите учетную запись, ресурс, диапазон дат, фильтры и часовой пояс. Попросите Agent получить текущее значение, а не полагаться на более ранний ответ в разговоре.
2. При явной ошибке тайм-аута или недоступности сервиса проверьте официальную страницу статуса или справки сервиса. Если в ошибке указано время повторной попытки, подождите до этого момента; не отправляйте повторные запросы, пока сохраняется ограничение или сбой.
3. Сохраните любой неотправленный текст, обновите Atoms и снова проверьте состояние коннектора. Обновление страницы — это не то же самое, что повторная авторизация учетной записи.
4. Повторите один небольшой запрос на чтение. Прежде чем повторять что-либо, что изменяет внешние данные, проверьте место назначения на предмет предыдущего результата.

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

Безопасное переподключение

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

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

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

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

Убедитесь, что проблема решена

1. Запросите одно поддерживаемое действие только для чтения на ресурсе, который вы можете проверить напрямую. Если вы используете Try it out, просмотрите предложенный промпт перед отправкой.
2. Сравните ответ с самим сервисом. Подтвердите правильный ресурс, контекст учетной записи и запрошенный результат, а не только индикатор подключения.
3. Если ваша задача требует изменений, используйте подходящий тестовый ресурс или документированный тестовый процесс сервиса и проверьте результат в месте назначения.

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

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

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

Получить помощь

Если проблема сохраняется, используйте Получить поддержку и укажите:

• Название Интеграции и адрес электронной почты вашей учетной записи Atoms.
• Ссылку на затронутый проект или Chat, а также происходит ли сбой в Chat или в вашем приложении. Для приложения укажите затронутую среду.
• Предполагаемую учетную запись сервиса и ресурс, используя только несекретные идентификаторы, необходимые для расследования.
• Точную ошибку, дату, время и часовой пояс; укажите также время последнего успешного запроса, если оно известно.
• Шаги для воспроизведения, ожидаемый результат, фактический результат и уже выполненные проверки.
• Ваш Браузер и устройство, а также отредактированные скриншоты или короткую запись, если это полезно.

При неудачной записи укажите, показывает ли место назначения завершенное изменение, отсутствие изменений или неизвестный результат. Удалите пароли, коды входа, API-ключи, токены и не относящиеся к делу личные данные из всех вложений.