Agregar herramientas a un agente

Conecta tu agente con otros sistemas mediante herramientas de tipo webhook: define cuándo usarlas, a qué dirección llamar y qué datos enviar.

Una herramienta le permite al agente hacer algo más que conversar: consultar el estado de un pedido, registrar una solicitud o buscar un dato en otro sistema. El agente decide cuándo usarla según la descripción que tú le des, reúne los datos que necesita preguntándole al cliente y hace la llamada.

Las herramientas se crean dentro de cada agente, en la pestaña Herramientas. La opción Herramientas del menú lista las de todos tus agentes para consultarlas y editarlas.

En WeSyncro:AgentesAgentes

Antes de empezar#

Para una herramienta de tipo webhook necesitas, de parte del sistema al que vas a conectar:

La dirección del servicio y el método que acepta.
Los datos que espera recibir.
La clave de acceso, si la exige.

Tipos de herramienta#

Tipo	Para qué sirve
Webhook	El agente llama a una dirección web con un método, encabezados y parámetros.
Cliente	Define una función que el agente puede invocar en tu propia aplicación web. No lleva dirección ni método.
Integración	Usa el mismo formulario que un webhook: método, dirección, encabezados y parámetros.

Crear una herramienta de tipo webhook#

Abre el panel
En el agente, pestaña Herramientas, haz clic en Añadir herramienta y elige Webhook.
Describe la herramienta
En Configuración completa el Nombre, que es obligatorio, y la Descripción. La descripción es lo que lee el agente para decidir cuándo y cómo usarla, así que explica el caso con claridad.
Indica a dónde llamar
Elige el Método y escribe la URL. Si la dirección lleva un valor variable, escríbelo entre llaves, como en el ejemplo de más abajo.
Agrega los encabezados
En Encabezados usa Añadir encabezado. Para claves de acceso elige el tipo Secreto en lugar de Valor.
Define los parámetros
Completa Parámetros de ruta, Parámetros de consulta y Parámetros del cuerpo según lo que pida el servicio.
Guarda
Haz clic en Guardar. Verás "Herramienta guardada" y la herramienta aparecerá en la tabla con su interruptor activo.

Ejemplo de dirección con un parámetro de ruta:

https://api.ejemplo.cl/pedidos/{numero_pedido}

Al escribirla, numero_pedido aparece solo en Parámetros de ruta para que lo describas.

Campos de configuración#

NombreTextoObligatorio: Identificador de la herramienta.
DescripciónTexto: Cuándo y cómo debe usarla el agente.
MétodoLista: GET, POST, PUT, PATCH o DELETE. El valor inicial es GET.
URLTexto: Dirección del servicio.
Tiempo de espera de respuesta (segundos)Control deslizante: Entre 5 y 120 segundos. El valor inicial es 20.

Parámetros#

Cada parámetro le dice al agente qué dato debe conseguir y cómo.

Campo	Significado
Tipo de datos	String, Number o Boolean. En el cuerpo se suman Integer, Object y Array.
Identificador	Nombre del parámetro tal como lo espera el servicio.
Tipo de valor	LLM Prompt: el agente obtiene el valor de la conversación. Valor fijo: siempre se envía lo que escribas.
Descripción	Explica al agente qué dato es, por ejemplo "Número de pedido que indica el cliente".
Requerido	En las propiedades del cuerpo, marca los datos obligatorios.

Secretos#

Un secreto guarda una clave para usarla en los encabezados sin dejarla a la vista. En un encabezado de tipo Secreto elige Añadir nuevo secreto y completa Nombre y Valor.

Activar, editar y eliminar#

El interruptor de cada fila activa o desactiva la herramienta sin borrarla. El contador muestra cuántas están activas.
Haz clic en una herramienta para editarla.
El ícono de papelera la elimina, previa confirmación con "¿Eliminar esta herramienta?".

Transferir a otro agente#

El botón Herramientas de sistema abre las acciones integradas. La opción Transferir a un agente permite derivar la conversación a otro de tus agentes. Al activarla defines una o más reglas con Añadir regla:

Agente: a quién se transfiere.
Condición: en qué situación, descrita con tus palabras.
Mensaje de transferencia: opcional, lo que se dice al transferir.

Guarda con el aviso "Herramienta de sistema guardada". El resto de las opciones de esa lista aparecen deshabilitadas.

Probar una herramienta#

No hay un botón de prueba individual. Abre la pestaña Vista previa del agente y conversa de modo que el agente necesite la herramienta. Luego revisa la respuesta.

Problemas frecuentes#

"El nombre es requerido"#

Falta el Nombre de la herramienta.

"Nombre y valor son requeridos"#

Al crear un secreto falta uno de los dos campos.

"Descripción y agente son requeridos"#

En una regla de transferencia falta la condición o el agente de destino.

"Guarda el agente primero"#

Intentaste configurar una herramienta de sistema en un agente que aún no está guardado.

El agente no usa la herramienta#

Revisa que esté activa y que su Descripción diga claramente en qué casos corresponde usarla. Una descripción vaga hace que el agente no la considere.