Меню документации

Свободный полёт, пайплайны, задачи и вопросы

На этой странице

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

Использование инструментов

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

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

modify_project

Попросите агента внести изменения, описав задачу в свободной форме.

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

АргументОбязательныйТип или допустимые значения

| prompt | Да | строка; минимальная длина 1 |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

pipeline_status

Где остановился запуск.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| runId | Да | строка |

| projectId | Нет | строка |

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

resume_pipeline

Продолжите остановленный запуск.

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

АргументОбязательныйТип или допустимые значения

| runId | Да | строка |

| projectId | Нет | строка |

| from | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

next_task

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

Возвращает задачу делегированного инференса. Если ожидание завершилось без задачи, это нормально. Сохраните taskId, чтобы передать результат соответствующей задачи.

АргументОбязательныйТип или допустимые значения

| maxWaitSec | Нет | целое число; минимум 0; максимум 45 |

| taskId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, делегированный инференс; stdio, локальный проект, делегированный инференс.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

submit_task_result

Передайте результат работы субагента.

Верните результат задачи один раз в запрошенном формате. Не отправляйте завершённую задачу повторно как новый запрос.

АргументОбязательныйТип или допустимые значения

| taskId | Да | строка |

| result | Да | строка / объект / массив значений |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, делегированный инференс; stdio, локальный проект, делегированный инференс.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

next_question

Получите вопрос от платформы.

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

АргументОбязательныйТип или допустимые значения

| maxWaitSec | Нет | целое число; минимум 0; максимум 45 |

| questionId | Нет | строка |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

answer_question

Передайте принятое решение.

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

АргументОбязательныйТип или допустимые значения

| questionId | Да | строка |

| answer | Нет | строка / массив строк |

| text | Нет | строка |

| declined | Нет | логическое значение |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

Связанные справочные материалы

Главная страница MCP · Порядок восстановления работы · Стоимость