Saltar al contenido
Menú de documentación

Vuelo libre, pipelines, tareas y preguntas

En esta página

Siga una sola ejecución registrada. Gestione las tareas delegadas y las preguntas al usuario sin crear solicitudes duplicadas.

Usar estas herramientas

  1. Llame primero a la herramienta de lectura o de consulta de estado correspondiente.
  2. Revise el destino y los argumentos obligatorios.
  3. Ejecute una sola acción prevista, con confirmación humana explícita cuando sea necesaria.
  4. Después, consulte el estado o vuelva a leer el recurso afectado.

Los parámetros que se indican a continuación describen el contrato público. La lista actual de herramientas del servidor conectado es la referencia definitiva. Algunas herramientas requieren un host, un destino, un modo de inferencia o un plan concretos. Los identificadores son valores que devuelven las herramientas llamadas antes; no los invente.

modify_project

Pedir al agente un cambio de alcance abierto.

Inicia un desarrollo de alcance abierto. Especifique el resultado solicitado y los límites de acceso que deben mantenerse. Siga la ejecución indicada en la respuesta.

Argumento Obligatorio Tipo o valores aceptados
prompt Sí cadena; longitud mínima 1
projectId No cadena

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

pipeline_status

Dónde se detuvo una ejecución.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
runId Sí cadena
projectId No cadena

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

resume_pipeline

Continuar una ejecución que se detuvo.

Continúe la ejecución detenida que quedó registrada. Consulte pipeline_status antes de establecer un punto de reinicio opcional.

Argumento Obligatorio Tipo o valores aceptados
runId Sí cadena
projectId No cadena
from No cadena

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

next_task

Obtener la siguiente llamada al modelo que debe realizarse.

Recoge una tarea de inferencia delegada. Es normal que una espera termine sin devolver una tarea. Conserve taskId para asociarlo al resultado correspondiente.

Argumento Obligatorio Tipo o valores aceptados
maxWaitSec No entero; mínimo 0; máximo 45
taskId No cadena

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia delegada.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

submit_task_result

Devolver lo que produjo el subagente.

Devuelva el resultado de la tarea una sola vez y en el formato solicitado. No vuelva a enviar una tarea completada como una solicitud nueva.

Argumento Obligatorio Tipo o valores aceptados
taskId Sí cadena
result Sí cadena / objeto / lista de valores

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia delegada.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

next_question

Obtener la pregunta que plantea la plataforma.

Obtenga una pregunta pendiente y preséntela a la persona que deba decidir. Proporcione projectId para la ejecución correspondiente. Si una espera no devuelve ninguna pregunta, consulte el estado del dominio para comprobar pendingInquiry antes de volver a consultar.

Argumento Obligatorio Tipo o valores aceptados
maxWaitSec No entero; mínimo 0; máximo 45
questionId No cadena
projectId No cadena

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

answer_question

Enviar la decisión tomada.

Responda con el mismo identificador de pregunta. No invente el consentimiento de un usuario ni envíe campos de respuesta contradictorios.

Argumento Obligatorio Tipo o valores aceptados
questionId Sí cadena
answer No cadena / lista de cadenas
text No cadena
declined No booleano
projectId No cadena

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

Referencias relacionadas

Inicio de MCP · Flujo de recuperación · Costos