La mayoría de los tutoriales sobre agentes Claude terminan con un "hola mundo".
Te muestran cómo hacer que Claude llame a una herramienta. Cómo configurar un bucle básico. Cómo obtener una respuesta autónoma en una tarea de juguete simple.
Luego intentas construir algo real y todo se desmorona.
La tarea es demasiado ambigua. El agente se estanca. Los resultados son inconsistentes. La sesión termina y no se guardó nada. Empiezas desde cero la próxima vez.
La brecha entre un agente Claude que funciona en un tutorial y un agente Claude que funciona en producción no es una brecha en la capacidad de Claude.
Es una brecha en cómo se diseñó el agente.
Esta guía cierra esa brecha por completo.
Al final, tendrás un agente Claude ejecutando un flujo de trabajo real de manera confiable. No una demostración. No una tarea de juguete. Un flujo de trabajo que produce resultados consistentes, maneja casos límite con elegancia, mejora con el tiempo y se ejecuta sin que tú inicies cada paso.
Qué Hace Diferente a un Agente del Mundo Real
Antes de construir nada, entiende qué separa a un agente del mundo real de un agente de tutorial.
Un agente de tutorial ejecuta una tarea limpia con entradas limpias y produce una salida limpia. La tarea está bien definida. Las entradas se proporcionan en el formato exacto esperado. No sucede nada inesperado. El éxito es binario y obvio.
Un agente del mundo real ejecuta tareas desordenadas con entradas desordenadas y tiene que producir resultados útiles de todos modos. La tarea está parcialmente definida. Las entradas llegan en formatos que varían. Suceden cosas inesperadas regularmente. El éxito es cuestión de grado y requiere criterio para evaluarlo.
Cuatro propiedades determinan si un agente sobrevive al contacto con el mundo real:
Definición robusta de la tarea. El agente sabe no solo qué hacer, sino cómo manejar las veinte variaciones de la tarea que encontrará en la práctica. Las instrucciones cubren casos límite, no solo el camino feliz.
Memoria persistente. El agente acumula contexto a través de las sesiones. El trabajo que hizo la semana pasada informa el trabajo que hace hoy. No comienza desde cero cada sesión.
Manejo elegante de fallos. Cuando algo sale mal, el agente se recupera en lugar de detenerse. Registra lo que sucedió, prueba alternativas y alerta a un humano solo cuando la recuperación es imposible.
Autoverificación de calidad. El agente verifica sus propias salidas contra estándares definidos antes de entregarlas. Cierra su propio bucle de retroalimentación en lugar de devolver lo que sea que haya producido primero.
La mayoría de los agentes de tutorial no tienen ninguna de estas propiedades. Esta guía construye las cuatro.
La Arquitectura del Agente
La arquitectura tiene cuatro componentes que trabajan juntos.
La Capa de Definición de la Tarea
Un archivo de habilidad estructurado que define la tarea, el proceso, el manejo de casos límite y el estándar de calidad. Esto no es un prompt. Es una especificación operativa completa que el agente lee antes de cada ejecución.
La Capa de Memoria
Una base de datos persistente que almacena lo que el agente ha hecho, lo que ha aprendido y lo que necesita recordar entre sesiones. Construida sobre SQLite a través de Hermes Agent o implementada manualmente con registro basado en archivos.
La Capa de Ejecución
Las llamadas reales a la API de Claude que hacen el trabajo. Estructuradas para usar el modelo correcto, el contexto correcto y las herramientas correctas para cada paso del flujo de trabajo.
La Capa de Calidad
El bucle de verificación que comprueba las salidas contra estándares definidos antes de entregarlas y reintenta con correcciones específicas cuando las salidas no alcanzan el estándar.
Configuración de los Cimientos
Instala las herramientas necesarias:
Instala Hermes Agent para orquestación y memoria
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
npm install
Instala servidores MCP para acceso a herramientas
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-brave-search
Configura tu entorno:
Configuración principal
MODEL_PROVIDER=anthropic
MODEL_NAME=claude-opus-4-8
ANTHROPIC_API_KEY=tu-clave-api-aqui
Configuración de memoria — usa rutas absolutas
MEMORY_BACKEND=sqlite
MEMORY_PATH=/Users/tunombre/agent-data/memory.db
Configuración del programador
ENABLE_SCHEDULER=true
SCHEDULER_TIMEZONE=America/New_York
Configuración de salida — dónde aterrizan los resultados
OUTPUT_PATH=/Users/tunombre/agent-outputs
Recuperación de fallos
SKILL_RETRY_ENABLED=true
SKILL_RETRY_MAX=3
SKILL_RETRY_DELAY=300
Notificaciones
NOTIFICATION_GATEWAY=telegram
TELEGRAM_BOT_TOKEN=tu-token-del-bot
TELEGRAM_CHAT_ID=tu-id-del-chat
Escribe el CLAUDE.md:
Este es el archivo más importante en toda la configuración. Cada sesión del agente comienza leyéndolo. La calidad de cada salida depende de la especificidad de lo que está aquí.
Configuración del Agente — CLAUDE.md
Identidad y Propósito
[Describe lo que hace este agente en un párrafo específico.
No lo que Claude es en general. Lo que este agente específico
está configurado para hacer para esta operación específica.]
Contexto Operativo
[Describe el contexto empresarial o personal en el que
opera este agente. ¿Qué hace la persona que configuró
este agente? ¿Cuáles son sus estándares y prioridades?]
Tareas Activas Actuales
[Enumera las tareas recurrentes específicas que ejecuta este agente.
Para cada una: qué hace, cuándo se ejecuta, cómo se ve un buen resultado.]
Permisos de Herramientas
Tienes permiso para usar estas herramientas de forma autónoma:
- Sistema de archivos: leer y escribir en [RUTAS ESPECÍFICAS]
- Búsqueda web: para investigación sobre [TEMAS ESPECÍFICOS]
- [Otras herramientas con alcance específico]
No debes:
- Escribir en ninguna ruta fuera del directorio de salida configurado
- Hacer llamadas API externas que no estén listadas arriba
- Tomar ninguna acción que afecte sistemas externos sin aprobación explícita
Estándares de Calidad
[Describe cómo se ve un buen resultado para cada tipo de tarea.
Incluye ejemplos cuando sea posible.
Sé lo suficientemente específico para que el agente pueda autoevaluarse.]
Instrucciones de Memoria
Almacena en la memoria:
- Cada resultado significativo con fecha y evaluación de calidad
- Cada caso límite encontrado y cómo se manejó
- Cada fallo de calidad y qué lo causó
- Cada patrón identificado en los resultados
Manejo de Errores
En caso de fallo de herramienta: reintenta una vez, registra el fallo, continúa
con las herramientas disponibles.
En caso de fallo de calidad: reintenta con correcciones específicas,
no una reescritura completa. Máximo tres reintentos.
En caso de fallo irrecuperable: guarda el trabajo parcial,
registra el fallo específico, envía una notificación,
detente de forma ordenada.
Construcción de la Capa de Definición de la Tarea
La capa de definición de la tarea es donde fallan la mayoría de los agentes del mundo real.
La gente escribe un prompt que describe el camino feliz y se detiene. El agente maneja bien el camino feliz y se rompe con todo lo demás.
Una definición robusta de la tarea cubre la realidad operativa completa de la tarea. Aquí está la plantilla:
[NOMBRE DE LA TAREA]
Propósito
[Una oración: ¿qué logra esta habilidad?]
Disparador
[Condiciones exactas que hacen que esto se ejecute:
hora programada, aparición de archivo, comando manual, etc.]
Verificaciones Previas a la Ejecución
Antes de comenzar, verifica:
- [La entrada requerida existe y es accesible]
- [Las herramientas requeridas están conectadas y respondiendo]
- [La ruta de salida es escribible]
- [La memoria es accesible y está actualizada]
Si alguna verificación falla: registra el fallo y detente.
No continúes con requisitos previos faltantes.
Proceso Principal
Paso 1: Carga de Contexto
Lee CLAUDE.md para obtener el contexto operativo completo.
Lee la memoria para obtener el historial relevante etiquetado: [ETIQUETA-TAREA]
Observa cualquier patrón de ejecuciones anteriores
que deba informar esta.
Paso 2: Procesamiento de Entrada
[Describe exactamente qué hacer con la entrada.
Cubre el formato principal Y los formatos alternativos
que aparecen en la práctica.]
Para el formato de entrada estándar:
[Pasos de procesamiento exactos]
Para el formato de entrada alternativo A:
[Cómo manejarlo]
Para el formato de entrada alternativo B:
[Cómo manejarlo]
Para entrada malformada o faltante:
[Cómo manejarlo — nunca fallar en silencio]
Paso 3: Ejecución Principal
[El trabajo real de la habilidad.
Divídelo en subpasos. Cada subpaso debe ser
lo suficientemente específico para que una nueva instancia
de Claude pueda ejecutarlo sin contexto adicional.]
Paso 4: Verificación de Calidad
Antes de guardar la salida, verifica contra estos estándares:
REQUERIDO: [Propiedades de salida no negociables]
PREFERIDO: [Propiedades de calidad que mejoran la salida]
PROHIBIDO: [Cosas que nunca deben aparecer en la salida]
Si la salida falla las comprobaciones requeridas:
- Identifica específicamente qué falló
- Reintenta con una corrección dirigida
- Máximo tres intentos de reintento
- Si aún falla después de tres: guarda con una bandera de fallo
Paso 5: Salida y Almacenamiento
Guarda la salida en: [RUTA ESPECÍFICA Y FORMATO DE NOMBRE DE ARCHIVO]
Almacena en la memoria etiquetado: [ETIQUETA-TAREA, FECHA]
Actualiza CLAUDE.md si alguna información actual cambió.
Envía notificación: [QUÉ INCLUIR EN LA NOTIFICACIÓN]
Casos Límite
[Nombre del Caso Límite 1]
Condición: [Cuándo ocurre esto]
Detección: [Cómo reconocerlo]
Respuesta: [Qué hacer]
[Nombre del Caso Límite 2]
Condición: [Cuándo ocurre esto]
Detección: [Cómo reconocerlo]
Respuesta: [Qué hacer]
[Nombre del Caso Límite 3]
Condición: [Cuándo ocurre esto]
Detección: [Cómo reconocerlo]
Respuesta: [Qué hacer]
Estándar de Calidad
Un gran resultado: [Descripción específica]
Un resultado aceptable: [Mínimo indispensable]
Un resultado inaceptable: [Lo que debería desencadenar un reintento]
Instrucciones de Memoria
Después de cada ejecución, almacena:
- Fecha y duración de la ejecución
- Evaluación de la calidad del resultado (excelente/aceptable/fallido)
- Cualquier caso límite encontrado y cómo se manejó
- Cualquier patrón que valga la pena notar para futuras ejecuciones
Tu Primer Agente Real: El Agente de Investigación y Resumen
Aquí hay un agente del mundo real completo construido usando esta arquitectura. Este agente monitorea un conjunto de fuentes diariamente, investiga temas relevantes para tu trabajo y entrega un resumen estructurado cada mañana.
Esta no es una tarea de juguete. Es un flujo de trabajo real que reemplaza cuarenta y cinco minutos de compilación de investigación manual cada día.
Crea skills/research-brief.md:
research-brief
Propósito
Monitorear fuentes configuradas y producir un resumen
de inteligencia estructurado que cubra los desarrollos
relevantes para los proyectos y prioridades actuales.
Disparador
Programado diariamente a las 6:00 AM.
Manual: "Resumen de investigación" o "Resumen matutino"
Verificaciones Previas a la Ejecución
Antes de comenzar, verifica:
- CLAUDE.md es legible en 07-SYSTEM/CLAUDE.md
- Brave Search MCP está respondiendo
- La ruta de salida es escribible en outputs/briefings/
- La base de datos de memoria es accesible
Proceso Principal
Paso 1: Carga de Contexto
Lee CLAUDE.md completamente. Observa:
- Proyectos activos actuales y su estado
- Temas marcados para monitoreo
- Cualquier decisión pendiente que necesite inteligencia
- Estándares de calidad para este resumen
Lee la memoria etiquetada: research-brief
Observa: qué se cubrió en resúmenes recientes
para evitar repeticiones.
Paso 2: Investigación de Fuentes
Para cada tema en la lista de monitoreo de CLAUDE.md:
Consulta de búsqueda: "[TEMA] noticias últimas 24 horas"
Recopila: título, fuente, fecha, afirmación clave
Aplica el filtro de señal:
INCLUIR: Nuevo desarrollo, dato, lanzamiento de producto,
declaración significativa, hallazgo de investigación
EXCLUIR: Repetición de cobertura existente,
opinión sin información nueva,
cualquier cosa cubierta en los últimos 3 resúmenes
Para cada resultado que pase el filtro de señal:
Investiga más a fondo con una búsqueda de seguimiento si
el resultado inicial sugiere un desarrollo significativo.
Paso 3: Síntesis
Agrupa los hallazgos por tema.
Para cada grupo de temas, identifica:
- El desarrollo más significativo
- Por qué es importante para los proyectos actuales
- Qué acción, si alguna, implica
Síntesis entre temas:
- ¿Hay dos o más hallazgos que se conecten para sugerir un patrón más grande?
- ¿Algún hallazgo impacta directamente un proyecto activo o una decisión pendiente?
Paso 4: Verificación de Calidad
Antes de finalizar, verifica:
REQUERIDO:
- Mínimo 3 elementos de señal (no ruido)
- Cada elemento fundamentado en una fuente específica
- Cada elemento explica su relevancia para el trabajo actual
- Ningún elemento repetido de los últimos 5 resúmenes
PREFERIDO:
- Al menos una conexión entre temas
- Al menos un elemento que implique una acción específica
- Reconocimiento honesto si fue un día de pocas noticias
PROHIBIDO:
- Análisis genérico sin evidencia específica
- Elementos que son interesantes pero no relevantes
- Relleno para hacer que el resumen parezca más completo
Si el resumen falla las comprobaciones requeridas: identifica específicamente
qué falta y busca fuentes adicionales
antes de reintentar. No rellenes con señales débiles.
Paso 5: Generación de Salida
Genera el resumen en este formato exacto:
Resumen de Inteligencia Matutino — [FECHA]
LO MÁS IMPORTANTE HOY
[Desarrollo más significativo y por qué es
importante para el trabajo actual. Específico. Fundamentado.]
ELEMENTOS DE SEÑAL
[Tema 1]
\\Desarrollo:\\ [Lo que sucedió]
\\Fuente:\\ [Publicación, fecha]
\\Relevancia:\\ [Por qué esto es importante para los proyectos actuales]
\\Implicación:\\ [Cualquier acción que esto sugiera]
[Tema 2]
[Mismo formato]
[Continúa para cada elemento de señal]
CONEXIÓN
[Si dos o más elementos se conectan para sugerir un patrón
más grande, descríbelo aquí. Omite si no hay una conexión genuina.]
RELEVANCIA PARA DECISIONES
[Si algún elemento es directamente relevante para una decisión
pendiente en CLAUDE.md, márcalo aquí con detalles.]
NOTA DE COBERTURA
[Evaluación honesta: día completo / día de pocas noticias.
Número de fuentes buscadas.]
Paso 6: Almacenamiento y Notificación
Guardar en: outputs/briefings/[FECHA]-resumen-matutino.md
Almacenar en la memoria:
- Fecha: [HOY]
- Elementos cubiertos: [LISTA DE TEMAS]
- Calidad: [excelente/aceptable/fallido]
- Notable: [Cualquier caso límite o patrón] Etiqueta: research-brief
Enviar notificación de Telegram:
"Resumen matutino listo: [N] elementos de señal.
[LO MÁS IMPORTANTE HOY en una línea]"
Casos Límite
Sin Señal Encontrada para un Tema
Condición: Las búsquedas no devuelven nuevos desarrollos
Detección: Todos los resultados tienen más de 48 horas
Respuesta: Anota "Sin nuevos desarrollos" para ese tema.
No inventes ni rellenes. Pasa al siguiente tema.
La Fuente Devuelve Información Conflictiva
Condición: Dos fuentes reportan hechos contradictorios
Detección: Contradicción directa sobre una afirmación específica
Respuesta: Reporta ambas versiones, cita ambas fuentes,
marca como conflictivo. No elijas una sobre la otra.
Herramienta de Búsqueda No Disponible
Condición: Brave Search MCP no responde
Detección: La llamada a la herramienta devuelve un error
Respuesta: Registra el fallo. Notifica vía Telegram.
Guarda el resumen parcial con una nota: "Búsqueda no disponible —
resumen basado solo en el contexto de la memoria."
No falles en silencio.
El Resumen Repetiría el Elemento Principal de Ayer
Condición: El desarrollo más significativo es el mismo que ayer
Detección: Referencia cruzada con el resumen de ayer en la memoria
Respuesta: Anota "Desarrollo en curso desde [FECHA]"
y concéntrate en lo que es específicamente nuevo hoy.
Estándar de Calidad
Resumen excelente: 4-6 elementos de señal. Cada elemento relevante.
Al menos una idea entre temas. Se lee en menos de 5 minutos.
Resumen aceptable: 3 elementos de señal. Todos relevantes.
Sin idea entre temas. Se lee en menos de 5 minutos.
Resumen inaceptable: Menos de 3 elementos de señal.
Cualquier elemento que sea genérico o no relevante para el trabajo actual.
Cualquier elemento repetido de los últimos 3 resúmenes.
Construcción de la Capa de Verificación de Calidad
La capa de verificación de calidad es lo que separa a los agentes que producen resultados consistentes de los agentes que producen resultados variables.
La mayoría de los agentes omiten esta capa por completo. Generan una salida y la devuelven. La calidad depende completamente de lo buena que fue la generación. Algunas sesiones son excelentes. Algunas son mediocres. Nunca sabes cuál obtendrás.
Una capa de verificación de calidad hace que la calidad de la salida sea consistente al verificar cada salida contra estándares definidos y reintentar con correcciones específicas cuando no se cumplen los estándares.
Aquí está el patrón de llamada a la API de Claude que implementa la verificación de calidad:
async function executeWithQualityVerification(prompt, qualityStandard, maxRetries = 3) {
let attempt = 0;
let lastOutput = null;
let lastFailure = null;
while (attempt < maxRetries) {
// Genera la salida
const response = await fetch('https://api.anthropic.com/v1/messages', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ANTHROPIC_API_KEY,
'anthropic-version': '2023-06-01'
},
body: JSON.stringify({
model: 'claude-opus-4-8',
max_tokens: 4096,
messages: [
{
role: 'user',
content: attempt === 0
? prompt
: \${prompt}
El intento anterior falló la verificación de calidad: ${lastFailure}
Corrige específicamente para este fallo. No reescribas todo.\
}
]
})
});
const data = await response.json();
lastOutput = data.content[0].text;
// Verifica la calidad
const verificationResponse = await fetch('https://api.anthropic.com/v1/messages', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ANTHROPIC_API_KEY,
'anthropic-version': '2023-06-01'
},
body: JSON.stringify({
model: 'claude-opus-4-8',
max_tokens: 1000,
messages: [
{
role: 'user',
content: `Eres un verificador de calidad. Evalúa esta salida contra estos estándares:
${qualityStandard}
Salida a evaluar:
${lastOutput}
Responde SOLO con:
PASS si la salida cumple con todos los estándares requeridos
FAIL: [descripción específica de lo que falló] si no cumple con los estándares requeridos
No expliques. No sugieras mejoras. Solo PASS o FAIL con una descripción específica del fallo.`
}
]
})
});
const verificationData = await verificationResponse.json();
const verificationResult = verificationData.content[0].text.trim();
if (verificationResult.startsWith('PASS')) {
return { output: lastOutput, attempts: attempt + 1, passed: true };
}
lastFailure = verificationResult.replace('FAIL:', '').trim();
attempt++;
}
// Todos los reintentos agotados
return {
output: lastOutput,
attempts: maxRetries,
passed: false,
failure: lastFailure
};
}
Este patrón genera una salida, la verifica contra estándares definidos y reintenta con correcciones específicas cuando falla. Si todos los reintentos fallan, devuelve la mejor salida con una bandera de fallo en lugar de bloquearse.
El Patrón de Integración de Memoria
La memoria es lo que transforma un agente capaz en un agente que aprende.
Sin memoria, cada sesión comienza desde cero. El agente no sabe lo que ha hecho antes. No puede aplicar aprendizajes de ejecuciones pasadas. No puede evitar errores que ya ha cometido.
Con memoria, cada sesión se basa en la anterior. El agente sabe qué funcionó y qué no. Aplica el contexto acumulado para mejorar las salidas actuales. Mejora en la tarea específica con el tiempo.
Aquí está el patrón de integración de memoria para cualquier agente Claude:
Al inicio de cada ejecución:
Lee las entradas de memoria etiquetadas: [ETIQUETA-TAREA]
Límite: 20 entradas más relevantes
Estrategia: relevancia (no solo actualidad)
Aplica este contexto:
- Observa patrones de ejecuciones anteriores
- Observa casos límite encontrados anteriormente
- Observa problemas de calidad identificados anteriormente
- Aplica aprendizajes a la ejecución actual
Al final de cada ejecución:
Almacena en la memoria:
fecha: [HOY]
tarea: [NOMBRE DE LA TAREA]
calidad: [excelente/aceptable/fallido]
notable: [cualquier cosa que valga la pena recordar]
caso_limite: [cualquier caso límite encontrado]
patron: [cualquier patrón observado]
Etiqueta: [ETIQUETA-TAREA], [FECHA]
Consolidación mensual:
Lee todas las entradas de memoria etiquetadas: [ETIQUETA-TAREA]
Identifica:
- Patrones que aparecen en múltiples entradas
- Casos límite que se repiten
- Problemas de calidad que se repiten
- Qué se correlaciona con salidas excelentes vs. aceptables
Consolida en una sola entrada de contexto actualizada
Archiva las entradas individuales con más de 90 días
El Sistema de Recuperación de Fallos
Los agentes del mundo real encuentran fallos. Las fuentes se desconectan. Las APIs limitan la tasa. Los archivos no están donde se espera. Las salidas fallan las verificaciones de calidad después de los reintentos máximos.
El sistema de recuperación de fallos determina si estos fallos son pequeños contratiempos invisibles o paradas catastróficas.
Tres niveles de manejo de fallos:
Nivel 1: Recuperación Automática
Fallos transitorios que se resuelven con un reintento. Herramienta no disponible. Tiempo de espera de red agotado. Límite de tasa alcanzado.
Protocolo de Recuperación de Nivel 1
Ante cualquier fallo de llamada a herramienta:
- Espera 60 segundos
- Reintenta la misma llamada exacta
- Si el reintento tiene éxito: continúa normalmente, registra el contratiempo
- Si el reintento falla: escala al Nivel 2
Nivel 2: Degradación Elegante
Fallos que no se pueden resolver pero permiten una finalización parcial. Una fuente no disponible. Una herramienta que no responde. Una sección de la salida que falla las verificaciones de calidad.
Protocolo de Recuperación de Nivel 2
Ante un fallo parcial irresoluble:
- Completa lo que se pueda completar
- Anota específicamente qué se omitió y por qué
- Marca la salida como parcial en el nombre del archivo
- Incluye una nota explícita en la propia salida
- Envía una notificación: "Salida parcial — [razón específica]"
- NO falles toda la tarea porque un componente falló
Nivel 3: Parada Elegante
Fallos que hacen que toda la tarea sea imposible. CLAUDE.md no encontrado. Ruta de salida no escribible. Base de datos de memoria inaccesible.
Protocolo de Recuperación de Nivel 3
Ante un fallo completo:
- Identifica el punto de fallo específico
- Guarda cualquier trabajo completado en una ubicación temporal
- Registra el contexto completo del fallo
- Envía una notificación: "Tarea fallida — [razón específica]"
- Detente de forma ordenada sin corromper ninguna salida existente
- NO reintentes automáticamente — espera la intervención humana
Prueba de tu Agente Antes de Desplegarlo
El error más común en el despliegue de agentes del mundo real es saltarse las pruebas estructuradas.
Tres fases de prueba antes de que cualquier agente entre en funcionamiento:
Fase 1: Prueba de Componentes
Prueba cada componente de forma aislada antes de probar todo el flujo de trabajo.
Prueba que la memoria persiste
hermes chat
¿Cuál es la entrada de memoria más antigua que tienes almacenada?
Esperado: Debería reportar una entrada o reportar base de datos vacía
Si devuelve error: la configuración de memoria es incorrecta
Prueba el acceso a herramientas
Enumera los archivos en [RUTA DE SALIDA]
Esperado: Debería enumerar archivos reales
Si devuelve error: el MCP del sistema de archivos no está configurado correctamente
Prueba la búsqueda
Busca "noticias de IA hoy" y dime el resultado principal
Esperado: Debería devolver resultados de búsqueda reales
Si devuelve error: el MCP de Brave Search no está configurado correctamente
Fase 2: Prueba del Camino Feliz
Ejecuta la habilidad manualmente en una entrada estándar limpia y verifica que la salida cumple con el estándar de calidad.
Ejecuta la habilidad manualmente
hermes run research-brief
Verifica la salida
cat outputs/briefings/[HOY]-resumen-matutino.md
Verifica contra el estándar de calidad:
- ¿Mínimo 3 elementos de señal?
- ¿Cada elemento relevante para el trabajo actual?
- ¿Sin análisis genérico?
- ¿Se lee en menos de 5 minutos?
Fase 3: Prueba de Casos Límite
Desencadena deliberadamente cada caso límite documentado y verifica el comportamiento de recuperación.
Prueba: sin acceso a internet
Deshabilita Brave Search en .env
Ejecuta la habilidad
Esperado: Fallo de Nivel 3, parada ordenada, notificación enviada
Prueba: ruta de salida no escribible
Cambia OUTPUT_PATH a un directorio que no existe
Ejecuta la habilidad
Esperado: Fallo de Nivel 3, parada ordenada, notificación enviada
Prueba: día de pocas noticias
Ejecuta en un fin de semana o festivo
Esperado: Salida de Nivel 2 con NOTA DE COBERTURA indicando día lento
Ejecución de tu Agente en Producción
Una vez que las tres fases de prueba pasen, configura el programador y pasa a producción.
{
"schedules": [
{
"skill": "research-brief",
"cron": "0 6 \ \ *",
"description": "Diariamente a las 6AM",
"timeout_minutes": 15,
"on_failure": "notify_and_stop"
}
]
}
Inicia Hermes en modo background:
npm run start -- --daemon
Verifica la primera ejecución programada:
Verifica los registros después de las 6AM
cat logs/hermes-[FECHA].log
Verifica que se produjo la salida
ls outputs/briefings/
Verifica que la memoria se actualizó
hermes chat
¿Cuántas entradas de memoria de research-brief tienes?
Si la primera ejecución automatizada produce una buena salida, el agente está en producción.
Qué Cambia en el Mes 3
Mes uno: El agente funciona de manera confiable. Las salidas son consistentes. Los fallos se manejan con elegancia. Ahorras cuarenta y cinco minutos cada mañana.
Mes dos: la capa de memoria comienza a mostrar una mejora visible. El agente ha procesado sesenta días de fuentes y ha acumulado contexto sobre qué fuentes producen contenido de alta señal frente a ruido. La calidad del filtrado de señales mejora porque el agente ha aprendido qué fuentes han valido la pena seguir.
Mes tres: la consolidación de la memoria se ha ejecutado dos veces. El agente ha identificado patrones a lo largo de noventa días de investigación. Los resúmenes hacen referencia al contexto acumulado, lo que los hace más fundamentados y específicos de lo que cualquier investigación de una sola sesión podría producir.
El agente en el mes tres no está ejecutando el mismo flujo de trabajo que en el mes uno.
Está ejecutando una versión mejorada de ese flujo de trabajo basada en noventa días de inteligencia operativa acumulada.
Esa es la diferencia entre un agente de tutorial y un agente del mundo real.
El agente de tutorial realiza la tarea.
El agente del mundo real aprende a hacer la tarea mejor.
Construye la base este fin de semana.
Ejecútalo durante una semana. Arregla lo que se rompa.
Ejecútalo durante un mes. Obsérvalo mejorar.
Ejecútalo durante tres meses. Nota lo que sabe que no podrías haberle dicho el primer día.
Así es como se construye un agente de Claude que realmente funciona en el mundo real.
Sigue a @cyrilXBT para cada arquitectura de agente, plantilla de habilidad y patrón de implementación en producción que haga que tus agentes de Claude sobrevivan al contacto con el mundo real.
