# Agentes y Acciones

> Cree agentes de IA con personas personalizadas, adjunte acciones reutilizables, conecte bases de conocimiento e impleméntelos en teléfono, correo electrónico y chat.

Source: https://docs.graph8.com/es/ai-features/skills/

Los agentes son asistentes con IA que usted crea y despliega. Cada agente cuenta con una persona, una base de conocimiento y un conjunto de acciones que puede ejecutar. Despliegue agentes en llamadas telefónicas, respuestas de correo electrónico, chat web o flujos de trabajo internos.

## Tipos de agente

| Tipo | Qué es | Caso de uso |
|------|--------|-------------|
| **Agente** | Asistente de IA con persona y capacidades personalizadas | Llamadas con clientes, gestión de correos, soporte por chat |
| **Twin** | Agente clonado a partir del perfil de LinkedIn y el estilo de escritura de una persona real | Prospección outbound que suena como un miembro específico del equipo |

## Creación de un agente

1. Vaya a **Agentes → Crear agente**
2. Configure el agente:
   - **Nombre**: nombre visible del agente
   - **Rol**: lo que hace el agente (SDR, soporte, investigador, etc.)
   - **Persona**: configuración de personalidad:
     - **Formalidad**: tono de informal a formal
     - **Concisión**: respuestas de detalladas a directas
     - **Asertividad**: enfoque de suave a asertivo
   - **Instrucciones**: pautas de comportamiento personalizadas
3. Configure la identidad:
   - **Número de teléfono**: asigne un número para llamadas
   - **Voz**: elija entre voces predefinidas o clone una voz
   - **Calendario**: conéctelo para la programación de reuniones
4. Adjunte acciones y colecciones de conocimiento
5. Haga clic en **Guardar**

### Creación de un Twin

Los Twins replican el estilo de comunicación de una persona real:

1. Haga clic en **Crear Twin**
2. Ingrese la URL de LinkedIn de la persona
3. graph8 extrae su perfil, estilo de escritura y antecedentes
4. Cargue muestras de escritura adicionales (correos, publicaciones) para afinar la coincidencia de estilo
5. El Twin genera mensajes de prospección que suenan como esa persona

## Acciones

Las acciones son las capacidades que usted otorga a sus agentes. Cada acción define una tarea que un agente puede ejecutar.

### Tipos de acción

| Tipo | Cómo se ejecuta | Ejemplo |
|------|----------------|---------|
| **LLM** | La IA genera una respuesta usando una plantilla de prompt | Investigar una empresa, redactar un correo, calificar un lead |
| **API** | Llama a un endpoint de API externo | Consultar datos en su CRM, verificar inventario, enviar una notificación |
| **Script** | Ejecuta código personalizado | Transformar datos, calcular puntuaciones, dar formato a resultados |
| **Workflow** | Ejecuta un flujo de trabajo de varios pasos (ver más abajo) | Pipeline de calificación de leads, distribución de contenido |

### Plantillas de acción integradas

graph8 incluye más de 15 plantillas de acción prediseñadas:

- **Company Research**: análisis detallado de una empresa objetivo
- **Contact Dossier**: recopilación de toda la información conocida sobre una persona
- **Competitor Analysis**: análisis del posicionamiento competitivo
- **Keywords Research**: descubrimiento de palabras clave relevantes
- **FAQ Generation**: creación de preguntas frecuentes a partir de la base de conocimiento
- **Content creation**: generación de publicaciones en redes sociales, correos y resúmenes

Adjunte acciones a los agentes para que puedan utilizarlas durante conversaciones y flujos de trabajo.

### Puertas de aprobación

Las acciones pueden requerir aprobación humana antes de ejecutarse. Active **Requiere aprobación** en cualquier acción y el agente se detendrá para solicitar confirmación antes de ejecutarla. Apruebe o rechace desde el historial de ejecución.

### Entrada de ejecución de acción

Cuando ejecuta una acción manualmente (o la prueba antes de adjuntarla a un agente), el diálogo **Entrada de ejecución de acción** lo guía campo por campo a través de los datos que la acción espera recibir. Los campos obligatorios están marcados, y el diálogo muestra sugerencias del esquema de entrada de la acción para que vea qué espera cada variable antes de enviar.

El mismo diálogo se reutiliza dentro del chat del agente: cuando un agente inicia una acción que requiere datos de entrada, el mensaje al usuario utiliza este formulario consistente.

## Workflows

Los Workflows encadenan varias acciones en procesos automatizados de varios pasos mediante un constructor visual.

### Creación de un Workflow

1. Vaya a **Agentes → Workflows**
2. Haga clic en **Crear Workflow** o comience desde una plantilla
3. Construya su Workflow con tres modos:
   - **Visual**: lienzo de nodos con arrastrar y soltar (ReactFlow)
   - **Simple**: lista lineal paso a paso
   - **Código**: editor JSON para configuración avanzada
4. Conecte los nodos para definir el flujo
5. Pruebe con datos de muestra
6. Guarde y adjunte a un agente

### Tipos de nodo

| Nodo | Qué hace |
|------|----------|
| **Start** | Punto de entrada: define el disparador y los datos de entrada |
| **Action** | Ejecuta una acción de LLM, API o Script |
| **Agent** | Transfiere el control a otro agente |
| **Tool** | Llama a una herramienta de servidor MCP |
| **Condition** | Bifurca según condiciones de datos |
| **Loop** | Itera sobre una lista de elementos |
| **Transform** | Transforma datos entre pasos |
| **State** | Almacena estado intermedio |
| **Human** | Se detiene para aprobación humana |
| **Handoff** | Transfiere a una persona u otro sistema |
| **End** | Completa el flujo de trabajo |

### Plantillas de Workflow

Comience desde plantillas prediseñadas:

- **Lead Qualification**: calificación y enrutamiento de leads entrantes
- **Content to Social Media**: reutilización de contenido en varias plataformas
- Plantillas personalizadas que usted guarda a partir de sus propios Workflows

## Colecciones de conocimiento

Las colecciones de conocimiento brindan a sus agentes acceso a los documentos y datos de su empresa.

1. Vaya a **Agentes → Colecciones**
2. Cree una colección (por ejemplo, "Documentación de producto" o "Casos de éxito")
3. Cargue archivos: PDFs, documentos, hojas de cálculo
4. Organice con carpetas
5. Adjunte colecciones a los agentes

Los agentes consultan sus colecciones adjuntas al responder preguntas, lo que garantiza que las respuestas estén fundamentadas en su contenido real.

## Servidores MCP

Conecte servidores de herramientas externas usando el Model Context Protocol (MCP):

1. Vaya a **Agentes → Servidores MCP**
2. Haga clic en **Crear servidor**
3. Configure la conexión:
   - **SSE**: conéctese a un servidor remoto mediante URL
   - **Stdio**: conéctese a un proceso local
4. Pruebe la conexión
5. graph8 almacena en caché las herramientas disponibles para consulta sin conexión

Las herramientas MCP aparecen como **nodos Tool** en el constructor de Workflows y están disponibles para los agentes durante las conversaciones.

## Chat con el agente

Pruebe e interactúe con los agentes en tiempo real:

1. Abra la página de detalles de un agente
2. Haga clic en la pestaña **Chat**
3. Escriba un mensaje: el agente responde usando su persona, acciones y conocimiento
4. Observe las ejecuciones de herramientas en el panel lateral mientras el agente trabaja

Las sesiones de chat se guardan con el historial completo y pueden retomarse más adelante.

## Analítica de agentes

Haga seguimiento del rendimiento de los agentes:

- **Analítica de llamadas**: resultados de llamadas inbound, duración y desenlaces
- **Feed de actividad**: registro cronológico de todas las acciones del agente
- **Historial de ejecución**: resultados acción por acción con entradas y salidas

> **Tip:**
> Comience con un agente enfocado que haga una sola cosa bien (por ejemplo, "Programador de reuniones" o "Calificador de leads"). Agregue capacidades de forma gradual a medida que refine su persona y base de conocimiento. Use la puerta de aprobación en acciones de alto impacto hasta que confíe en el criterio del agente.

## Relacionado

- [Agentes de voz →](https://docs.graph8.com/ai-features/voice-agents/): despliegue de agentes específico para llamadas telefónicas
- [Workflows →](https://docs.graph8.com/ai-features/workflows/): guía detallada del constructor de Workflows
- [Chat web →](https://docs.graph8.com/engage/web-chat/): despliegue agentes en su sitio web
- [Copilot →](https://docs.graph8.com/ai-features/copilot/): asistente de IA integrado