Отладка выполнения задачи

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

  • Задачи, которые застряли
  • Валидация, которая слишком строгая или слишком мягкая
  • Ошибки агента или средства
  • Поведение распознавания, которое кажется неожиданным

Задачи зависли в статусе "Новый"

Задача остается в новом состоянии. Распространенные причины:

Неудовлетворенные зависимости

Задача зависит от другой задачи, которая не находится в конечном состоянии.

Как проверить: Откройте задачу и проверьте поле Depends on. Проверьте состояние каждой зависимости.

Как исправить:

  • Если зависимость не отвечает, сначала отладите задачу.
  • Если зависимость больше не связана, удалите ее из поля "Зависит от ".
  • Если зависимость завершена, но задача по-прежнему отображается как Новая, модуль когнитивных вычислений еще не начал работу над этой задачей. Подождите 1–2 минуты.

Когниция не работает

Модуль обнаружения может быть остановлен.

Как проверить: Убедитесь, что модуль обнаружения запущен в вашем общем сеансе.

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

Замечание

Модуль обнаружения может остановиться во время обновления службы. Это ожидается. Данные общего сеанса, результаты задач и журнал выполнения сохраняются. Запустите обработчик обнаружения снова, чтобы возобновить работу.

"Discovery Engine не запускается"

Требуемая модель чата для проверки задач не может быть развернута.

Практическое руководство. Проверка наличия в рабочей области развертывания модели чата с именем gpt-5-4 (модель: gpt-5.4).

Как исправить: Разверните модель (см. раздел Создание развертывания модели чата), затем запустите модуль Discovery Engine.

Распознавание занято другими задачами

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

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

Как исправить: дождитесь завершения некоторых задач. Распознавание определяет приоритеты задач на основе готовности к приоритету и зависимости.

Задачи, зависшие в состоянии выполнения

Задача остается в процессе выполнения, пока агент работает над ней. Если он сохраняется в течение необычно длительного времени, что-то может быть неправильно.

Обычное время выполнения

Прежде чем предположить, что задача застряла, рассмотрите то, что происходит:

  • Задачи, доступные только для агента (без вызовов инструментов): обычно выполняются в пределах 1 минуты.
  • Задачи с вызовами инструментов: первый вызов инструмента в сеансе может занять 2–4 минуты из-за старта суперкомпьютера с холодного состояния. Последующие вызовы выполняются быстрее (менее 1 минуты).
  • Задачи с большими вычислениями: некоторые средства выполняют моделирование или крупномасштабный анализ, который занимает 5–15 минут.

Ответ агента застопорился

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

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

Как исправить:

  • Остановите и перезапустите модуль Discovery Engine. Это приводит к переоценке всех задач и выполнению заново прерванного.
  • Если проблема сохранится, проверьте работоспособность развертывания модели в рабочей области.

Сбой выполнения инструмента

Агент вызвал инструмент, но инструмент вернул ошибку.

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

Распространенные ошибки и исправления инструментов:

Error Вероятно, причина Исправление
Сбой выполнения инструмента без журналов Не удалось запустить узел суперкомпьютера (SKU виртуальной машины ограничен, превышена квота) Проверка конфигурации пула узлов и доступности SKU виртуальной машины
Истекло время ожидания подключения к внешнему API Ограничения сети для подсети суперкомпьютера Убедитесь, что необходимые конечные точки доступны из пула узлов. См. статью "Управление пулами суперкомпьютеров и узлов"
Ошибка проверки подлинности (403) Отсутствует назначение ролей для рабочей области или идентификатора суперкомпьютера. Убедитесь, что у управляемого удостоверения есть необходимые роли в учетных записях хранения, реестрах контейнеров и других ресурсах.
Сбой загрузки образа контейнера ACR недоступен из суперкомпьютера или образ не существует Проверьте сетевые правила ACR и убедитесь, что образ загружен.

Задачи переходят между статусами "Выполнение" и "Не завершено"

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

Требования к проверке слишком строгие

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

Как проверить: Ознакомьтесь с комментариями проверки задачи. Каждая попытка включает комментарии, объясняющие, какие требования прошли и какие не были выполнены.

Как исправить:

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

Агент не может выполнять задачу

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

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

Как исправить:

  • Если другой агент будет более подходящим, добавьте комментарий к задаче, указав, какой агент следует использовать и почему (например, "Использовать molToolkit для этой задачи. Для нее требуется проверка RDKit для SMILES"). Когнитивная система читает комментарии при выборе агентов.
  • Если подходящий агент не существует, может потребоваться создать или настроить его. См. основные понятия агента обнаружения.

Описание задачи неоднозначно

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

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

Как исправить: обновите описание задачи с более конкретными сведениями о том, что вы ищете, а затем задайте состояние "Создать".

Задачи, помеченные как необходимые для внимания пользователей

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

Как диагностировать:

  1. Проверка журнала выполнения: сколько запусков было выполнено? Какие подходы были проверены?
  2. Чтение комментариев проверки: какие конкретные требования не удалось выполнить при каждой попытке?
  3. Просмотрите последний результат: что вам нужно, или выключено?

Параметры разрешения:

  • Примите результат: если последний результат достаточно хороший, обновите требования проверки и пометьте задачу "Завершить".
  • Предоставьте рекомендации: Добавьте комментарий, объясняющий, что отсутствует или какой подход попробовать. Присвойте состоянию значение New.
  • Разделите задачу: если задача слишком сложна для одного агента, разложите ее на небольшие дочерние задачи.
  • Выбор агента: Если текущий агент не имеет соответствующих возможностей, добавьте комментарий, указав, какого агента следует использовать и почему, затем верните статус в "Новый".
  • Удалите задачу: если задача больше не актуальна, задайте для нее состояние "Удалено", чтобы когнитивные действия передвигались дальше.

Проблемы когнитивного поведения

Разогрев когниции занимает много времени

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

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

Распознавание продолжает ждать, а не работать

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

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

Практическое руководство. Сначала устраните зависшие задачи. После очистки блокировщиков распознавание возобновляет нормальную операцию.

Когнитивная система присваивает неправильного агента

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

Как проверить: Посмотрите на назначенного агенту задачи и сравните описание его возможностей с потребностями задачи.

Как исправить:

  • Добавьте комментарий в задачу, указывающую, какой агент следует использовать (например, "Для этой задачи требуется paperAnalyzer. Он нуждается в возможностях поиска литературы"). Когниция считывает комментарии при выборе агентов в следующей попытке.
  • Если это происходит неоднократно, убедитесь, что агенты имеют четкие описательные сводки возможностей, чтобы распознавание могло сделать лучший выбор.

Распознавание создает слишком много подзадач

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

Как исправить:

  • Удалите подзадачи, которые не полезны, задав состояние "Удалено".
  • Добавьте комментарий к родительской задаче, чтобы направить процесс мышления и сосредоточиться на конкретных областях.
  • Используйте шаблон направленного исследования вместо полной автономии, чтобы установить границы для познания.

Не удается просмотреть выходные файлы

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

Почему это происходит: агенты создают файлы с помощью управляемого удостоверения платформы. При просмотре файлов в VS Code браузер использует вашу идентификацию для прямого доступа к хранилищу BLOB-объектов. Это два отдельных пути доступа.

Для просмотра файлов необходимо выполнить три действия.

Проверьте Требуемые параметры Кто его исправляет?
Network Ваш IP-адрес (или VPN) должен быть разрешен фаерволом хранилища. Администратор
CORS Учетная запись хранения должна разрешать запросы из vscode.dev и *.vscode-cdn.net Администратор
Разрешения Вашей учетной записи требуется средство чтения данных BLOB-объектов хранилища в учетной записи хранения. Администратор

Если какой-либо из них отсутствует, при нажатии ссылок на файлы появится сообщение об ошибке, даже если файлы были созданы успешно.

Как исправить: обратитесь к администратору с именем учетной записи хранения (видимым в свойствах контейнера хранилища) и попросите их проверить все три элемента. Полные требования к конфигурации см. в разделе Обнаружение Хранилище BLOB-объектов Azure в Microsoft.

Замечание

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

Проверка работоспособности общего сеанса

Чтобы быстро оценить состояние общего сеанса, выполните следующее:

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

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