Referencia del gráfico del agente
Controles, campos de esquema, ciclo de vida de ejecución y límites para Graph Agent Studio. Para un ejemplo guiado, comience con Cree su primer gráfico de agente.
Recorrido por el estudio Graph Agent.
Ábrelo desde Tiet · Agentic, luego Agents, luego la pestaña Agent Graphs (la pestaña muestra el número de gráficos, por ejemplo "Gráficos de agentes (3)"; su dirección es /studio/graphs). Elige un gráfico de la lista o crea uno con el botón New graph (título "Nuevo gráfico", diálogo "Nuevo gráfico", marcador de posición de campo "por ejemplo, QA + Canalización de redacción", botón Create).
Barra de herramientas
| Control | Lo que hace |
|---|---|
| New graph / New version (botones de iconos) | Crea un gráfico o una nueva versión (marcador de posición 1.0.0). |
| + Node (etiqueta "Nodo", información sobre herramientas "Añadir un nodo") | Agregar un nodo. Deshabilitado en una versión publicada: "Las versiones publicadas son inmutables; primero cree un borrador". |
| Draft (información sobre herramientas "Dibuja este gráfico a partir de una descripción") | La IA genera un gráfico a partir de la descripción que introduzcas. Revisa el resultado antes de confiar en él. |
| Save | Muestra Unsaved, Saved o Save error. En una versión publicada, la información sobre herramientas dice: "Las versiones publicadas son inmutables; al guardar se creará un nuevo borrador (se bifurca la versión actual)". |
| Publish | Publica la versión. Información sobre herramientas: "Publicar esta versión (necesario para ejecutar)". Deshabilitado si ya está publicada. |
| Validate | Información sobre herramientas: "Validar la estructura del grafo (entrada/salida, accesibilidad, rutas, bucles)". Muestra errores y advertencias en el editor. |
| Run (botón de división) | Run ("Ejecutar el gráfico completo") y, en el menú de flecha, Debug step-by-step ("Pausar en cada nodo"). Deshabilitado hasta que se publique una versión. Un cuadro de diálogo titulado "Ejecutar gráfico" o "Ejecución de depuración" solicita la entrada (un Form de su input_schema o Raw JSON, y un Preset de la lista si guardó ejemplos). |
| Pause, Cancel | Aparece mientras la partida está activa. |
Los superusuarios también ven un botón con el Catalog que permite compartir un gráfico publicado con todas las organizaciones.
Panel izquierdo: Nodos y paleta
Nodes muestra los nodos de la versión abierta con un cuadro de búsqueda. Palette muestra lo que puedes arrastrar al lienzo:
| Sección | Entradas |
|---|---|
| Centro | Agente existente, LLM en línea, Agente de herramientas, Planificador |
| Enrutamiento | Enrutador (ruta única, dos rutas predefinidas), Enrutador múltiple (varias rutas, distribución), Puerta de verificación (puerta de verificación más la ruta __verify_failed__) |
| Tiempo de ejecución | Revisión humana (punto de control con intervención humana), agente de memoria, lector de archivos adjuntos |
| Determinista | Una entrada por cada manejador determinista que el servidor reporta, nombrada por su handler_type |
Herramientas de borde
Encima del lienzo, elige cómo se comportará la siguiente conexión que dibujes:
| Herramienta | Significado (información emergente) |
|---|---|
| Auto | Inferir ruta o alternativa desde el puerto de origen |
| Chain | borde determinista |
| Parallel | Arista de abanico con gráfico fan_out_mode=all |
| Cycle | Arista trasera acotada con recorridos máximos |
| Route | borde de ruta desde una ruta con nombre |
| Fallback | borde de reserva |
| Join | Únete a Edge para la entrada de fans. |
| Condition | Borde determinista que abre el editor de condiciones |
Al hacer clic en un borde se abre su diálogo: Source node, Target node, Kind (Determinista, Ruta, Reserva, Unir), Route Name, una condición, Transform, Priority y Max Traversals. El lienzo también tiene zoom, Fit view, Auto-arrange nodes, y un interruptor de borde Routing (Smart u Curved).
inspector de nodos
Haz clic en un nodo para abrir el inspector en el panel derecho. Sus pestañas son General, Model, Prompt, Tools, Memory, Routing y Verify.
| Pestaña | Lo que configuraste |
|---|---|
| General | Nombre para mostrar, descripción, Set as entry / Entry node, Mark as exit / Exit node, interruptores Human-in-the-loop, Receive attachments, Memory, el Memory backend (Heredar, Plano, Memora, mostrado con el interruptor Memoria), la opción Prompt-injection defence (Heredar, Directiva de plataforma, Directiva personalizada, Desactivado), Max retries, Timeout (ms). |
| Modelo | Language model, Max tokens, Streaming; para los nodos RLM y ParSer, el modo de ejecución y sus campos. |
| Inmediato | System Prompt (una plantilla Go sobre estado compartido). |
| Herramientas | Add tool del catálogo de herramientas de la organización, Add skill. |
| Memoria | El editor de control de memoria (pestaña "Memoria"). |
| Enrutamiento | Routing mode (none, single, multi) y la lista de rutas (nombre más una descripción que se muestra al modelo). |
| Verificar | Verification gate con Mode (juez, fundamentado, consenso), Evidence state keys, Verifiers, Pass threshold, Min confidence, Verifier model, Candidate key, Rubric. |
Al agregar un nodo, puede hacer referencia a un agente existente, crear uno New agent) o elegir Inline node ("Un nodo con su propio mensaje y modelo integrados; no se necesita registro de agente"). Un nodo determinista (de la sección Paleta Determinista) no tiene modelo, mensaje ni herramientas.
Panel derecho
Pestañas: Info, Usage, History, API, Assistant.
- Info: nombre y descripción del gráfico, Guards (Max Steps, Fan-Out Mode, Scheduling, Workers), Prompt-injection defence (Boundary directive), Runtime patterns (qué tipos de aristas usa el gráfico), Medical inference (Expose to inference, Default engine).
- Usage: Intended use, Intended users, Run inputs (tu
input_schema), Example presets. - History: ejecuciones anteriores con sus pasos y llamadas a herramientas.
- API:
curlFragmentos de código TypeScript y Python listos para usar, y un botón para crear un token con alcance limitado agraph:<id>:execute. - Assistant: un copiloto que responde preguntas o genera un gráfico para una tarea.
Panel inferior y depuración
Pestañas inferiores: Events (n), Step Output, Step Inspector, Trace, Variables. El Inspector de pasos muestra Input, Output, Resolved prompt, Thinking, el registro de verificación y Tool calls (n). Trace enlaces al Explorador de trazas (árbol de expansión completa, costo, reintentos, ejecuciones anidadas).
En una ejecución de depuración, el panel de depuración tiene Continue (F5), Step over (F10), Step into (F11) y Stop, además de tres pestañas: Overrides (Override route, Mock tool call, editar la entrada y Apply & Continue), Step Inspector (con Rerun step) y Breakpoints. Los tipos de puntos de interrupción son before_node, after_prompt_render, before_tool_call, after_tool_call y after_node; deje el ID del nodo en blanco para detenerse en todos los nodos.
Una ejecución que llega a un nodo de intervención humana abre un cuadro de diálogo titulado Human Review Required con un campo Payload (JSON) y botones Skip y Submit.
Anatomía de un gráfico
Studio edita un documento JSON, la definición. Puedes leerlo y escribirlo a través de la API (el endpoint de versión acepta {"version": "1.0.0", "definition": {...}}). Todo lo que aparece a continuación es un campo de ese documento.
Campos de nivel superior
| Campo | Significado | Regla |
|---|---|---|
entry_node_id | Primer nodo en ejecutarse | Obligatorio, debe coincidir con un nodo. |
exit_node_ids | Nodos donde puede finalizar la ejecución | Al menos uno; cada uno debe coincidir con un nodo. La respuesta es el text del nodo de salida. |
nodes, edges | El gráfico | Los identificadores son únicos; cada arista necesita un id y un origen y destino existentes. |
guards | Límites estrictos (abajo) | Se requiere max_total_steps y debe ser mayor que 0. |
fan_out_mode | all (predeterminado), first, by_priority | Cómo se comportan varios bordes coincidentes que no son rutas desde un nodo. first y by_priority activan los priority números más bajos. |
scheduling | mode serial (predeterminado) o parallel, max_parallel_workers | El procesamiento en serie necesita 0 trabajadores. El procesamiento en paralelo necesita al menos 2 y no más del límite de nodos activos. |
compliance | regulated, affects_clinical_output, data_classification (none, pseudonymised, phi), research_only | No hay bloqueo significa "clínico" (seguridad y gobernanza). |
input_schema | Entradas de ejecución escritas: key, label, type (string, text, number, boolean, json), required, default, description, enum | Controla el formulario de ejecución. Vacío significa un texto libre query. |
examples | Preajustes de entrada guardados (name, description, input) | Se muestra como Preset en el cuadro de diálogo de ejecución. |
intended_use | statement, intended_users | Documentación versionada con el gráfico, no obligatoria. |
metadata | owner, tags, protocol_ref, schedule_permission | No es utilizado por el motor. |
variables, shared_state_schema | Declaraciones de lo que fluye a través del gráfico | Solo declaración. Una variable necesita un nombre en minúsculas, una descripción, un tipo conocido y su origen. |
prompt_defense | Valor predeterminado a nivel de gráfico para la defensa contra inyecciones | Un nodo puede anularlo. Activado por defecto. |
Tipos de nodos
Cada nodo tiene id, name (ambos obligatorios), un description opcional y un lienzo position. El tipo se decide según lo que configures.
1. Nodo de modelo (LLM). El predeterminado. Necesita un modelo y una solicitud, cada uno de un solo lugar:
| Necesidad | Opciones |
|---|---|
| Modelo | inline_model_config (provider, model_name, temperature, max_tokens), o model_config_ref (id, version), o agent_id (el propio modelo del agente). |
| Inmediato | inline_prompt.template, o prompt_ref (id, version), o agent_id (la indicación del agente, usada tal como está escrita, seguida de ## Input y el text anterior). |
Otros campos: tool_refs (id, version, opcional allowed_urls), skill_slugs y skill_refs, max_tool_rounds (predeterminado 5, como máximo 20), fallback_models (seguridad y gobernanza), retry_policy (max_attempts, backoff_ms, retry_on), timeout_ms, thinking_tokens (un techo, no un interruptor), routing_mode y routes, verification, checks, memory_config, record_only, accept_attachments, inherit_agent_tools, access_requests, retry_safe, output_schema (ver la nota en errores comunes de gráficos).
2. Nodo determinista. Establecer handler_type y handler_config. El motor ejecuta código registrado en lugar de un modelo. No debe declarar un modelo, solicitud, agente, tool_refs, max_tool_rounds, fallback_models, checks o verification. Aún así, recibe reintentos, un tiempo de espera, una fila de paso, puntos de interrupción y eventos. Tipos de manejadores integrados:
handler_type | Hace | Clase de efecto |
|---|---|---|
fhir.read | FHIR search o read. Una búsqueda necesita al menos un filtro. | leer |
fhir.propose | Crea o actualiza recursos FHIR solo en estado de borrador o propuesto. Un PUT requiere ifMatch. | proponer |
fhir.write | Cualquier operación FHIR | escribir (solo ejecuciones autónomas) |
notify.send | Mensaje de Slack o webhook | escribir |
script.run | Un script de Python fijo. Lee sus entradas como context y asigna un diccionario al valor output. | leer |
El servidor también registra los manejadores de dominio (por ejemplo record.build, record.snapshot, signal.infer). La sección Paleta determinista enumera las opciones que ofrece su servidor.
Un controlador puenteado se configura de la siguiente manera (según las notas de diseño):
{"id": "fhir_slots", "name": "Find slots", "handler_type": "fhir.read",
"handler_config": {"config": {"operation": "search", "resource_type": "Slot"},
"inputs": {"search_params": "val.slot_search"},
"optional_inputs": {}, "values": {}, "output_key": "slots"}}
inputs asigna un puerto de controlador a una ruta de estado compartido; una ruta faltante hace que el paso falle. El resultado se fusiona en el estado compartido bajo output_key. Los controladores que proponen o escriben se ejecutan una vez e ignoran retry_policy.
3. Nodo RLM. execution_mode: "rlm" más rlm.context_state_keys (obligatorio, sin claves vacías ni repetidas). El modelo funciona con entradas grandes en un entorno de código en lugar de leerlas en el indicador. No se puede combinar con handler_type.
4. Nodo ParSer. execution_mode: "parser" más un bloque parser (claves de contexto o fuentes de adjuntos, un modelo de lector, límites de turno y fragmento). Los modelos de lector baratos citan registros largos. Publish rechaza un gráfico cuyo guards.max_model_calls no puede cubrir una activación. El ejemplo inicial es parser-long-record-qa.json en el repositorio tietai-hydra-platform.
5. Nodo de intervención humana. human_in_the_loop: true. La ejecución se pausa hasta que una persona envía una carga útil JSON, que se convierte en la salida del nodo. Aún necesita un modelo y una solicitud para pasar la validación (no se utilizan mientras espera) y no puede tener una puerta de verificación.
Bordes
| Campo | Significado |
|---|---|
kind | deterministic (predeterminado; siempre se activa, opcionalmente protegido por condition), route (se activa cuando la salida de la fuente elige route_name), fallback (se activa cuando no se encuentra ninguna coincidencia de borde de ruta), join (barrera). |
route_name | Requerido para route aristas. |
condition | Un guardia evaluado después de que el tipo coincide. Sintaxis: rutas de puntos sobre output. (el nodo que acaba de ejecutarse) y state. (estado compartido), ==, !=, <, >, <=, >=, &&, ` |
transform | { key: path, ... }, asigna la salida de origen a la entrada de destino. Si está vacío, deja pasar la salida. |
priority | Gana el número más bajo cuando fan_out_mode es first o by_priority. |
max_traversals | Con qué frecuencia puede activarse este borde en una sola ejecución. 0 significa ilimitado. |
Join aristas crean una barrera: el destino se ejecuta una vez, cuando todas las aristas de unión que llegan a él han llegado. El motor mantiene las llegadas a través de pausas y reinicios. Reglas verificadas en la publicación: el nodo de origen debe tener routing_mode none o estar vacío, una arista de unión no puede tener un condition, y un destino de unión necesita al menos dos padres de unión.
Modos de enrutamiento
routing_mode | El modelo debe devolver | Bordes que disparan |
|---|---|---|
none (o vacío) | nada especial | Los bordes que no son rutas y cuya condición se cumple. |
single | JSON con "route": "<name>" | El borde de la ruta con ese route_name. |
multi | JSON con "route": ["a", "b"] | Cada arista de ruta nombrada en la lista. |
No es necesario describir el formato en su solicitud: cuando un nodo tiene rutas, el motor agrega ROUTING INSTRUCTIONS a la solicitud renderizada, listando cada ruta y su descripción. Escriba buenas descripciones de ruta; son la instrucción. Si ningún borde de ruta coincide (el modelo devolvió un nombre desconocido, o el borde coincidente ha usado todo su max_traversals), se activan los bordes de reserva. Se registra una cadena opcional route_reason con la decisión. Un borde de ruta y una ruta declarada deben coincidir: Studio Validate informa "Rutas no resueltas" para un borde cuya ruta no está declarada, y una ruta declarada sin borde es un error de lint (unwired_route). La única excepción es __verify_failed__, que no necesita declarar.
Estado compartido
Todos los nodos leen y escriben un objeto JSON, el estado compartido.
- Tus
initial_inputclaves lo inicializan (queryes la clave predeterminada). - Cuando un nodo finaliza, su salida se fusiona mediante la clave de nivel superior. Si el modelo devolvió un objeto JSON, cada clave se convierte en una clave de estado. De lo contrario, su texto se coloca bajo
text. Un nodo posterior que escriba la misma clave lo reemplaza. - Un mensaje lee cualquier tecla como
{{.key}}(Irtext/template). Si falta una tecla, se imprime<no value>; prueba con{{if .key}}...{{end}}cuando una tecla sea opcional. - La respuesta de la ejecución es el nodo de salida
text.
Dos consecuencias importan al diseñar: un nodo que devuelve solo JSON de enrutamiento (route, feedback) deja el text anterior en su lugar, y dos nodos que devuelven texto plano se sobrescriben mutuamente en el text. En la programación parallel, dos ramas que escriben la misma clave con valores diferentes hacen que la ejecución falle con parallel branch state conflict for key "text" from nodes [...]. Asigne a cada trabajador paralelo su propia clave JSON. El motor posee response_language, __verification_failure__, __attachments__ y __attachment_refs__, y deriva las banderas de adjunto has_attachments, has_image_attachments, has_dicom_attachments, has_signal_attachments y has_lab_documents de los archivos de la solicitud antes de que se ejecute el primer nodo; no las escriba, pero sí enrute en ellas en condiciones de borde (por ejemplo, state.has_dicom_attachments == true). Un archivo DICOM también cuenta como una imagen para has_image_attachments, pero un nodo LLM nunca recibe sus datos de píxeles (solo una nota de una línea con sus datos de encabezado), así que envíe DICOM directamente a un nodo determinista con capacidad DICOM, con ese borde asignado a un número priority menor que los bordes de la imagen para que gane.
Guardias
| Guardia | Significado |
|---|---|
max_total_steps | Obligatorio, mayor que 0. Límite máximo de activaciones de nodos en una ejecución. |
per_node_max_visits | Mapa que relaciona el ID del nodo con el número máximo de visitas. |
max_model_calls | Límite en las solicitudes de modelos, incluidos los reintentos, las rondas de herramientas y las llamadas al verificador. |
max_total_tokens, max_cost_usd | Límites de tokens y costos. El costo requiere un modelo de precios completo. |
max_retry_attempts | Reintentos después del primer intento durante la carrera. |
max_active_nodes | Ancho de distribución en cola. No debe exceder max_total_steps. |
max_tool_result_bytes | Archiva los resultados de herramientas extensas y muestra un resumen del modelo. Desactivado por defecto. |
untrusted_fence, repeat_advisory, wrap_up_turn | Protecciones opcionales, desactivadas por defecto. wrap_up_turn realiza una llamada adicional al modelo cuando un nodo utiliza todas sus rondas de herramientas. repeat_advisory advierte al modelo cuando repite una llamada idéntica a la herramienta. |
max_child_executions, max_recursion_depth | Límites para ejecuciones anidadas. |
Una ejecución que pasa per_node_max_visits falla con node "x" exceeded max_visits=N. Se permiten ciclos; estos protectores son los que los detienen. Studio Validate advierte: "Se recomienda protección contra bucles: el gráfico contiene un ciclo; el número máximo de pasos (N) lo limitará".
Redactar, publicar, ejecutar, reproducir
| Escenario | Lo que sucede |
|---|---|
| Borrador | Mutable. Guardar un borrador no lo valida. Aparecen errores al publicar o hacer clic en Validate. |
| Publicar | Ejecuta Validate() y la política invariante. Un error devuelve el estado 422 con el mensaje. La publicación también puede ser rechazada por una puerta de cumplimiento (409, "puerta de cumplimiento: ...") o, cuando se aplica la revisión de permisos, por una revisión que le pide que confirme que la versión amplía el alcance o las funciones del gráfico. Una versión publicada nunca cambia. |
| Nueva versión | Guardar una versión publicada crea un borrador. Elige una nueva versión semántica para él. |
| Correr | Se necesita una versión publicada. Usted elige la versión; la ejecución la registra. |
| Repetición | POST .../executions/{id}/replay con un step_id (y anulaciones de entrada o estado opcionales) crea una ejecución secundaria que comienza en ese paso con el estado guardado. rewind mueve la misma ejecución de vuelta a un paso anterior. Studio no tiene botón de reproducción para gráficos; use la API. Rerun step en el panel de depuración es la versión interactiva. |
¿Qué está fijado?
model_config_ref,prompt_refytool_refsllevanidyversion. Una versiónprompt_refpuede serlatest; el motor la resuelve una vez al inicio de la ejecución, almacena el resultado comoresolved_prompt_versionsy una repetición usa ese mapa tal cual.- Los valores
inline_promptyinline_model_configforman parte de la definición publicada, por lo que se mantienen fijos junto con ella. - Un nodo que solo contiene un
agent_idutiliza la configuración desplegada de ese agente. Los agentes tienen sus propias versiones (borrador, despliegue, congelado una vez desplegado). Las asignaciones de herramientas y habilidades en un agente no tienen versiones, y una entrada simple deskill_slugssigue a la habilidad activa. Useskill_refscon una versión para fijarla. - La repetición se ejecuta con el mismo límite de autonomía que la original.
Lo que garantiza la reproducción: la misma versión del gráfico, las mismas versiones de las indicaciones fijas y el mismo estado inicial. Lo que no garantiza: una salida idéntica. La salida del modelo puede variar entre ejecuciones y las herramientas pueden devolver datos nuevos.
Seguridad y gobernanza
Límite de autonomía
Cada ejecución tiene un límite que restringe lo que pueden hacer sus herramientas y operadores:
| Techo | Permite | Elegido cuando |
|---|---|---|
research_only | leer | compliance.research_only es verdadero. Tal ejecución no puede estar vinculada a una conversación o consulta. |
propose | leer y proponer | El gráfico es regulated, afecta la producción clínica o no tiene ningún bloque compliance (ningún bloque cuenta como clínico). |
autonomous | todo | Un bloque compliance que no está regulado ni es clínico. |
Una ejecución anidada adopta el límite más estricto entre el suyo propio y el de su padre. El límite propose solo se aplica cuando el servidor se ejecuta con HYDRA_AUTONOMY_ENFORCEMENT=enforce. Por defecto, se ejecuta en modo audit: las posibles denegaciones se registran y se permiten. El perfil piloto-clínico requiere enforce. Una denegación emite step.tool_denied Consulte con su administrador qué modo utiliza su entorno antes de confiar en el límite.
Clases de efectos secundarios
Los manejadores se clasifican por efecto: fhir.read y script.run leen; fhir.propose proponen; fhir.write y notify.send escriben. Con un límite propose, un grafo puede proponer un borrador o un recurso FHIR propuesto, pero no escribir uno final. Cada efecto secundario se coloca en su propio nodo después del nodo que toma la decisión, nunca en el mismo paso que el modelo. Los manejadores de propuesta y escritura se ejecutan una sola vez e ignoran los reintentos, por lo que una respuesta perdida no puede repetir un cambio.
Puertas de verificación
Establezca verification en un nodo del modelo para comprobar su salida antes de que alcance el estado compartido:
| Modo | Cheques |
|---|---|
judge | Un verificador evalúa al candidato en comparación con su rubric. |
grounded | Cada reclamación debe estar respaldada por las claves de estado compartido que se enumeran en grounding_state_keys (vacío significa todo el estado). |
consensus | Votan verifiers verificadores independientes (por defecto 3, como máximo 7). pass_threshold (por defecto 0,5) es la proporción que debe aprobarse. |
Otros campos: min_confidence, candidate_key (predeterminado text), verifier_model (usar un modelo diferente del nodo), categorize, expose_candidate_on_failure. Un veredicto fallido reintenta el nodo hasta retry_policy.max_attempts. Luego, el candidato se retiene: no se escribe ninguna de sus claves, el motor escribe un registro __verification_failure__ (nodo, intentos, modo, confianza, justificación, reclamaciones no respaldadas, un hash del candidato) y la ruta __verify_failed__ del nodo se dispara. El nodo debe tener un borde de ruta saliente llamado __verify_failed__ o la publicación falla. No se permite una puerta en un nodo determinista o de bucle humano. expose_candidate_on_failure solo se permite si cada __verify_failed__ objetivo es un nodo determinista o de bucle humano, por lo que ningún modelo puede refinar una respuesta rechazada en una final.
Pausa humana
human_in_the_loop estaciona la carrera (execution.paused, razón human_in_the_loop) hasta que llegue una carga útil (POST .../executions/{id}/human_input con node_id y payload, que es lo que hace Submit). Conozca los límites:
- La espera se mantiene en un proceso de servidor y no tiene límite de tiempo propio. Un reinicio del servidor puede provocar su pérdida.
- Con
HYDRA_GRAPH_DURABLE_RUNS=true(desactivado por defecto) y un nodo marcado conretry_safe, las ejecuciones se mantienen tras los reinicios por pausas de aprobación de herramientas y solicitudes de acceso. Consulte con su administrador si está activado. - Para revisiones que duren horas (colas de aprobación), guarde la revisión como registro en un servicio propio e inicie una segunda ejecución del gráfico cuando haya terminado.
Otros controles
fallback_models: hasta 3{id, version}referencias de modelo, probadas en orden cuando la llamada falla con límite de velocidad, tiempo de espera o 5xx, error de transporte, pago requerido o modelo no encontrado. Nunca en errores de autenticación o solicitudes incorrectas. Usted las elige; el motor de flujo de trabajo nunca cambia modelos silenciosamente. Cada salto se verifica con la política de salida de PHI. Registrado comostep.model_fallback. Solo nodos de modelo estándar.checks: reglas sobre las llamadas a herramientas de un nodo (deniega una llamada cuyos argumentos coincidan o requiere una llamada exitosa anterior).record_only: limita al redactor a herramientas de terminología, por lo que no puede leer FHIR en tiempo real.- Mandatory invariant block: Para las activaciones clínicas, el motor agrega un bloque
<mandatory_invariant_core>como la última sección de la solicitud de cada nodo del modelo. No puede escribir esa etiqueta en una solicitud (publish devuelve 422 con el mensajeprompt contains the reserved <mandatory_invariant_core> tag).invariant_exemptionrequiere una razón de al menos 20 caracteres y una referencia, y se rechaza bajo el perfil piloto-clínico. No intente reproducir ni debilitar el bloque en su propia solicitud. - Prompt-injection defence: activado por defecto. La entrada se trata como datos; la entrada sospechosa emite
step.prompt_injection. - Spend:
max_model_calls,max_total_tokensymax_cost_usddetienen una carrera que cuesta más de lo previsto.
Lista de verificación clínica antes de publicar
compliancerellenado honestamente; sin bloqueo significa clínico.intended_useestados indican quién utiliza el resultado y que un médico lo revisa.- Cada resultado relevante de un modelo tiene una puerta de control, una verificación determinista, un revisor o una persona.
- Cada bucle tiene
max_traversals,per_node_max_visitsymax_total_steps. - Los efectos secundarios se encuentran en sus propios nodos deterministas.
- Lo ejecutaste con datos sintéticos, en modo de depuración, y leíste cada Resolved prompt.
Leyendo una carrera
Cada ejecución produce un registro de eventos ordenado. Abra Events (n) en el panel inferior o léalo a través de GET .../executions/{id}/events y el flujo .../stream.
| Evento | Significado |
|---|---|
graph.execution.started, execution.completed | Correr límites. |
step.started, step.completed, step.failed, step.retried | Activación de un nodo. Un reintento significa que el primer intento falló o que su resultado estaba vacío o no era utilizable. |
step.tool_called, step.tool_returned | Una llamada a una herramienta y su resultado. |
execution.paused, execution.resumed, execution.cancelled | Pausa humana, reanudación, cancelación. |
execution.paused_at_breakpoint | Se activó un punto de interrupción de depuración. |
step.verified | Un veredicto de verificación. |
step.tool_denied, step.check_denied, step.approval_required | Un control de gobernanza detuvo la llamada a una herramienta. |
step.model_fallback | Se utilizó un modelo de reserva. |
step.unresolved_vars | Un mensaje hacía referencia a una clave que faltaba. Imprimió <no value>. |
step.rounds_exhausted, step.repeat_advisory, execution.budget_exhausted | Un bucle o límite de gasto. |
step.invariant_core, step.phi_egress, step.prompt_injection | Los controles de seguridad registraron su decisión. |
execution.replayed, execution.rewound | Se ha iniciado una reproducción o rebobinado. |
El estado de ejecución pasa por pending, running, paused, luego succeeded, failed o cancelled.
When an answer is wrong, trabajar hacia atrás:
- Encuentra el primer paso que falló o que produjo un valor incorrecto. Step Inspector muestra Input y Output.
- Lee su Resolved prompt. ¿Están todos
{{.key}}llenos? ¿Hay un<no value>ahí? - Lectura Output. ¿Un enrutador devolvió un nombre de ruta que usted no declaró?
- Lectura Tool calls. ¿La llamada devolvió un error o un resultado vacío?
- Abra Trace para costos, reintentos y ejecuciones anidadas.
- Corrige la solicitud en una nueva versión, publícala y ejecuta la misma entrada de nuevo. Compara las ejecuciones en History.
Prueba antes de publicar
- Validate, luego corrija todos los errores. Lea las advertencias.
- Ejecutar con Debug step-by-step. Establecer
after_prompt_renderpunto de interrupción para leer cada solicitud, usar Override route para forzar una bifurcación y Mock tool call para evitar herramientas reales. - Pruebe cada arista, no solo la ruta principal: fuerce cada ruta, fuerce un bucle de revisión hasta su límite, devuelva un resultado de herramienta vacío.
- Guarda tus datos de prueba como Example presets para que cada versión se ejecute con los mismos casos.
Límites
- Las etiquetas de Graph Agent Studio son texto fijo en inglés en el código fuente; no están traducidas.
- No hay ningún botón de Studio para reproducir o rebobinar; utilice la API o Rerun step en modo depuración.
- No existe un nodo de recuperación (RAG) dedicado. Utilice habilidades, configuración de memoria, nodos RLM o ParSer para documentos largos, o un controlador que obtenga datos en un estado compartido.
- La aplicación en tiempo de ejecución de
max_child_executionsymax_recursion_depthse describe en el código fuente como no activa en una sección de política; no confíe en ellas para detener ejecuciones anidadas. - La pausa humana está en proceso (seguridad y gobernanza).
- El límite de autonomía es consultivo (modo auditoría) a menos que su servidor se ejecute con
HYDRA_AUTONOMY_ENFORCEMENT=enforce.
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..