4 min de lectura
Custom Tools: permita que Max y sus agentes llamen a las API que ya utiliza
Creá Custom Tools Frontline desde un API. Argumentos, encabezados, pruebas y cómo Max escribe una herramienta a partir de la documentación.
Una Custom Tool es una llamada API que posee su cuenta. Usted lo nombra, describe cuándo usarlo, lo apunta a un punto final y decide qué argumentos completa el modelo. Luego lo asigna a Max, a un agente, a un Playbook o a una tarea.
Frontline ya se comunica con su CRM y con las integraciones conectadas. Una Custom Tool es la puerta a todo lo demás. El sistema de cartera de Harrington. El custodio. El portal de facturación. Un proveedor de KYC. Si tiene un HTTP API, puede ser una herramienta.
La descripción es la parte que lee el modelo cuando decide llamar a la herramienta. "Obtenga el estado de cuenta más reciente PDF para un hogar por número de cuenta" se utilizará en las preguntas sobre estados de cuenta. El “punto final 4b Internal” no se utilizará. Escriba la descripción de la misma manera que informaría a un nuevo empleado.
¿Qué incluye una Custom Tool?
Comience con la solicitud.
Método y URL. OBTENER, PUBLICAR, PONER, PARCHEAR o ELIMINAR. La URL puede incluir marcadores de posición, como una ruta que lleve a {accountNumber}.
Los argumentos son las entradas que proporciona el modelo en tiempo de ejecución. Cada uno tiene un nombre, una descripción, un tipo (texto, número o verdadero/falso), si es obligatorio y un valor predeterminado opcional. El nombre que declara es el nombre que coloca en la URL, los encabezados, la cadena de consulta o el cuerpo como {accountNumber}.
Los encabezados llevan autenticación y tipo de contenido. Un token de portador, una clave API, Tipo de contenido: aplicación/json.
Los parámetros de consulta son los extras de un GET. Incluir objetos relacionados. Filtrar por fecha.
El cuerpo es el JSON para POST, PUT y PATCH. Los mismos marcadores de posición. {householdName} en la carrocería pasa a ser el valor elegido por el modelo.
Puede probar una herramienta con valores reales antes de que alguien la use. La prueba devuelve el estado, cuánto tiempo tardó y la respuesta. Ese es el momento en que encuentras un encabezado incorrecto o una ruta que todavía tiene un marcador de posición.
Las herramientas pueden estar activas o pausadas. Pausar uno cuando el proveedor esté en mantenimiento. Vuelva a activarlo cuando el punto final esté en buen estado.
¿Dónde se utilizan las Custom Tools?
En cualquier lugar donde se permita actuar a un modelo.
En un agente, la herramienta está en el conjunto de herramientas del agente. El calificador WhatsApp puede verificar si James ya tiene un hogar en el sistema de cartera antes de crear un acuerdo.
En Max, la herramienta está disponible en el chat y en el trabajo que Max hace por usted. “Retirar el estado de cuenta del mes pasado para la familia Harrington” se convierte en una herramienta y luego en una respuesta.
En el manual de un agente, la herramienta tiene como alcance ese procedimiento. El manual "Enviar estado de cuenta" puede llamar al portal. El manual del “mandato de calificación” nunca lo ve.
En una Task de Max, la misma idea. Una revisión de la cartera el lunes puede llamar a la cartera API para AUM antes de redactar el informe.
¿Cómo escribe Max una Custom Tool a partir de documentos API?
Esta es una de las formas más rápidas de poner una herramienta en producción.
Pegá la documentación del proveedor en Max o apúntelo a la URL de documentos públicos. Di lo que quieras en un lenguaje sencillo. "Cree una herramienta que obtenga el estado de cuenta más reciente de un hogar. Los documentos están aquí. La autenticación es un token al portador. Necesito el número de cuenta como entrada".
Max lee la ruta, el método, los argumentos y los encabezados y luego crea la herramienta. Lo prueba con un número de cuenta conocido de Harrington. Si la respuesta parece correcta, asígnela a Max, al agente o al Playbook que debería poseerla.
Un agente codificador en el CLI puede realizar el mismo ciclo. Cree la herramienta, pruébela con valores, lea la respuesta, arregle el cuerpo o el encabezado, vuelva a probar. El CLI es útil cuando la definición debe estar en un repositorio junto al resto de la configuración de la cuenta.
¿Cómo es una buena primera herramienta?
Mantenga el primero en un solo trabajo.
La primera Custom Tool de Harrington es "Obtener una instantánea del hogar". GET, número de cuenta en la ruta, token de portador en el encabezado, descripción que dice que devuelve AUM, custodio y fecha del último extracto. Pruébelo en la cuenta de James. Asígnalo a Max y al agente calificado.
La segunda herramienta puede crear un ticket de servicio en el sistema de operaciones cuando comienza la incorporación. POST, nombre familiar y tamaño del mandato en el cuerpo. Incluya eso en el manual de incorporación, no en todos los agentes.
Nombra la herramienta para el resultado. Describe los argumentos de la forma en que una persona los pediría. Luego deja que el modelo los complete.