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

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

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

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

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

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

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

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

Что вы видите	С чего начать
Сервис отсутствует или его элементы управления недоступны	Найти или запустить интеграцию
Окно входа не открывается, блокируется или процесс никогда не завершается	Завершить авторизацию
Подключение использует другую учетную запись	Проверьте подключенную учетную запись
Подключено, но Agent не может найти ресурс	Проверьте подключение и доступ к данным
Чтение работает, но создание или редактирование не удается	Проверьте доступ на запись и поддерживаемые действия
Ранее работавшее подключение перестало работать	Проверьте, что изменилось
Результаты устарели, запросы завершаются по тайм-ауту или ошибки повторяются	Проверьте запрос и доступность сервиса

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например, если коннектор поддерживает чтение документов: “Используй [service], чтобы прочитать [document name or link] и сообщить мне его заголовок. Не изменяй его.”

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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