# Ejecutar acciones sobre contactos y empresas

> Ejecute cualquier acción de IA directamente desde la página de detalle de un contacto o empresa, utilizando los datos de ese registro como contexto.

Source: https://docs.graph8.com/es/studio/entity-action-execution/

El botón Ejecutar acción en las páginas de detalle de contactos y empresas permite ejecutar cualquier habilidad de IA sobre un registro individual. La IA recibe todos los datos del registro como contexto, de modo que los resultados son específicos de esa persona o empresa, sin necesidad de copiar y pegar.

## Cómo funciona

1. Abra cualquier página de detalle de un contacto o empresa
2. Haga clic en el ícono de **rayo** en el encabezado de la página
3. Busque o desplácese para seleccionar una acción
4. La acción se ejecuta con los datos de ese registro inyectados automáticamente como contexto
5. Los resultados aparecen en un panel; puede copiarlos o cerrarlos cuando termine

El panel permanece abierto mientras la acción se ejecuta y muestra el tiempo de finalización al completarse.

## Qué acciones están disponibles

El menú desplegable muestra todas las **acciones de IA habilitadas** configuradas para su organización. Son las mismas acciones disponibles en la sección de AI Agents.

Acciones que aparecen aquí:

| Tipo | Descripción | Ejemplo |
|------|-------------|---------|
| **Investigación** | Resumir noticias de la empresa, encontrar eventos desencadenantes, identificar puntos de dolor | "Resuma las noticias de financiación recientes de esta empresa" |
| **Personalización** | Generar una línea de apertura, redactar un correo personalizado, preparar una nota de conexión | "Redacte una apertura de LinkedIn para este contacto" |
| **Análisis** | Puntuación de calificación, evaluación de idoneidad, contexto competitivo | "Evalúe este lead frente a nuestro ICP" |
| **Habilitación** | Notas de preparación para reuniones, sugerencias de argumentario, manejo de objeciones | "Genere notas de preparación para la reunión con esta cuenta" |

Las acciones deben estar habilitadas en **AI Agents** para aparecer en esta lista. Solo se muestran aquí las acciones con IA (LLM); las acciones de automatización y webhook no se incluyen.

## Inyección de contexto

Cuando ejecuta una acción desde la página de un contacto, la acción recibe:

- Nombre, apellido, cargo, nombre de la empresa
- Dirección de correo electrónico y número de teléfono
- Ubicación, URL de LinkedIn
- Cualquier campo personalizado del registro

Cuando se ejecuta desde la página de una empresa, la acción recibe:

- Nombre de la empresa, dominio, sector
- Número de empleados, rango de ingresos, ubicación
- Tecnologías, palabras clave, descripción
- Cualquier campo personalizado del registro

La IA utiliza estos datos para la sustitución de variables en las plantillas de acción y como contexto de fondo en su prompt.

### Contexto global incluido

Más allá de los datos del registro, cada acción también recibe:

- **Brand Brief**: el posicionamiento de su empresa
- **Propuestas de valor**: diferenciadores clave
- **Definición de ICP**: a quién le vende
- **Offer Brief**: precios y paquetes
- **Personas**: perfiles de roles de compradores

Este contexto proviene del Contexto Global de Studio. Actualícelo en **Studio → Contexto Global** para mejorar todas las acciones a la vez.

## Panel de resultados

Los resultados se muestran en línea con formato (encabezados, listas, enlaces). Puede:

| Botón | Acción |
|-------|--------|
| **Copiar** | Copiar el resultado completo al portapapeles |
| **Copiar como Markdown** | Copiar conservando el formato Markdown |
| **Regenerar** | Volver a ejecutar la acción (útil si el primer resultado no fue del todo correcto) |
| **Guardar en registro** | Almacenar el resultado como una nota en el contacto o empresa |
| **Enviar a Copilot** | Continuar iterando en el chat de Copilot |

### Guardar resultados

Cuando hace clic en **Guardar en registro**, el resultado se agrega a:

- La pestaña **Notas** del contacto o empresa
- El CRM (si la sincronización está habilitada) como nota de actividad
- La línea de tiempo de la bandeja de entrada como una entrada "Generada por IA"

Los resultados guardados pueden consultarse en acciones futuras; forman parte del contexto del registro a partir de ese momento.

## Ejecución de acciones a escala

Las acciones de registro individual son para trabajo puntual. Para ejecutar la misma acción sobre muchos registros, utilice una de estas opciones:

| Método | Ideal para | Ubicación |
|--------|------------|-----------|
| **Acción masiva en lista** | Ejecutar sobre todos los registros de una lista | **Datos → Listas → Seleccionar lista → Ejecutar acción** |
| **Paso de campaña** | Ejecutar como parte de una secuencia | **Engage → Sequencer → Agregar paso de acción IA** |
| **Disparador de flujo de trabajo** | Ejecución automática cuando un contacto cumple una condición | **Agents → Workflows** |
| **Columna de enriquecimiento** | Ejecutar como columna calculada en cada registro | **Datos → Campos personalizados → Columna IA** |

## Permisos y créditos

### Quién puede ejecutar acciones

| Rol | Permisos |
|-----|----------|
| **Administrador** | Ejecutar cualquier acción habilitada, editar acciones |
| **Miembro** | Ejecutar cualquier acción habilitada |
| **Visualizador** | No puede ejecutar acciones |

Deshabilite acciones individuales para roles específicos en **AI Agents → Configuración de acción → Visibilidad por rol**.

### Costos en créditos

Cada acción consume créditos según el nivel del modelo:

| Nivel de modelo | Costo por ejecución | Acciones típicas |
|-----------------|---------------------|------------------|
| **Rápido** | 1 crédito | Respuestas cortas, resúmenes |
| **Estándar** | 3-5 créditos | La mayoría de personalización e investigación |
| **Profundo** | 10-20 créditos | Investigación avanzada con acceso web |
| **Razonamiento** | 15-40 créditos | Puntuación de calificación, análisis complejos |

La ejecución de acciones desde páginas de detalle se descuenta de su cuota mensual de créditos. Consulte los créditos disponibles en **Configuración → Facturación**.

## Manejo de errores

Si una acción falla, el panel muestra el motivo del error:

| Error | Causa | Solución |
|-------|-------|----------|
| **Campo requerido faltante** | La acción necesita un campo que está vacío en este registro (p. ej., URL de LinkedIn) | Enriquezca el registro primero |
| **Créditos insuficientes** | El saldo de créditos está por debajo del costo de la acción | Recargue en Configuración → Facturación |
| **Tiempo de espera del modelo** | El LLM no respondió a tiempo (poco frecuente) | Haga clic en Regenerar |
| **Acción deshabilitada** | Un administrador deshabilitó esta acción después de que usted abrió la página | Solicite a su administrador que la reactive |
| **Límite de solicitudes alcanzado** | Demasiadas acciones simultáneas desde este usuario | Espere 30 segundos y vuelva a intentarlo |

## Registro de actividad

Cada ejecución de acción queda registrada:

- **Quién** la ejecutó (correo electrónico del usuario)
- **Qué** acción se ejecutó
- **Sobre qué** registro se ejecutó
- **Cuándo** se ejecutó (marca de tiempo)
- **Costo** en créditos

Consulte el registro en **Configuración → Actividad → Acciones IA**. Úselo para revisión de cumplimiento, auditoría de uso o análisis del comportamiento del equipo.

> **Tip:**
> Cree una acción "Apertura personalizada" en AI Agents y ejecútela desde cualquier página de contacto para generar una primera línea personalizada para outbound en segundos. Combínela con una acción "Investigar evento desencadenante": ejecute ambas consecutivamente sobre el mismo contacto para obtener un mensaje de outbound completamente preparado en menos de un minuto.

## Relacionados

- [AI Agents →](https://docs.graph8.com/ai-features/overview/): crear y configurar acciones
- [Campañas →](https://docs.graph8.com/studio/campaigns/): ejecutar acciones a escala en audiencias
- [Copilot Skills →](https://docs.graph8.com/studio/copilot/): habilidades contextuales en el editor de Studio
- [Workflows →](https://docs.graph8.com/ai-features/workflows/): ejecución automática de acciones por disparadores
- [Contexto Global →](https://docs.graph8.com/studio/global/): contexto compartido que utiliza cada acción