Herramientas de webhook

Las herramientas permiten a tu asistente conectarse a datos y sistemas externos. Puedes definir un conjunto de herramientas a las que el asistente tenga acceso, y este las utilizará cuando corresponda según la conversación.

Resumen

Muchas aplicaciones necesitan que los asistentes llamen a API externas para obtener información en tiempo real. Las herramientas permiten a tu asistente realizar llamadas a funciones externas en aplicaciones de terceros para que puedas obtener información en tiempo real.

Estos son algunos ejemplos en los que las herramientas pueden resultar útiles:

• Obtener datos: permite a un asistente recuperar datos en tiempo real de cualquier base de datos compatible con REST o integración de terceros antes de responder al usuario.
• Realizar acciones: permite a un asistente activar acciones autenticadas según la conversación, como programar reuniones o iniciar devoluciones de pedidos.

Configuración de herramientas

Los agentes de ElevenLabs pueden incorporar herramientas para interactuar con API externas. A diferencia de las solicitudes tradicionales, el asistente genera dinámicamente los parámetros de consulta, cuerpo y ruta según la conversación y las descripciones de parámetros que proporciones.

Todas las configuraciones de herramientas y las descripciones de parámetros ayudan al asistente a determinar cuándo y cómo usar estas herramientas. Para organizar el uso de herramientas de forma eficaz, actualiza el prompt del sistema del asistente para especificar la secuencia y la lógica de estas llamadas. Esto incluye:

• Qué herramienta usar y en qué condiciones.
• Qué parámetros necesita la herramienta para funcionar correctamente.
• Cómo gestionar las respuestas.

Guía

En esta guía, crearemos un asistente meteorológico que pueda proporcionar información meteorológica en tiempo real para cualquier ubicación. El asistente utilizará sus conocimientos geográficos para convertir los nombres de ubicaciones en coordenadas y obtener datos meteorológicos precisos.

You are a helpful conversational agent with access to a weather tool. When users ask about
weather conditions, use the get_weather tool to fetch accurate, real-time data. The tool requires
a latitude and longitude - use your geographic knowledge to convert location names to coordinates
accurately.
Never ask users for coordinates - you must determine these yourself. Always report weather
information conversationally, referring to locations by name only. For weather requests:
1. Extract the location from the user's message
2. Convert the location to coordinates and call get_weather
3. Present the information naturally and helpfully
For non-weather queries, provide friendly assistance within your knowledge boundaries. Always be
concise, accurate, and helpful.
First message: "Hey, how can I help you today?"

Métodos de autenticación compatibles

ElevenLabs Agents admite varios métodos de autenticación para conectar de forma segura tus herramientas con API externas. Los métodos de autenticación se configuran en los ajustes de tu agente y después se conectan a cada herramienta según sea necesario.

Una vez configurados, puedes conectar estos métodos de autenticación a tus herramientas y gestionar encabezados personalizados en la configuración de la herramienta:

Credenciales de cliente OAuth2

Gestiona automáticamente el flujo de credenciales de cliente OAuth2. Configúralo con tu ID de cliente, secreto de cliente y URL de token (por ejemplo, https://api.example.com/oauth/token). Opcionalmente, especifica ámbitos como valores separados por comas y parámetros JSON adicionales. Configúralo haciendo clic en Add Auth en Workspace Auth Connections, dentro de la sección Agent de la página de configuración de tu agente.

JWT de OAuth2

Utiliza autenticación JSON Web Token para el flujo JWT Bearer de OAuth 2.0. Requiere tu secreto de firma JWT, URL de token y algoritmo (predeterminado: HS256). Configura las reclamaciones JWT, como emisor, audiencia y sujeto. Opcionalmente, establece el ID de clave, la expiración (predeterminada: 3600 segundos), ámbitos y parámetros adicionales. Configúralo haciendo clic en Add Auth en Workspace Auth Connections, dentro de la sección Agent de la página de configuración de tu agente.

Autenticación básica

Autenticación sencilla mediante nombre de usuario y contraseña para API compatibles con HTTP Basic Auth. Configúrala haciendo clic en Add Auth en Workspace Auth Connections, dentro de la sección Agent de la página de configuración de tu agente.

Tokens Bearer

Autenticación basada en tokens que añade el valor de tu token bearer al encabezado de la solicitud. Configúrala añadiendo un encabezado a la configuración de la herramienta, seleccionando Secret como tipo de encabezado y haciendo clic en Create New Secret.

Encabezados personalizados

Añade encabezados de autenticación personalizados con cualquier nombre y valor para métodos de autenticación propios. Configúralos añadiendo un encabezado a la configuración de la herramienta y especificando su nombre y valor.

Buenas prácticas

Asigna nombres intuitivos a las herramientas y añade descripciones detalladas

Si el asistente no llama a las herramientas correctas, quizá tengas que actualizar sus nombres y descripciones para que entienda con mayor claridad cuándo debe seleccionar cada herramienta. Evita usar abreviaturas o acrónimos para acortar los nombres de las herramientas y los argumentos.

También puedes incluir descripciones detalladas sobre cuándo debe llamarse a una herramienta. Para herramientas complejas, incluye descripciones de cada argumento para ayudar al asistente a saber qué debe pedir al usuario para obtener ese argumento.

Asigna nombres intuitivos a los parámetros de las herramientas y añade descripciones detalladas

Usa nombres claros y descriptivos para los parámetros de las herramientas. Si procede, especifica en la descripción el formato esperado para un parámetro (por ejemplo, AAAA-mm-dd o dd/mm/aa para una fecha).

Plantéate proporcionar información adicional sobre cómo y cuándo llamar a las herramientas en el prompt del sistema de tu asistente

Proporcionar instrucciones claras en el prompt del sistema puede mejorar significativamente la precisión con la que el asistente llama a las herramientas. Por ejemplo, guía al asistente con instrucciones como las siguientes:

Use `check_order_status` when the user inquires about the status of their order, such as 'Where is my order?' or 'Has my order shipped yet?'.

Proporciona contexto para situaciones complejas. Por ejemplo:

Before scheduling a meeting with `schedule_meeting`, check the user's calendar for availability using check_availability to avoid conflicts.

Selección de LLM

Es importante tener en cuenta que la elección del LLM influye en el éxito de las llamadas a funciones. Algunos LLM pueden tener dificultades para extraer de la conversación los parámetros relevantes.

Sonidos de llamadas a herramientas

Puedes configurar audio ambiente para que se reproduzca durante la ejecución de herramientas y mejorar así la experiencia de usuario. Obtén más información sobre los sonidos de llamadas a herramientas.