Critique and Refinement Tool

Critique and Refinement Tool es un componente que permite a tu agente de IA revisar y mejorar sus propias acciones. Después de ejecutar una tarea, el agente puede usar esta herramienta para analizar el resultado, identificar errores o áreas de mejora y planificar el siguiente paso de manera más efectiva.

¿Cómo funciona?

El componente no realiza llamadas externas; simplemente recibe información sobre la acción previa y la meta original. Internamente, el agente envía estos datos a la herramienta, que devuelve un objeto JSON estructurado con:

1. Objetivo original – la meta que el agente intentaba alcanzar.
2. Resultado obtenido – la salida de la acción anterior.
3. Evaluación crítica – un análisis de si el resultado cumple con el objetivo y por qué puede haber fallado.
4. Próximo paso – una recomendación concreta y accionable para continuar.

El agente interpreta este JSON y decide la siguiente acción, creando un ciclo de mejora continua sin intervención humana.

Entradas

Campos de Entrada

• Tool Description: Instrucciones detalladas para el agente sobre cuándo y cómo usar la herramienta de reflexión.
• Tool Name: Nombre que identificará esta instancia de la herramienta de auto‑crítica.

Salidas

• Tool: Un objeto de tipo Tool que se construye mediante el método build_tool. Este objeto contiene la lógica necesaria para que el agente invoque la herramienta y reciba el análisis crítico.

Ejemplo de Uso

1. Ejecutar una acción
   El agente realiza una búsqueda web para encontrar la dirección de un restaurante.

2. Invocar la herramienta
   Se envía a la herramienta los siguientes datos:

   • Tool Description: “Use this tool AFTER executing an action (e.g., a web search) to critically evaluate the result. This is your moment to be a critic of your own work to ensure you are on the right path.”
   • Tool Name: “WebSearchCritique”

3. Resultado
   La herramienta devuelve un JSON como:

   {
     "original_goal": "Obtener la dirección del restaurante X",
     "result": "La búsqueda devolvió la dirección incorrecta",
     "critique": "El resultado no coincide con la dirección esperada; probablemente se usó un término de búsqueda ambiguo.",
     "next_step": "Reformular la búsqueda con el nombre completo del restaurante y la ciudad."
   }

4. Acción siguiente
   El agente interpreta el JSON y realiza una nueva búsqueda con la frase mejorada.

Consejos y Mejores Prácticas

• Usa la herramienta después de cada acción importante: especialmente cuando el resultado es complejo o ambiguo.
• Mantén el Tool Description claro y conciso: esto ayuda al agente a comprender rápidamente cuándo y cómo aplicar la reflexión.
• Revisa el JSON de salida: asegúrate de que el agente esté extrayendo correctamente el próximo paso.

Consideraciones de Seguridad

• La herramienta no accede a datos sensibles ni a APIs externas, por lo que no presenta riesgos de exposición de información.
• Asegúrate de que el Tool Name sea descriptivo para evitar confusiones con otras instancias de herramientas de crítica.

---