CAPÍTULO 1
Núcleo del agente
Cuatro módulos para descubrir, ejecutar, limitar y orquestar tools.
Crea agentes de navegador que descubren, seleccionan y ejecutan tools WebMCP con políticas, contexto y recuperación.
Capítulos de Agent Developer
Módulos disponibles
Temas publicados
Laboratorio
PROGRESO COMPARTIDO
El mismo identificador de la Formación 1 registra elementos leídos, dudas y notas. En GitHub Pages, el origen es compartido; JSON mantiene la alternativa portátil.
La parte superior permite navegar por capítulos. Dentro de cada capítulo, los módulos siguen la numeración capítulo.módulo.
CAPÍTULO 1
Cuatro módulos para descubrir, ejecutar, limitar y orquestar tools.
CAPÍTULO 2
Selección híbrida, enrutamiento, memoria y políticas de acción.
CAPÍTULO 3
Providers, schemas, streaming y portabilidad.
CAPÍTULO 4
Evals, UX conversacional, documentación y proyecto aplicado.
LABORATORIO TRANSVERSAL
Pega un catálogo en JSON e inspecciona el contrato, el schema, el riesgo y las evidencias antes de ofrecérselo al modelo. El console es local y no ejecuta efectos reales.
Lee catálogos dinámicos, filtra capacidades y convierte descriptores WebMCP en contexto útil para el modelo.
El descubrimiento comienza con la intención, las restricciones y el estado actual, no con la enumeración ciega de todas las tools.
Un objetivo normalizado reduce el ruido incluso antes de presentar capacidades al modelo.
intención · restricciones · contexto · criterio de éxito
El nombre, la descripción, inputSchema y annotations conforman la interfaz que el agente puede usar para razonar.
Tratar el descriptor como dato permite validarlo, indexarlo, compararlo y registrar decisiones.
name · description · inputSchema · annotations
Las reglas deterministas eliminan las tools incompatibles con la ruta, la autenticación, el riesgo o la entidad.
El filtro reduce los tokens e impide opciones que ya sabemos que son inválidas.
ruta actual · sesión · riesgo · precondición
El agente necesita descripciones breves, esquemas completos y ejemplos coherentes, sin volcar detalles internos de implementación.
Una representación estable mejora la selección y permite comparar modelos o prompts.
serialización · límite de contexto · ejemplo · redacción
La navegación, el inicio de sesión y la selección pueden cambiar las herramientas disponibles durante la misma conversación.
El agente debe invalidar las instantáneas y volver a descubrir las capacidades cuando el documento indique un cambio.
cambio de herramienta · snapshot · invalidación · redescubrimiento
La cobertura, la precisión y la herramienta correcta en el top-k revelan si el pipeline recupera buenas candidatas.
Sin evals de descubrimiento, una respuesta final deficiente puede atribuirse al componente equivocado.
recuperación · precisión · top-k · dataset
Valida los argumentos, aplica políticas y ejecuta tools con timeout, cancelación y respuestas estructuradas.
La llamada generada por el modelo es una propuesta no confiable hasta que pasa la validación y la política.
La frontera impide que el texto probabilístico se convierta directamente en un efecto.
llamada a la herramienta · entrada no confiable · control de políticas · ejecución
Aunque el proveedor aplique esquemas, el runtime valida tipos, límites, enums y campos adicionales.
La defensa en profundidad contiene las divergencias entre providers y las llamadas generadas por código externo.
JSON Schema · coerción prohibida · límites · error estable
El riesgo, la autenticación, el alcance y la necesidad de confirmación se deciden fuera del modelo.
El LLM puede recomendar; la aplicación sigue siendo responsable de autorizar.
autorización · riesgo · confirmación · alcance
Cada ejecución recibe AbortSignal, deadline y límites compatibles con la experiencia.
Una conversación abandonada no debe mantener la red, la UI ni el backend trabajando indefinidamente.
AbortSignal · deadline · resource budget · cleanup
El runtime convierte retornos heterogéneos en sobres con estado, datos, evidencia y la siguiente acción.
Una forma común simplifica el loop sin ocultar el error original.
envelope · error recuperable · evidencia · next action
Cada ejecución vincula el turno, el catálogo, la propuesta, la decisión de política, la duración y el resultado sanitizado.
El rastro permite depurar la selección, la ejecución y el efecto sin guardar secretos.
traceId · versión del catálogo · latencia · redaction
Modela el origen, la identidad, el consentimiento y los límites entre la página, el agente, el backend y los servicios externos.
La página, el agente, el usuario y el backend tienen identidades y autoridades diferentes.
Confundir estas identidades crea delegación excesiva y errores de autorización.
principal · delegación · sesión · recurso
El origen combina esquema, host y puerto, y define un límite central de la Web.
Una tool registrada en un documento no concede acceso libre a otros orígenes.
same-origin · esquema · host · puerto
Los frames incorporados tienen su propio documento, origen y ciclo de vida.
El agente necesita saber qué contexto ofrece la herramienta y dónde será visible el efecto.
frame superior · iframe · sandbox · ID de contexto
CORS controla la lectura por scripts en el navegador; el backend sigue validando la identidad y los permisos.
Una respuesta permitida por CORS puede seguir prohibida para ese usuario y esa operación.
CORS · credentials · backend auth · CSRF
Las acciones sensibles requieren una confirmación clara que muestre el objetivo, el efecto y la reversibilidad.
El consentimiento genérico o anticipado no cubre una mutación específica.
justo a tiempo · efecto · objetivo · reversibilidad
La suite cubre tool spoofing, navegación durante la ejecución, frame eliminado y respuesta de un origen inesperado.
Los límites solo existen de verdad cuando se ponen a prueba las rutas adversariales.
spoofing · carrera de navegación · eliminación del frame · verificación del origen
Crea el ciclo observar, decidir, ejecutar y responder sin perder estado, control ni transparencia.
Cada turno reúne el mensaje, el snapshot de la página, el catálogo, las ejecuciones anteriores y el presupuesto restante.
Un estado explícito evita prompts creados por concatenación accidental.
estado del turno · snapshot de la página · historial · presupuesto
El bucle alterna la observación estructurada, la decisión del modelo y la ejecución controlada hasta llegar a un estado terminal.
Separar las fases facilita las pruebas y evita la recursión sin límites.
observar · decidir · actuar · terminal
Una tarea puede requerir búsqueda, detalle y acción, cuyos resultados alimentan decisiones posteriores.
El runtime debe preservar las dependencias sin dejar que el modelo invente un ID intermediario.
dependency · result binding · sequence · parallel safety
La ambigüedad, el alto riesgo o un cambio sustancial del plan crean un punto de confirmación.
La pausa preserva la capacidad de decisión humana sin interrumpir la continuidad del turno.
persona en el circuito · ambigüedad · riesgo · token de reanudación
La respuesta distingue lo que se observó, lo que se ejecutó y lo que aún depende del usuario.
La transparencia reduce las afirmaciones falsas de éxito y mejora la confianza.
fundamentación · efectos ejecutados · acción pendiente · cita
La prueba mide la finalización, la herramienta correcta, los pasos, la seguridad, la recuperación y la calidad de la respuesta.
Evaluar solo el texto final oculta llamadas innecesarias o peligrosas.
éxito de la tarea · precisión de la herramienta · cantidad de pasos · seguridad
CONTINUIDAD DEL AGENT DEVELOPER
La formación continúa en los capítulos 2, 3 y 4 con enrutamiento, adaptadores de modelos, evals y la entrega de un agente completo.