> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Agente IA capaz de mantener una conversación natural y tomar acciones autónomas usando herramientas.

El **Agente de IA** te permite diseñar flujos conversacionales que manejan procesos con múltiples posibilidades. Sus principales fortalezas son la capacidad de integrar **herramientas** adaptadas a las necesidades de tu negocio y la flexibilidad de definir su comportamiento directamente en las instrucciones, sin añadir complejidad innecesaria.

No necesitas escribir esas instrucciones a mano: cuando [creas un agente](/es/docs/main-platform/ai-center/create-agent), Treble las redacta a partir de lo que le describes. Esta página explica qué contienen, cómo ajustarlas y qué puede hacer el agente.

## ¿Es para ti?

<Tabs>
  <Tab title="✅ Ideal si necesitas">
    * Tienes un proceso complejo que quieres que la IA gestione.
    * Existen múltiples posibilidades dentro de una misma conversación.
    * Necesitas definir diferentes reglas de salida o de escalamiento.
    * Buscas avanzar en un proceso de ventas.
    * Quieres reducir el tiempo de respuesta a prospectos.
  </Tab>

  <Tab title="❌ No es ideal si">
    * Solo necesitas enviar un mensaje fijo o una plantilla, sin conversación de por medio.
    * El flujo se resuelve con bloques de pregunta y respuesta y condicionales simples.
  </Tab>
</Tabs>

## Casos de uso

* Calificación avanzada de leads con múltiples rutas de salida.
* Envío automatizado de información postventa.
* Comunicación con asistentes después del registro a un webinar.
* Asistencia para ayudar al usuario a elegir un producto entre varias opciones.
* Seguimiento automático de carritos abandonados.

<div class="hr" />

## Cómo leer las instrucciones generadas

Las instrucciones que escribe Treble siguen una estructura consistente. Conocerla te ayuda a ubicar rápido qué modificar cuando el agente no se comporta como esperas:

| Sección                     | Qué contiene                                            | Cuándo tocarla                                       |
| --------------------------- | ------------------------------------------------------- | ---------------------------------------------------- |
| **Identidad y voz**         | Quién es el agente, tono y estilo.                      | El agente suena demasiado formal, frío o largo.      |
| **Meta, alcance y límites** | Qué debe lograr y de qué no puede hablar.               | El agente responde temas fuera de tu negocio.        |
| **Pasos y reglas**          | El orden de la conversación y sus criterios.            | Pide datos en mal orden o no cierra cuando debería.  |
| **Herramientas**            | Cuándo llamar cada herramienta y qué validar antes.     | Una herramienta no se usa, o se usa a destiempo.     |
| **Casos límite**            | Qué hacer si falta información o el contacto se desvía. | Aparece una situación que el agente no supo manejar. |
| **Salidas y escalamiento**  | Cuándo terminar, cuándo derivar y qué registrar.        | Las conversaciones no llegan al equipo correcto.     |

<Tip>
  Ajusta una sección a la vez y prueba en el playground después de cada cambio. Reescribir todo el prompt de una vez hace muy difícil saber qué fue lo que mejoró o empeoró el comportamiento.
</Tip>

### Escribir las instrucciones desde cero

Si prefieres partir de una página en blanco, o quieres entender qué está haciendo el generador, esta es la estructura recomendada:

1. **Contexto y objetivo**
   * Explica qué debe lograr el agente y en qué escenario se usa.
2. **Tono y estilo**
   * Indica el registro deseado (por ejemplo, profesional y claro).
3. **Conocimiento disponible**
   * Indica cuándo consultar la base de conocimientos y cuándo no hacerlo.
4. **Herramientas disponibles**
   * Nombre, propósito, parámetros, precondiciones y límites de cada herramienta.
   * Reglas de uso: cuándo llamarla, qué validar antes y qué devolver después.
5. **Descripción de la tarea con reglas explícitas**
   * Pasos a seguir, prioridades, criterios de finalización y de éxito.
   * Qué hacer si falta información y cómo pedirla.
6. **Capacidades y no-capacidades**
   * Lo que el agente puede hacer y lo que no puede hacer (ni debe prometer).
7. **Ejemplos concretos**
   * Muestras de entradas y salidas correctas, más uno o dos contraejemplos.
8. **Razonamiento**
   * Recordatorio para pensar paso a paso antes de responder.
9. **Escalamiento y salidas**
   * Cuándo finalizar, cuándo escalar y qué datos registrar.

Empieza con un alcance acotado, suma herramientas de forma incremental y expande la cobertura a medida que los resultados sean consistentes.

💡Una vez que tu agente responda correctamente en el playground, dirígete al **Creador de Conversaciones** y agrega el bloque **Agente AI** a tu flujo. Lo encuentras en la sección de bloques avanzados.

<img src="https://mintcdn.com/trebleai/YSdZhfVf8ZqT-MDw/images/TOMNodeES.jpg?fit=max&auto=format&n=YSdZhfVf8ZqT-MDw&q=85&s=a39b92aaf94056db04ab5e0ad16e2d76" alt="Bloque del Agente de IA dentro del creador de conversaciones" width="658" height="148" data-path="images/TOMNodeES.jpg" />

<div class="hr" />

## Herramientas

El Agente de IA puede usar diferentes herramientas para ejecutar acciones dentro o fuera de la conversación. Estas herramientas amplían sus capacidades, permitiéndole consultar información, crear tickets o actualizar propiedades en sistemas externos como HubSpot, además de interactuar con funciones nativas de Treble.

Cuando generas un agente, Treble elige las herramientas que necesita y las inserta en las instrucciones. Las que requieren datos tuyos quedan marcadas como pendientes de configuración; puedes completarlas y agregar otras desde el [editor](/es/docs/main-platform/ai-center/configure-agent).

### Generales

* **Buscar en la Web** — Busca información actualizada o contextual en internet.
* **Enviar documento** — Envía un archivo al usuario durante la conversación.
* **Enviar imagen** — Envía una imagen al usuario durante la conversación.

### Treble

* **Leer variable** — Referencia el valor de una variable dentro de las instrucciones.
* **Guardar respuesta como variable** — Guarda la respuesta del contacto en una variable de Treble.
* **Transferir a un agente** — Escala la conversación a un agente humano en Treble.
* **Enviar conversación** — Envía el contacto a otro flujo de Treble.
* **Cerrar conversación** — Finaliza la interacción después del tiempo que definas.

### HubSpot

* **Transferir a un agente** — Envía la conversación a otro agente o equipo dentro de HubSpot.
* **Crear ticket** — Genera un nuevo ticket con la información recopilada.
* **Leer Propiedad de Contacto** — Consulta el valor de una propiedad específica de un contacto.
* **Guardar / Editar propiedad** — Actualiza una propiedad de contacto con datos de la conversación.

### Avanzadas

* **Llamada a API** — Realiza un llamado a una API externa con valores fijos o con variables que el agente haya recolectado. Ver la [guía de la herramienta API](/es/docs/main-platform/ai-center/agents/ai-agent/api-tool).
* **Apps Conectadas** — Ejecuta acciones en las aplicaciones que conectaste a Treble, como [Google Calendar](/es/docs/main-platform/ai-center/agents/ai-agent/google-calendar) o [Shopify](/es/docs/main-platform/ai-center/agents/ai-agent/shopify-usage).

<Note>
  Las herramientas de HubSpot solo aparecen si tienes la integración conectada, y **Apps Conectadas** muestra únicamente las aplicaciones que ya vinculaste a tu cuenta.
</Note>

<div class="hr" />

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Qué es el Agente de IA?">
    Es un agente de IA diseñado para manejar flujos conversacionales con múltiples posibilidades, integrando herramientas y lógica avanzada para ejecutar tareas automáticas.
  </Accordion>

  <Accordion title="¿Tengo que escribir el prompt yo?">
    No. Describes lo que necesitas, respondes algunas preguntas y Treble redacta las instrucciones, elige las herramientas y arma la base de conocimientos. Tu trabajo es revisar el resultado, completar las herramientas pendientes y probarlo.
  </Accordion>

  <Accordion title="¿Necesito saber programar para configurarlo?">
    No. Toda la configuración se hace desde la interfaz de Treble.
  </Accordion>

  <Accordion title="¿El agente puede entender mensajes de voz de WhatsApp?">
    Sí. El agente puede **entender mensajes de voz enviados por los usuarios a través de WhatsApp** y responderá automáticamente con texto en la conversación.
  </Accordion>

  <Accordion title="¿Qué pasa si el agente no se comporta como espero?">
    Revisa las instrucciones e intenta hacerlas más explícitas. Ubica la sección correspondiente en la tabla de arriba y agrega el caso que falló como ejemplo concreto.
  </Accordion>

  <Accordion title="¿Puedo combinar este agente con otros nodos del flujo?">
    Sí. El agente puede integrarse dentro de un flujo más amplio, y puede activar o cerrar conversaciones, guardar respuestas o llamar herramientas externas según tus reglas.
  </Accordion>

  <Accordion title="¿Qué herramientas puede usar el agente?">
    Herramientas **generales**, **de Treble**, **de HubSpot** y **avanzadas**, incluyendo acciones como crear tickets, leer o editar propiedades, enviar documentos, transferir conversaciones, llamar a una API o buscar información en la web.
  </Accordion>

  <Accordion title="¿Cómo pruebo mi configuración antes de lanzarla?">
    Usa el [playground](/es/docs/main-platform/ai-center/playground) para ejecutar pruebas controladas con diferentes inputs, y envíate una conversación de prueba por WhatsApp. Itera hasta que el agente responda correctamente en todos los casos.
  </Accordion>

  <Accordion title="¿El agente puede entender imágenes?">
    Sí. El agente puede entender imágenes enviadas por WhatsApp y usar lo que ve para guiar sus acciones. Por ejemplo, puede reconocer objetos, leer texto en capturas de pantalla o interpretar elementos en la imagen para decidir qué hacer.

    Sin embargo, el agente no genera ni crea imágenes. Su capacidad visual se centra en interpretar y actuar sobre imágenes existentes, no en producir nuevas.
  </Accordion>

  <Accordion title="¿Cómo manejo casos complejos o excepciones?">
    Define reglas claras de salida o escalamiento. Si el agente no puede resolver una situación, transfiere la conversación a un agente humano o registra el evento en un ticket.
  </Accordion>

  <Accordion title="¿El agente puede aprender o adaptarse con el tiempo?">
    No aprende automáticamente de cada interacción, pero puedes **mejorar su comportamiento** iterando sobre las instrucciones y ajustando las herramientas o condiciones de salida.
  </Accordion>
</AccordionGroup>

## Consideraciones importantes

<Note>
  **Privacidad:** Informa a usuarios que sus datos serán guardados y cumple con regulaciones aplicables (GDPR, etc.).
</Note>