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

# Dale acciones a tu agente

> Elige cómo tu agente recopila información, consulta tu API o trabaja con Google Sheets, y aprende a probar y revisar los resultados.

Las acciones permiten que tu agente trabaje con información durante una conversación: conectar sistemas externos, extraer datos estructurados o leer y escribir datos autorizados en una hoja de cálculo. Abre **Configuración → Acciones** para crearlas y administrarlas.

Elige el tipo de acción según dónde está la información y qué necesita hacer tu agente. Las guías incluyen ejemplos prácticos que puedes adaptar a tu negocio.

## Elige un tipo de acción

<Columns cols={2}>
  <Card title="Conectar un sistema" icon="plug" href="/es/product-guides/ai-agent/custom-tools">
    Conecta tu agente con un sistema externo mediante una API. Usa información de la conversación para consultar datos actualizados o realizar las operaciones que permita tu API.
  </Card>

  <Card title="Recopilar datos" icon="list-check" href="/es/product-guides/ai-agent/collect-data">
    Extrae datos estructurados de una conversación con los campos que tú definas. Recoge la información ya compartida, solicita los detalles que falten y guarda los resultados en Visito.
  </Card>

  <Card title="Google Sheets" icon="table" href="/es/product-guides/integrations/google-sheets">
    Permite que tu agente lea, añada o actualice filas durante una conversación. Elige a qué columnas puede acceder y qué puede hacer con cada una.
  </Card>
</Columns>

| Tu objetivo | Empieza con |
| - | - |
| Consultar información actual o realizar una operación mediante una API | Conectar un sistema |
| Convertir detalles de la conversación en campos estructurados guardados en Visito | Recopilar datos |
| Leer, añadir o actualizar datos en una hoja de cálculo | Google Sheets |

La conexión y la acción cumplen funciones diferentes. Administra las cuentas de proveedores en **Conexiones → Integraciones**. Configura lo que puede hacer el agente en **Acciones**. Las integraciones conectadas compatibles también pueden mostrar sus capacidades en la lista de Acciones.

## Ejemplos de Google Sheets

La subsección **Google Sheets** reúne la guía de configuración y sus ejemplos completos.

<Card title="Citas de barbería" icon="calendar" href="/es/product-guides/integrations/google-sheets-hairdresser">
  Prepara las pestañas de disponibilidad y reservas, selecciona columnas y permisos, reserva por Webchat y comprueba la fila guardada y la disponibilidad recalculada.
</Card>

## Configura y prueba una acción

1. **Define el propósito.** Explica cuándo usarla, qué información pedir y cuándo confirmar con el cliente.
2. **Elige el negocio.** Ofrece la acción solo donde correspondan sus datos y su comportamiento.
3. **Configura entradas o permisos.** La recopilación usa campos; las API usan un esquema de entrada y un endpoint; Sheets usa permisos por columna y reglas para identificar filas únicas.
4. **Elige el modo y el destino de prueba.** Sigue la guía específica antes de habilitar canales reales. Las acciones nuevas de recopilación y las escrituras de Sheets empiezan en Solo área de pruebas. Las escrituras de Sheets requieren otro archivo de prueba con una estructura compatible; las lecturas usan la hoja seleccionada también en Playground.
5. **Verifica el resultado.** Comprueba los datos guardados o la respuesta de la API, además del mensaje final del agente.

Para una prueba controlada en Webchat, la acción debe estar disponible para ese canal y negocio. Playground y Webchat pueden guardar datos en destinos diferentes o tener distinto comportamiento de entrega externa; cada guía explica lo que corresponde.

## Revisa qué ocurrió

Abre **Acciones → Historial** para filtrar ejecuciones por acción, entorno y estado. Abre una ejecución para revisar sus entradas, resultado, tiempos y detalles técnicos disponibles. Usa **Abrir conversación** para ver la solicitud del cliente y el comprobante de la acción en contexto.

Para **Recopilar datos**, el panel **CRM → Solicitudes de acciones** de la conversación muestra los envíos guardados desde canales reales. Para **Conectar un sistema**, compara los datos guardados de la solicitud con la respuesta; esos datos pueden no incluir todo el cuerpo HTTP transmitido. Para **Google Sheets**, comprueba el resultado de ejecución y las celdas correspondientes.

Que termine una solicitud no siempre significa que la operación haya tenido éxito. Comprueba el resultado del sistema o los datos guardados antes de confirmar el resultado al cliente.

<Tip>
  Empieza por un caso pequeño con datos ficticios. Cuando funcionen la configuración y la conversación, revisa el negocio y los permisos antes de ofrecerlo a clientes.
</Tip>

Los desarrolladores también pueden administrar acciones compatibles e inspeccionar ejecuciones mediante la [API de Acciones](/es/api-docs/actions-api).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.