Crear una herramienta
Una herramienta personalizada conecta un agente con un sistema propio de su organización: una API interna, un servicio ya existente o cualquier operación que su empresa necesita ejecutar como parte de una conversación.
Nombrar y describir la herramienta
Abra Herramientas en Kivox Studio y cree una nueva herramienta. Use un nombre breve y específico, como consultar_pedido, en lugar de uno genérico como operacion.
La descripción debe responder dos preguntas: qué hace la herramienta y cuándo debería usarse.
Definir los parámetros de entrada
Describa cada parámetro que la operación necesita.
Si una operación necesita varios valores, cada uno debe tener un significado inequívoco para que el agente sepa qué información solicitar al usuario.
Configurar la ejecución
Una herramienta HTTP necesita el método, la URL y, cuando corresponde, encabezados y cuerpo de la solicitud.
Los métodos disponibles son GET, POST, PUT, PATCH y DELETE. Cuando la operación requiere una integración más compleja, la herramienta puede asociarse con un conector, descrito en Conectores.
Conectar la herramienta a un agente
Crear una herramienta no le da acceso automático a ningún agente. Conéctela desde la configuración del agente que la necesita, como se describe en Conectar conocimiento y herramientas.
Probar la herramienta
Pruébela desde una conversación con el agente antes de usarla con usuarios reales. Comience con un caso conocido:
Confirme que la herramienta recibe el identificador correcto y devuelve un resultado válido. Después pruebe un caso con información incompleta:
El agente debería pedir el identificador antes de intentar ejecutar la operación.
Cuando una herramienta falla
Una herramienta puede fallar porque el sistema externo no está disponible, porque los parámetros son incorrectos o porque la operación no está permitida. El agente debe poder comunicar el resultado con claridad, sin presentar una acción como exitosa cuando la herramienta no la confirmó.