Skip to main content
Espacios → nodo Agente → pestaña Funciones, o clic en un nodo ƒ del lienzo
Una herramienta (o función) permite al agente hacer algo además de responder: consultar el estado de una póliza en tu sistema, buscar un pedido, crear un ticket, agendar una cita. Técnicamente es una llamada HTTP a una URL de tu empresa; el agente decide cuándo usarla según su descripción y le pide al cliente los datos que necesita.

Crear una herramienta

+ Nueva función abre el catálogo de integraciones:
  • Catálogo con plantillas listas por categoría: CRM (HubSpot, Salesforce), Productividad (Google Sheets, Slack, Email), Comunicación (WhatsApp) y Datos (PostgreSQL, Webhooks). Al elegir una, la función se crea con URL, método y parámetros ya definidos; solo falta configurar la autenticación.
  • Función HTTP personalizada: formulario en blanco para tu propia API.

Configurar una herramienta

Clic en la función abre su ficha con cuatro pestañas:

Config

Los mismos campos de la creación. Guardar función al terminar.

Parámetros

Los datos que el agente debe obtener (del cliente o del contexto) para llamar a la herramienta. + Agregar parámetro:

Probar

Ejecuta la herramienta con valores de prueba antes de activarla con clientes: rellena los parámetros, pulsa Ejecutar prueba y revisa el código de estado, la latencia y la respuesta JSON. Una función que responde error aquí, responderá error en la conversación.

Auth

Si tu API requiere credenciales, asocia un autenticador. Las credenciales nunca se muestran al cliente ni al agente; Sofia Chat las inyecta en cada llamada. Los autenticadores son de la organización: crea uno y reutilízalo en todas las funciones que llamen al mismo sistema. Clic en un autenticador de la lista lo asigna a la función (· Activo); otro clic lo quita.

Eliminar

Eliminar función (pie de la ficha) borra la función y su configuración tras confirmar. El agente deja de poder usarla de inmediato.

Medir

En el Dashboard las métricas Cant. Llamadas a Función, Tasa de Error de Funciones y Tiempo de Ejecución de Funciones muestran cuánto se usan y si fallan. Una tasa de error que sube de golpe casi siempre es un sistema tuyo caído o una credencial vencida.
Empieza con una herramienta de solo lectura (consultar estado de algo) y compruébala una semana con clientes reales antes de dar al agente herramientas que escriban en tus sistemas (crear tickets, modificar datos).