Cabi.Chat Ignite — herramientas, endpoints y secretos
Un oráculo actúa solo a través de las herramientas que le concedes. Hablar es una herramienta entre muchas: enviar un mensaje, reservar una cita, consultar un pedido o crear un lead en tu CRM son llamadas que hace el oráculo. Cabi.Chat Ignite decide cuándo llamar; tu agenda decide qué se puede llamar. link Cabi.Chat Ignite — Agendas
Herramientas base. Todo oráculo las recibe de la plataforma:
- send — responder en su superficie: cuenta de Telegram, bot o widget;
- pasar a una persona — marcar la conversación para ti, con el motivo Cabi.Chat Inbox — Traspaso a una persona;
- terminar la conversación — dejar de responder a alguien a quien no se debe responder;
- look — ver una foto enviada en la conversación y preguntar a un modelo de visión qué muestra, de nuevo con otra pregunta si hace falta;
- temporizador — volver a la conversación más tarde, una vez o de forma periódica;
- notas — escribir y borrar las notas breves sobre la persona link;
- historial — retroceder a mensajes anteriores de la conversación.
Endpoints. Todo lo demás es una tarjeta de endpoint de API: un método, una ruta, un dominio, un nombre de operación, una descripción y los esquemas de petición y respuesta. El oráculo solo puede llamar a los endpoints listados en su agenda. Los busca con palabras normales, lee el esquema completo del que necesita y lo llama. Un workspace de endpoints funciona como caja de herramientas: su descripción le dice al oráculo para qué sirve el conjunto.
Secretos. Las claves son tarjetas secret. Un secreto tiene un nombre (secret_ seguido de letras minúsculas, dígitos y guiones bajos), un valor y el host al que pertenece.
- El valor es de solo escritura: nunca se vuelve a mostrar, la API nunca lo devuelve y el modelo nunca lo ve. Para rotarlo, elimina el secreto y crea uno nuevo.
- Una clave solo se envía al host al que está vinculada.
- Un secreto debe estar en un workspace. Inclúyelo en la agenda y la plataforma lo inyecta en las llamadas en el momento de hacerlas.
- Elimina un secreto y cada agenda que lo usaba se recarga al instante.
Cuando una llamada falla. Cada llamada tiene un límite de tiempo. Un host que no responde se omite durante el resto del turno, y la respuesta aún puede enviarse. Un envío cuya entrega es desconocida nunca se repite: el oráculo está hecho para evitar mensajes duplicados.