• fecha_actual:
  
  • Definición: Proporciona a la IA la fecha y hora actuales para darle contexto temporal. Es una herramienta de uso interno, “es recomendable al momento de decirle que la ejecute, que la utilice de forma interna solamente y que no le envíe la hora ni dia al cliente”.
  • Uso Estratégico: Permite a la IA tomar decisiones basadas en el tiempo, como informar que una sucursal está cerrada o que un pedido se procesará al día siguiente.
• llamar_asesor:
  • Definición: Transfiere la conversación de la IA a un agente humano. Es el protocolo de escalamiento.

Cuándo Usarlo: En escenarios predefinidos como: gestión de clientes enojados, problemas con pagos, solicitudes complejas fuera del alcance de la IA o a petición explícita del cliente o por ejemplo cuando detecte que enviaron un comprobante de pago.

• Definición: Esta herramienta se utiliza para dotar al asistente de información estática que no cambia con frecuencia.
• Casos de Uso: Ideal para políticas de devolución, preguntas frecuentes (FAQs), horarios, direcciones, términos y condiciones, información de envíos y medios de pagos.
• Configuración:
  
  • Nombre de herramienta: Un identificador único (ej: politicas_devolucion).
  •  
  • Utilidad de la integración: Una descripción clara para la IA de cuándo usarla (ej: “Utiliza esta información para responder preguntas sobre cambios y devoluciones”).

Escribir información: El texto exacto que la IA consultará.

• Definición: Conectan al asistente con fuentes de datos dinámicas como tu catálogo de productos, permitiendo consultas en tiempo real sobre productos, stock, precios,link a los productos, etc.
• Concepto Clave (IA Secundaria): Al usar esta herramienta, la IA principal (el Agente) no busca directamente en la base de datos. En su lugar, envía una consulta a una IA secundaria especializada en interpretar el lenguaje natural y traducirlo a búsquedas precisas dentro de la base de datos de tu tienda.
• El Rol del Prompt personalizado para la IA:. Son las instrucciones que le das a esa IA secundaria para que se convierta en una experta buscando en tus datos. Aquí defines en qué columnas debe buscar, cómo debe formatear la respuesta y cómo manejar casos especiales.

• Ejemplo de Prompt Personalizado:
  La consulta del usuario puede ser ambigua o abreviada. Debes buscar coincidencias en las columnas nombre, descripción y  stock. Si el usuario menciona características como talle, color o peso, filtra por la columna variantes. Devuelve siempre como resultado el nombre completo del producto, su precio final, el stock disponible y el link al producto. Si el stock es cero, en lugar del precio informa “No disponible por el momento”. Limita siempre tu búsqueda a un máximo de 5 resultados.

• Definición: Esta herramienta permite que tu IA agende eventos directamente en un calendario de Google “Primero debes crear la integración y conectar tu calendar”.
• Casos de Uso: Reservar turnos, agendar citas de ventas, coordinar demostraciones de software o llamadas técnicas.
• Configuración: Al añadir la herramienta, Escala en la Web IA te pedirá que conectes tu cuenta de Google y selecciones el calendario específico donde se crearán los eventos.
• Funcionamiento: La IA sabe que para crear un evento necesita recolectar información clave del usuario: Fecha, Hora de inicio, Hora de fin y, opcionalmente, descripción e invitados.

Ejemplo de Instrucción para agendar un turno:

Markdown
## Agendamiento de Turnos

Para reservar un turno, utiliza la herramienta `agendar_turno_calendar`. Antes de ejecutarla, DEBES preguntarle y confirmar con el cliente los siguientes datos:

1. Nombre y Apellido del cliente.

2. El día exacto para el turno (formato AAAA-MM-DD).

3. La hora exacta para el turno (formato HH:MM).

4. El mail al cliente para enviar la invitación.

Una vez que tengas todos los datos, crea el evento.

• Definición: Es la herramienta más avanzada, permitiendo conectar al asistente con cualquier servicio externo que exponga una API.
• Casos de Uso: Sistemas de envío de terceros, CRMs propios, pasarelas de pago, consulta de datos en sistemas legados, etc.
• Lógica: Se replica una solicitud de API (que se puede probar previamente en herramientas como Postman) dentro de la interfaz de Escala en la Web IAl.
• Configuración de la Herramienta:
•  
  1. Nombre y Utilidad: Un nombre claro (ej: verificar_estado_envio) y su propósito.
  2. URL del Endpoint: La dirección de la API a consultar (ej: https://api.logistica.com/v1/tracking).
  3. Método HTTP: GET (para obtener información), POST (para enviar/crear información), PUT, DELETE, etc.
  4. Headers: Para enviar metadatos, comúnmente claves de autenticación (ej: { “Authorization”: “Bearer TU_API_KEY” }).
  5. Body (JSON): El cuerpo de la solicitud para métodos como POST, en formato JSON.
  6. Variables de la Petición: Es el componente clave para la interacción. Una variable es un dato que la IA debe solicitar al cliente antes de ejecutar la llamada. Se definen con llaves {}.

• Ejemplo Práctico: Verificar el estado de un envío. La API requiere una solicitud POST a https://api.logistica.com/v1/tracking con un Body como este: { “tracking_number”: “CODIGO_A_CONSULTAR” }.
•  
  1. Configuración en Escala en la Web IA:
     • URL: https://api.logistica.com/v1/tracking
     • Método: POST
     • Body: { “tracking_number”: “{codigo_de_seguimiento}” }
  2. Definición de la Variable:
     • Nombre: codigo_de_seguimiento
     • Tipo: Texto
     • Descripción (Pregunta de la IA): “Para poder ayudarte, por favor, indícame tu código de seguimiento.”
  3. Flujo en la Conversación:
     • Cliente: “Quiero saber dónde está mi pedido”.
     • IA (siguiendo instrucciones): Activa la herramienta verificar_estado_envio.
     • IA (al ver la variable): “¡Claro! Para poder ayudarte, por favor, indícame tu código de seguimiento.”
     • Cliente: “Es ABC1234567”

IA: Ejecuta la llamada a la API con el Body {“tracking_number”: “ABC1234567”} y entrega la respuesta al cliente.