Herramientas API

Crea, prueba y conecta herramientas HTTP personalizadas al asistente.

Que se logra

Resultado: el asistente puede consultar o enviar datos a un sistema externo mediante una operación HTTP definida y probada por la organización.
Caso de uso: un distribuidor conecta su inventario para que el asistente confirme disponibilidad antes de responder a un comprador.
Se combina con: Herramientas internas y Servidores MCP, para cubrir datos del CRM y sistemas externos.

Donde esta

Ruta: /[orgId]/ai-assistant
Acceso en UI: AI Assistant
Componente(s): ApiToolsGallery.tsx

Como funciona

En Tools > API, crea o selecciona una herramienta.
Define Name, Description, endpoint, método GET o POST, esquema de parámetros y, según corresponda, parámetros URL, cuerpo, headers y ejemplo de respuesta.
Usa la prueba de la galería antes de asociarla al asistente y describe cuándo debe utilizarse.
Guarda la asociación con Update Assistant.

Campos y opciones

Campo	Tipo	Obligatorio	Notas
nombre, endpoint y método	texto / lista	Si	Método GET o POST.
esquema de parámetros	editor	Si	Define datos de entrada.
URL, cuerpo, headers, respuesta	configuración	No	Ajustan la petición y prueba.

Reglas y validaciones

Una herramienta asociada puede aportar descripción, condición de uso y configuración por asistente.

Backend

Servicios: api-tools (find/create/patch/remove), api-tool-testing-proxy (create), ai-assistants (patch) y respuestas IA.

Relaciones

Requiere: endpoint HTTP disponible.
Dispara / afecta: llamadas externas solicitadas por el asistente.

Notas

Por confirmar: restricciones de red y tiempo de espera del proxy de pruebas.