> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/optimizacion-del-agente/insights.md).

# Cómo usar los Insights del Agente

Los Insights del Agente analizan las conversaciones de tu agente automáticamente y proponen cambios específicos para mejorar el rendimiento.

Accede desde el menú lateral en Agente > Insights.

## Cómo funcionan los Insights

Después de analizar un lote de conversaciones, los Insights generan una nueva versión propuesta de tu agente con un cambio de comportamiento específico. Cada insight muestra:

* Qué cambiar; la regla o comportamiento exacto que el agente debe adoptar
* Por qué; el patrón detectado en las conversaciones que explica el problema
* Razonamiento; las conversaciones y métricas específicas que respaldan la recomendación

## Cómo aplicar un insight

1. Abre Agente > Insights.
2. Revisa el cambio propuesto; lee las secciones Por qué y Razonamiento con cuidado antes de decidir.
3. Si el cambio tiene sentido para tu negocio, haz clic en Aplicar Cambios. Patagon AI crea automáticamente una nueva versión borrador con el cambio aplicado.
4. Prueba la nueva versión en Agente > Playground antes de activarla.
5. Ve a Agente > General > Versiones y activa el borrador cuando estés seguro de que tiene mejor rendimiento.

Si el cambio propuesto no se adapta a tu contexto, haz clic en Ignorar para descartarlo.

{% hint style="warning" %}
Siempre prueba un insight en el Playground antes de activarlo. Los insights son sugerencias basadas en datos de muchas conversaciones, pero el contexto específico de tu negocio puede hacer que algunas sugerencias sean irrelevantes.
{% endhint %}

## Cómo interpretar el razonamiento

Cada insight incluye el número de conversaciones analizadas, el patrón detectado y con qué frecuencia ocurre, y los cambios de comportamiento propuestos. Un buen insight tiene una muestra grande (100+ conversaciones), un patrón claro con un porcentaje específico y un cambio propuesto concreto y comprobable.

## Insights y versiones

Cada vez que aplicas un insight, Patagon AI crea automáticamente una nueva versión borrador. Si un insight aplicado no mejora el rendimiento, revierte a la versión anterior instantáneamente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/optimizacion-del-agente/insights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.