Claude Managed Agents permite ejecutar un agente en un entorno administrado y conectarlo a una aplicación. En el video del 10 de abril de 2026 lo llevé a un caso concreto: recibir una transcripción, identificar lo que necesita un cliente y preparar un documento de propuesta.
La parte interesante es el recorrido completo. Primero configuré el agente en Claude Console. Después construí con Claude Code una interfaz para pegar texto y descargar el resultado. Hubo errores en la integración y en la descarga del PDF; resolverlos fue parte de la demo. Puedes ver todo el proceso en YouTube.
Qué resuelve este sistema
Después de una reunión comercial, la información suele quedar repartida entre notas y conversaciones: qué problema existe, qué espera el cliente, qué restricciones tiene y qué falta por aclarar. Convertir eso en una propuesta exige ordenar el material antes de escribir bonito.
El agente puede preparar un primer documento que separe requisitos, alcance, supuestos y estimaciones. Su utilidad está en reducir ese trabajo inicial y dejar una base que puedas contrastar con la reunión. El precio, los compromisos y la aceptación comercial siguen necesitando una decisión de quien presta el servicio.
En la grabación usé distintas entradas de prueba. Una describía una aplicación de reparto; el PDF mostrado al final corresponde a un proyecto de onboarding. Son ejemplos del mismo mecanismo, no dos etapas de una única cotización.
Agente, entorno y sesión: tres piezas distintas
La documentación de Managed Agents distingue la configuración del agente, el entorno donde trabaja y las sesiones de ejecución. Esa separación permite reutilizar un comportamiento sin mezclar el trabajo de cada solicitud.
| Pieza | Qué decide en este caso | Ejemplo de una decisión concreta |
|---|---|---|
| Agente | Cómo interpreta y prepara la propuesta | Separar lo confirmado de las preguntas pendientes |
| Entorno | Con qué archivos y herramientas puede trabajar | Tener disponible la herramienta que genera el documento |
| Sesión | Qué solicitud está resolviendo | Una transcripción y su propuesta asociada |
Configurar una buena instrucción no basta si falta la herramienta para producir el archivo. Tampoco sirve un entorno completo si el agente entiende “propuesta” como un resumen de la llamada sin alcance ni entregables.
Si estos conceptos son nuevos para ti, la guía de contexto, memoria y herramientas explica las piezas de un agente con ejemplos más básicos.
Primero define qué debe contener la propuesta
Antes de conectar la interfaz, escribiría los criterios de salida. Una propuesta útil debería dejar claro qué se construirá, para quién, qué recibirá el cliente y qué elementos todavía no están acordados. Una frase ambigua de la reunión no debería convertirse en un compromiso firme por el solo hecho de aparecer en el PDF.
Este es un ejemplo editorial de instrucción para adaptar, no una transcripción literal del prompt del video:
Recibe la transcripción de una reunión y prepara un borrador de propuesta.
Separa requisitos confirmados, supuestos y preguntas pendientes.
Para cada entregable indica qué incluye y cómo se comprobará.
No inventes acuerdos, tarifas, plazos ni resultados del cliente.
Si falta información para estimar, explica qué dato necesitas.
Devuelve un documento descargable y un resumen de decisiones pendientes.
Para probarlo, introduciría una contradicción deliberada: que al principio se pida una aplicación móvil y al final se diga que el primer entregable será una web. El resultado debe señalar la ambigüedad. Si la oculta, el flujo necesita ajustes aunque la presentación sea atractiva.
Prueba el agente antes de construir el formulario
En el video configuré el agente desde Quickstart y después preparé una sesión de prueba. La consola permite seguir los eventos y las acciones de herramientas. Esto ayuda a distinguir si la tarea sigue trabajando, terminó o se detuvo en algún paso.
La prueba inicial debería responder preguntas muy concretas: ¿leyó toda la entrada?, ¿distinguió requisitos de comentarios?, ¿produjo un archivo que se puede abrir?, ¿el archivo corresponde a esa solicitud? Si una de esas respuestas es negativa, agregar una interfaz solo vuelve menos visible el problema.
La guía de sesiones explica cómo iniciar el trabajo mediante eventos y seguir su estado. Crear la sesión y recibir un identificador no significa que el documento ya esté terminado.
Conecta la interfaz y espera el resultado correcto
La interfaz de la demo tenía una función sencilla: recibir la transcripción y ofrecer la descarga. Claude Code preparó esa capa. El servicio de la aplicación debía comunicarse con Managed Agents y conservar la relación entre la solicitud enviada y el archivo obtenido.
El recorrido recomendable es enviar la transcripción, registrar la sesión, mostrar que está procesando y habilitar la descarga cuando exista un resultado válido. Si hay un error, la pantalla debe explicarlo y permitir volver a intentar sin generar documentos duplicados por cada clic.
Los identificadores de agente y entorno sirven para apuntar a la configuración. No sustituyen la autenticación. La clave de API debe permanecer en el servidor o en un almacén de secretos, fuera del JavaScript que recibe el navegador. Para una herramienta interna también conviene definir quién puede iniciar solicitudes y cuánto trabajo puede consumir.
Lo que enseñó el error del PDF
En la grabación la primera integración no quedó lista de inmediato. Aparecieron problemas y pedí correcciones. La descarga también necesitó un ajuste antes de abrirse correctamente. Esa parte es valiosa porque muestra un criterio de cierre: el trabajo termina cuando puedes usar el entregable, no cuando el agente escribe “listo”.
Revisaría tanto el contenido como el archivo: que abra en otro lector, que no corte tablas, que las cifras coincidan y que no haya texto de conversación mezclado con el documento final. El ejemplo demuestra el circuito de generación; todavía deja espacio para mejorar la estructura y la presentación de la propuesta.
Cuándo usarlo y cuándo mantener un workflow
Este enfoque encaja cuando cada entrada exige interpretar información y producir un entregable distinto. Si el proceso tiene pasos fijos y reglas claras, puedes conservar esa parte en un workflow y dejar al agente la extracción o redacción.
En la guía de Claude Code y n8n para documentos aparece esa otra forma de organizar el trabajo. El criterio es decidir dónde necesitas flexibilidad y dónde necesitas una secuencia estable. Una llamada HTTP a un agente puede ser una pieza del proceso, pero también necesita manejo de errores y comprobación del resultado.
Video completo y siguientes pasos
Abre la demostración completa en YouTube para seguir la configuración, los problemas y el PDF final. Si vas a repetir el caso, empieza con una transcripción de prueba y una única clase de propuesta.
En Imperio Agéntico compartimos recursos y trabajamos estos sistemas con casos de implementación. También puedes suscribirte a mi canal para continuar con las demostraciones.
Preguntas frecuentes
¿Qué hace Claude Managed Agents en este ejemplo?
Recibe una transcripción y prepara un borrador de propuesta usando un agente configurado en la nube. La demo también muestra una interfaz creada con Claude Code para solicitar y descargar el resultado.
¿Qué diferencia hay entre agente, entorno y sesión?
El agente define el comportamiento, el entorno aporta las herramientas y archivos disponibles, y la sesión contiene una ejecución concreta. Puedes reutilizar la configuración para distintas solicitudes sin confundir sus resultados.
¿La propuesta generada está lista para enviarse a un cliente?
Necesita revisión. Hay que comprobar requisitos, supuestos, entregables, estimaciones y formato. El video demuestra el recorrido técnico de generación, no la validación comercial de una cotización.
¿Basta con tener los identificadores del agente y el entorno?
No. Esos identificadores apuntan a la configuración, pero la aplicación sigue necesitando autenticación válida para hacer las llamadas. La credencial debe permanecer fuera del código que recibe el navegador.
¿Cómo sé que el PDF está realmente terminado?
Comprueba el estado de la ejecución, la existencia del archivo y su apertura en un lector. Revisa además que corresponda a la solicitud y que no incluya texto de conversación mezclado con el documento final.