Устранение ошибок рабочего процесса: с чего начать?

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

Автор: Ai Flowi · Техническая проверка: Janice Lee, техническая поддержка, Ai Flowi.

Опубликовано · Обновлено 9 октября 2026

Выберите подходящую проверку

Начните с раздела «Типичные ошибки», если проблема связана с отсутствующими компонентами, несовместимыми портами, настройкой модели, импортом или обновлениями компонентов. Используйте раздел «Подключения Google» для аутентификации и разрешений, а «Вебхуки» — для входящих запросов или ответов. При сбоях, специфичных для Telegram, выполните базовые проверки вебхука, прежде чем открывать раздел об устранении ошибок Telegram. Сначала прочитайте ошибку, затем после каждого изменения повторно проверяйте наименьший участок процесса, на котором воспроизводится сбой.

  1. Типичные ошибки — отсутствующие компоненты, несовместимые типы портов, настройка модели, импорт и обновления компонентов. Используйте этот раздел, если соединение в редакторе не удаётся создать или после изменения рабочий процесс ведёт себя иначе.
  2. Подключения Google — сохранённые Connections, разрешения аккаунта, области доступа и повторная авторизация. Используйте этот раздел, если компонент Google не может пройти аутентификацию или выполнить действие.
  3. Вебхуки — отклонённые HTTP-методы, компоненты ответа и запросы, которые не попадают на ожидаемый путь рабочего процесса. Используйте этот раздел при сбое входящего запроса или ответа.
  4. Устранение ошибок Telegram — сбои, специфичные для Telegram, после базовых проверок вебхука.

При сбое, специфичном для Telegram, используйте устранение ошибок Telegram после базовых проверок вебхука. Настройка вебхука Telegram и разбор обновлений — описанные в документации расширения со своими проверками.

Рекомендуемый порядок диагностики

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

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

Изучите записанные трассировки рабочего процесса

В разделе Traces в AI Flowi Workflow отображаются записанные запуски рабочих процессов для анализа. Откройте Traces для нужного процесса, выполните поиск запусков и отфильтруйте их по Success, Error или диапазону дат. Выберите запуск, чтобы открыть Trace Details. В этом разделе отображаются ранее записанные данные трассировки; пустой список или отсутствующая трассировка не могут объяснить незаписанное выполнение. Чтобы интерпретировать данные запусков моделей, прочитайте руководство по наблюдаемости LLM вместе с подробностями трассировки.

Используйте Group by Session для группировки отображаемых запусков или Reload, чтобы снова загрузить список. Download экспортирует в JSON записи о запусках, загруженные на данный момент.

Изучите спан внутри запуска

Trace Details содержит дерево спанов и панель подробностей выбранного спана. Выберите спан, чтобы изучить его статус и задержку, а также имя модели, входные и выходные данные и ошибку, если эти сведения записаны.

Общее число токенов и число токенов запроса и ответа отображаются, когда доступны данные об использовании токенов; для спана LLM без этих данных показываются прочерки. Estimated Cost появляется, только если записанные данные об использовании токенов содержат стоимость больше нуля. Если у спана нет входных данных, выходных данных или ошибки, панель сообщает, что дополнительных сведений нет.

Типичные ошибки · Основы рабочих процессов · С чего начать работу с ИИ