Las Herramientas (Tools) del Capitán son acciones que el asistente de inteligencia artificial de Papo (https://papo.global/) puede ejecutar para automatizar tareas e interactuar con otros sistemas. Permiten que la IA vaya más allá de solo responder preguntas, pudiendo realizar acciones prácticas como agendar reuniones, consultar el estado de un pedido en un sistema externo o crear un nuevo negocio en tu CRM, todo directamente desde la conversación con el cliente.
Con las Herramientas, transformas tu asistente Capitán de un informante pasivo en un agente proactivo. Puede entender la intención del cliente y usar una herramienta específica para resolver la solicitud al instante, sin necesidad de intervención humana. Esto abre un abanico de posibilidades para automatizaciones complejas y eficientes.
| Tipo de Herramienta | Descripción | Ejemplo de Uso | Conocimiento Técnico |
|---|---|---|---|
| Nativa | Integraciones preconfiguradas y listas para usar, disponibles en la plataforma Papo. | Agendar una demostración en Google Calendar de un vendedor. | Bajo (solo activar y conectar la cuenta). |
| Personalizada (HTTP) | Acciones personalizadas que se conectan a sistemas externos (ERPs, CRMs) o a la propia API de Papo. | Consultar el estado de un pedido en el sistema de e-commerce de la empresa. | Avanzado (requiere conocimiento de APIs y solicitudes HTTP). |
¿Cómo Funcionan las Herramientas del Capitán?
El proceso de funcionamiento de una Herramienta (Tool) es un ciclo inteligente que conecta la conversación del cliente con una acción concreta:
- Interpretación de la Intención: El cliente envía un mensaje como "Me gustaría saber dónde está mi pedido 12345" o "Quiero programar una reunión con un consultor".
- Selección de la Herramienta: El Capitán analiza el mensaje y, basándose en las instrucciones y descripciones de las herramientas que has configurado, identifica cuál de ellas es la más adecuada para resolver la solicitud.
- Ejecución de la Acción: La IA activa la herramienta seleccionada. Si es una herramienta para consultar un pedido, enviará el número "12345" a tu sistema externo. Si es para agendar, consultará los horarios disponibles en la agenda.
- Retorno de la Respuesta: El sistema externo o la herramienta nativa devuelve un resultado (ej: "Pedido en transporte" u "Horarios disponibles: 14h y 15h").
- Comunicación al Cliente: El Capitán usa esta información para formular una respuesta natural y completa para el cliente, finalizando la solicitud de forma autónoma.
Este flujo transforma la atención al cliente, permitiendo que la IA resuelva problemas de principio a fin, y no solo proporcione información básica.
Tipos de Herramientas: Nativas vs. Personalizadas
Puedes equipar tu asistente Capitán con dos tipos de herramientas, cada una con un propósito diferente.
Herramientas Nativas
Son integraciones listas para usar, desarrolladas y mantenidas por Papo. El objetivo es simplificar la conexión con servicios populares sin que tengas que preocuparte por los detalles técnicos.
El principal ejemplo es la integración con Google Calendar. Al activarla, permites que el Capitán:
- Verifique la disponibilidad en tiempo real en la agenda de uno o más miembros del equipo.
- Ofrezca los horarios disponibles al cliente durante la conversación.
- Cree el evento automáticamente en la agenda tan pronto como el cliente confirme el horario deseado.
La configuración generalmente implica solo autorizar a Papo a acceder a tu cuenta en el servicio externo y activar la herramienta para tu asistente.
Herramientas Personalizadas (HTTP)
Las herramientas personalizadas ofrecen flexibilidad total, permitiendo que el Capitán se comunique con prácticamente cualquier sistema que posea una API (Application Programming Interface). Esto incluye tu ERP, CRM, plataforma de e-commerce o incluso otros módulos de la propia Papo.
Para configurar una herramienta personalizada, debes proporcionar los detalles de la solicitud HTTP que la IA debe realizar:
- URL del Endpoint: La dirección de la API que se llamará (ej:
https://api.meusistema.com/v1/pedidos). - Método HTTP: La acción a realizar (GET para buscar datos, POST para crear, PUT para actualizar, etc.).
- Headers (Cabeceras): Información adicional, como claves de autenticación (
Authorization: Bearer sk_sua_chave_secreta) para garantizar que la solicitud sea segura y autorizada. - Body (Cuerpo de la Solicitud): Los datos a enviar, generalmente en formato JSON. Puedes usar variables de la conversación para hacer la acción dinámica (ej:
{"id_pedido": "{variable_numero_pedido}"}).
Con esto, puedes crear automatizaciones como "consultar saldo de puntos de fidelidad", "crear un lead en el CRM de Papo" o "abrir un ticket de soporte en tu sistema interno".
Paso a Paso: Cómo Configurar una Herramienta en el Capitán
Aunque los nombres exactos de los menús pueden variar, el proceso conceptual para habilitar una herramienta para tu asistente sigue una lógica clara:
- Accede a la Configuración del Asistente: En el panel de Papo, navega hasta el área de configuración del Capitán que deseas mejorar.
- Localiza la Sección de Herramientas: Dentro de las opciones de configuración del asistente, encuentra el área dedicada a las "Herramientas" (Tools).
- Añade una Nueva Herramienta: Elige entre añadir una herramienta "Nativa" o "Personalizada (HTTP)".
- Para Herramientas Nativas: Selecciona el servicio deseado (como Google Calendar) en la lista de integraciones disponibles. Sigue las instrucciones en pantalla para conectar y autorizar tu cuenta.
- Para Herramientas Personalizadas:
- Asigna un Nombre y Descripción: Crea un nombre claro (ej: "Consultar Estado del Pedido") y una descripción detallada para la IA. La descripción es crucial, ya que enseña al Capitán cuándo y cómo usar la herramienta (ej: "Usa esta herramienta para verificar el estado de un pedido de un cliente cuando este proporcione el número del pedido").
- Configura la Solicitud HTTP: Rellena los campos de URL del endpoint, método HTTP, cabeceras (para autenticación) y el cuerpo de la solicitud, si es necesario.
- Activa y Prueba: Después de la configuración, activa la herramienta para que el Capitán pueda empezar a usarla. Realiza pruebas enviando mensajes que deberían activar la nueva herramienta para asegurar que todo funciona como se espera.
Preguntas Frecuentes (FAQ)
¿Cuál es la diferencia entre Herramientas (Tools) y Escenarios?
Las Herramientas (Tools) están diseñadas para ejecutar acciones en sistemas externos u otras partes de la API de Papo, como consultar una base de datos o agendar un evento. Los Escenarios, por otro lado, son instrucciones para que el Capitán ejecute una acción interna en la plataforma, como transferir la conversación a un agente humano (desborde) en situaciones específicas.
¿Necesito saber programar para usar las Herramientas?
Para las Herramientas Nativas, como la integración con Google Calendar, no es necesario conocimiento de programación. La configuración se realiza a través de una interfaz sencilla. Para las Herramientas Personalizadas (HTTP), es necesario tener conocimiento técnico sobre cómo funcionan las APIs, incluyendo métodos HTTP, autenticación y formato JSON.
¿Cómo sabe la IA qué Herramienta usar?
La IA decide qué herramienta usar basándose en la descripción que proporcionas al configurarla. Una descripción clara y detallada, que explique el propósito de la herramienta y qué información necesita, es fundamental. El Capitán analiza la intención del cliente y la compara con las descripciones de todas las herramientas disponibles para elegir la más adecuada.
¿Puedo usar las Herramientas para interactuar con la propia API de Papo?
Sí. Puedes configurar una Herramienta Personalizada (HTTP) para realizar llamadas a la API de Papo. Esto permite crear automatizaciones avanzadas, como usar la IA para crear un nuevo contacto en el CRM, enviar un mensaje por otro canal o actualizar un atributo de un cliente, todo a partir de una instrucción en la conversación.
¿Es seguro usar Herramientas Personalizadas con mis claves de API?
Sí. La información de autenticación, como las claves de API (tokens), se almacena de forma segura en la plataforma Papo y se utiliza en comunicaciones de servidor a servidor, que son más seguras. Es una buena práctica de seguridad crear claves de API con permisos limitados específicamente para esa integración, en lugar de usar claves con acceso total.
Lee también
- ¿Qué son los Escenarios y cómo usarlos para entrenar la IA del Capitán?
- Cómo generar y usar claves de API para integrar con otros sistemas
Empieza gratis y automatiza tus tareas →
El primer usuario es gratis y ya puedes empezar a configurar tu IA para ejecutar acciones reales.