Herramientas, conectores y conocimiento de IA
Estas páginas dan a los agentes de IA cosas que saber y cosas que hacer. Todos son ajustes de la empresa; cada cambio queda en la auditoría. Los secretos que escribe (tokens, secretos de cliente) se guardan sellados y nunca vuelven a mostrarse.
| Página | Ruta en el menú | Permiso para verla | Permiso para cambiarla |
|---|---|---|---|
| Herramientas de IA | Administración > Herramientas de IA (/admin/ai-tools) | settings:read | settings:write |
| Conectores de IA | Administración > Conectores de IA (/admin/ai-connectors) | settings:read | settings:write |
| Catálogo de productos | Administración > Catálogo de productos (/admin/ai-catalogue) | settings:read | settings:write |
| Base de conocimiento | Administración > Base de conocimiento (/admin/ai-knowledge) | settings:read | settings:write |
| Acceso MCP | Administración > Acceso MCP (/admin/mcp-access) | api_keys:read, api_keys:write o settings:read | settings:write para las reglas de clientes nuevos, api_keys:write para revocar |
Herramientas de IA
Una herramienta es un servicio web que el agente puede llamar durante una llamada (reservar una mesa, abrir un ticket). Usted la describe; no hace falta código.
- Abra Administración > Herramientas de IA y elija Añadir herramienta.
- Fije el nombre (de 3 a 48 letras minúsculas, dígitos o guiones bajos, que empiece con letra) y la descripción para el modelo (de 1 a 500 caracteres: con ella el agente decide cuándo usar la herramienta).
- Fije la URL (una dirección
httpssin usuario ni contraseña), el método, los parámetros como un objeto JSON con a lo más 12 propiedades y, opcionalmente, el nombre del encabezado de autenticación, el prefijo del valor y el secreto. - Fije los límites: llamadas por minuto (1 a 600) y tiempo de espera (500 a 15,000 ms). Agregue los argumentos que se ocultan en la auditoría.
- Deje activada la opción La persona que llama debe decir sí antes de usar la herramienta salvo que la herramienta sea inofensiva. El agente entonces lee la acción en voz alta y espera un sí hablado.
- Guarde. Puede haber hasta 50 herramientas.
Para dar una herramienta a un agente, use Herramientas por agente en la misma página: elija qué herramientas puede llamar un agente (hasta 12 cada uno). Una herramienta desactivada sigue asignada pero no se ofrece.
Cada llamada, incluidos los rechazos y las pruebas, queda registrada. Llamadas muestra las últimas 100 con resultado, estado, duración y argumentos ocultos. En las consolas de prueba del agente una herramienta nunca se llama; la consola muestra la solicitud que enviaría.
La URL se revisa al guardarla y en cada llamada: las direcciones privadas e internas se rechazan salvo que estén en la lista de hosts privados de abajo (o que el operador las haya permitido para la instalación).
Hosts privados
Si una herramienta debe llamar a un host dentro de su red, el propietario de la empresa puede incluirlo en Hosts privados: un nombre o dirección por línea, con puerto opcional, hasta 20. Esto requiere el permiso exclusivo del propietario ai_tools:private_hosts, y la lista tiene efecto solo si el operador activó las listas por empresa en la instalación (la página lo indica cuando no es así). Los metadatos de la nube, las direcciones multicast y las credenciales en la URL siguen bloqueados.
Ofrecer una herramienta a clientes MCP
De forma predeterminada una herramienta es solo para el agente de voz. El propietario puede marcar Ofrecer esta herramienta a clientes MCP (solo propietario) (requiere ai_tools:private_hosts). Entonces un cliente MCP con ai_tools:invoke puede listar y llamar esa herramienta. La llamada pasa las mismas comprobaciones que una llamada de voz: verificación de argumentos, confirmación, límite de frecuencia, revisión de la dirección y registro en la auditoría. Si la herramienta requiere confirmación, la primera llamada devuelve el texto a confirmar y no envía nada; el cliente repite la llamada con confirmed: true cuando el usuario acepta.
Conectores de IA
Administración > Conectores de IA tiene dos partes.
Calendario
Una conexión por empresa, Google Calendar o Microsoft 365, para que los agentes encuentren horarios libres, agenden, reprogramen y cancelen.
- Elija el proveedor y escriba el id del calendario, la zona horaria, el horario de trabajo, la duración del espacio (5 a 480 minutos), el aviso mínimo y con cuántos días de anticipación pueden agendar los agentes (1 a 365).
- Escriba el id de cliente y el secreto de cliente de su propia aplicación OAuth (y el tenant de Microsoft para Microsoft 365) y un refresh token obtenido para la cuenta del calendario. La consola no tiene botón de inicio de sesión: usted aporta el refresh token.
- Guarde y luego Probar conexión. La prueba renueva el token y lee la ocupación de las próximas 24 horas; no escribe nada en el calendario.
Los agentes agendan solo dentro del horario de trabajo y solo pueden cambiar o cancelar lo que ellos agendaron. Si el proveedor revoca el acceso, el estado lo indica; guarde un nuevo refresh token para reactivarla. Desconectar quita la conexión y sus referencias de reservas; los eventos permanecen en el calendario, pero los agentes ya no pueden cambiarlos ni ofrecer citas.
Herramientas de negocio
Active solo lo que necesite; todo está desactivado hasta que lo haga. Puede limitar cada grupo a los agentes que indique.
| Grupo | Qué puede hacer el agente |
|---|---|
| CRM | Buscar y crear clientes potenciales y notas, mediante su integración de CRM |
| Correo | Enviar correo, mediante su proveedor de correo; límite por día |
| Catálogo | Buscar en el catálogo de productos |
| Confirmaciones | Enviar confirmaciones por SMS o WhatsApp, mediante el servicio de SMS con sus exclusiones; límites por día y por persona y día |
Las escrituras de los agentes requieren que quien llama confirme la lectura y el consentimiento del destinatario.
Catálogo de productos
Administración > Catálogo de productos contiene los productos que los agentes buscan con la herramienta de catálogo.
- Elija Importar y la fuente: texto CSV o una hoja de Google (id de la hoja y rango; un token de acceso solo para esa importación, nunca se guarda, y ninguno para una hoja pública).
- La fila de encabezado necesita
name(obligatorio) y puede tenerprice,stock,descriptionybranch. - Opcionalmente marque Reemplazar el catálogo; se aplica solo cuando el archivo no tiene errores.
- El resultado muestra cuántos elementos se crearon, actualizaron, omitieron y quitaron, y lista cada fila rechazada por línea y campo.
Use Buscar para probar y Vaciar catálogo para quitarlo todo.
Base de conocimiento
Administración > Base de conocimiento contiene los documentos que los agentes citan. Asocie fuentes a un agente en el editor del agente.
- Elija Añadir una fuente y el tipo: archivo PDF, archivo DOCX, página web, texto o preguntas frecuentes (un par "pregunta | respuesta" por línea, a lo más 500).
- Una página web se descarga una sola vez, ahora, solo por
https(sin direcciones privadas ni redirecciones). Para actualizarla, elija Reindexar. - Prueba de búsqueda muestra los mejores pasajes con su cita (título de la fuente, dirección y número de pasaje).
Límites por empresa: 200 fuentes, 100 MiB en total y 5 MiB por documento. Más allá, la PBX responde con un error de cuota.
Acceso MCP
Administración > Acceso MCP lista los asistentes de IA (clientes MCP) que las personas de su empresa autorizaron para actuar en su nombre: cliente, usuario, acceso, cuándo se autorizó y último uso. Revocar detiene al asistente para ese usuario de inmediato.
En Clientes nuevos, Permitir que los clientes MCP se registren solos controla el autorregistro, y Hosts de redirección permitidos (un nombre de host por línea; vacío significa cualquier host) limita a dónde pueden redirigir. Los clientes ya registrados siguen funcionando.