IAToolkit
EN | ES
Superficie de integración

La API para integrar sistemas corporativos con IAToolkit.

Si MCP es la superficie de acceso para clientes AI, la API es la superficie de integración para tus sistemas, portales y workflows. Dispara agentes, pasa contexto estructurado y recupera resultados desde tus propios flujos.

  • Usa una puerta pública clara para ejecución, polling y review.
  • Mantén identidad de negocio, auditoría y trazabilidad por usuario.
  • Conecta portales, backoffice, CRMs, ERPs y automatizaciones internas.
Ver plataforma Hablar sobre tu integración
Contrato público

La superficie de integración para sistemas reales.

Un único contrato para ejecutar, consultar estado y revisar resultados desde sistemas corporativos.

Endpoints 
POST /<company>/api/invocations
GET  /<company>/api/invocations/<id>
PUT  /<company>/api/invocations/<id>/review

Usa `POST` para iniciar la ejecución, `GET` para polling y `PUT` para review cuando el flujo lo requiera.

Payload 
{
  "agent_name": "ventas_2025",
  "user_identifier": "analyst@acme.com",
  "delivery_mode": "async",
  "client_data": { ... },
  "files": [ ... ]
}

La API admite `agent_name`, `user_identifier`, `client_data`, adjuntos y opciones de ejecución en el mismo request.

Ejemplo de llamada 
curl -X POST "https://app.iatoolkit.com/acme/api/invocations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "agent_name": "analista_comercial",
    "user_identifier": "maria@acme.com",
    "delivery_mode": "async",
    "client_data": {
      "company_id": "acme_iberia",
      "account_id": "acc_2048",
      "workflow": "pipeline_comercial_diario",
      "requested_report": "resumen_oportunidades",
      "filters": {
        "stage": ["proposal", "negotiation"],
        "owner_region": "espana"
      }
    }
  }'

El sistema invoca un agente gestionado por IAToolkit y recibe un resultado inmediato o un `invocation_id` para seguir el flujo.

Operación asíncrona

Ejecuta agentes en segundo plano y sigue cada corrida desde la GUI.

La API no solo dispara ejecuciones. También habilita colas, procesamiento asíncrono y monitoreo operativo sobre agentes que trabajan fuera del request interactivo.

Cola de solicitudes

Los sistemas envían trabajo a ejecutar

inv_10428 analista_comercial · pending
inv_10429 agente_cobranzas · running
inv_10430 clasificador_docs · queued
POST /api/invocations
Workers / Agentes
Estado + resultado
Monitoreo en consola

La GUI centraliza estado, errores y trazabilidad

Monitoring
Running12
Queue34
Errors2
inv_10418 completed inv_10429 processing inv_10397 review required
La API encola y dispara

Un sistema corporativo puede iniciar trabajo intensivo sin esperar la respuesta final en la misma transacción.

`invocation_id` como hilo operativo

El identificador permite polling, callbacks, review y trazabilidad sobre cada ejecución asíncrona.

La consola da visibilidad

Operación y soporte revisan estado, errores, actividad y resultados desde una superficie unificada.

Siguiente paso

Si ya tienes un sistema que necesita IA operable, esta es la superficie correcta.

Revisamos tu flujo y definimos si conviene API, MCP, consola o una combinación de las tres.

Ver plataforma Solicitar demo