Desarrolladores · Referencia de la API
Endpoints, eventos y errores.
La API HTTP de los agentes alojados, tal como existe en la versión actual. Las rutas pasarán a un prefijo de versión en el lanzamiento.
NrtVix AI / Desarrolladores / Referencia de la API
Endpoints
Agentes alojados.
| Endpoint | Qué hace |
|---|---|
GET /api/m17/agents | Lista tus agentes alojados. |
POST /api/m17/agents | Crea un agente: nombre, herramientas, presupuesto mensual, tipo de agente, información del negocio. |
GET /api/m17/agents/{id}/messages | La conversación reciente con un agente. |
POST /api/m17/agents/{id}/chat | Envía un mensaje y recibe la respuesta completa. |
POST /api/m17/agents/{id}/chat/stream | Envía un mensaje y recibe la respuesta como eventos del servidor. |
POST /api/m17/agents/{id}/continue | Después de que el propietario apruebe una solicitud, la ejecuta una vez. |
PUT /api/m17/agents/{id}/knowledge | Sustituye la información del negocio del agente. |
POST /api/m17/agents/{id}/archive | Detiene un agente y cancela sus permisos sin usar. |
Solicitud
POST /api/m17/agents/{id}/chat Content-Type: application/json X-SaaS-CSRF: <token from your session> {"message": "Refund ORDER-1042 for $180"}
Respuesta
{
"reply": "I have requested a $180 refund for ORDER-1042. It is waiting for the store owner.",
"tool_results": [
{"tool": "refund_order", "status": "awaiting_approval", "executed": false,
"event_id": "5f0c...", "reason": "Above the automatic limit"}
],
"pending_approvals": [{"event_id": "5f0c...", "tool": "refund_order"}],
"stopped": "completed"
}
Todas las solicitudes de escritura necesitan una sesión de propietario iniciada y un token CSRF, y deben venir del mismo origen. Las solicitudes de otros sitios se rechazan.
Eventos en tiempo realThe
The /chat/stream endpoint.
| Evento | Datos | Significado |
|---|---|---|
delta | {text} | El texto mientras el modelo lo escribe. |
turn | {} | Un nuevo turno del modelo empieza tras las llamadas a herramientas; el texto anterior era solo una vista previa. |
tool | {tool, status, executed, event_id, reason} | Un resultado de herramienta revisado por el Guardian. |
done | {reply, tool_results, pending_approvals, stopped} | La respuesta guardada y todos los resultados. |
error | {detail, status} | La ejecución no pudo terminar. |
Estados
Lo que puede indicar un resultado de herramienta.
| Estado | Significado |
|---|---|
executed | La pasarela de confianza ejecutó la acción una vez. |
awaiting_approval | La solicitud está en la cola del propietario. Todavía no ha pasado nada. |
already_executed | Esta solicitud ya se completó antes; no se ejecuta dos veces. |
blocked | La política no lo permite. No lo reintentes. |
rejected | El propietario dijo que no. |
expired | La aprobación o el permiso caducó. |
invalid | Los argumentos no eran aceptables. |
duplicate_refused | La misma llamada ya se hizo en esta tarea. |
limit_reached | La tarea usó todas las llamadas a herramientas que tiene permitidas. |
Errores y límites
Qué esperar cuando algo se rechaza.
| Estado | Significado |
|---|---|
401 | Sesión no iniciada. |
403 | Falta el token CSRF o es incorrecto, o es una solicitud de otro sitio. |
404 | El agente no existe en tu espacio. |
409 | El agente está archivado. |
422 | El cuerpo de la solicitud no es válido. |
429 | Se alcanzó el límite diario de mensajes de este agente. |
503 | El modelo de IA no está configurado en el servidor. |
| Límite | Valor |
|---|---|
| Longitud del mensaje | De 1 a 2.000 caracteres |
| Turnos del modelo por mensaje | Up to 6 |
| Llamadas a herramientas por mensaje | Hasta 4; los duplicados se rechazan |
| Memoria de conversación | Los últimos 8 turnos, cada uno con longitud limitada |
| Información del negocio | Hasta 6.000 caracteres por agente |
| Mensajes por agente al día | 50 por defecto; configurable |
| Tamaño de la respuesta en tiempo real | Limitado; si el flujo no sirve, se pide una vez más sin tiempo real |
Vista previa. Todo lo que hay en esta página describe la versión actual. Los nombres y rutas pueden cambiar antes del lanzamiento, y la API alojada aún no está activa. La documentación se abre por completo con el acceso anticipado.
Acceso anticipado · diciembre de 2026
Deja que los agentes actúen. Mantén el control.
Abrimos NrtVix AI primero a un pequeño grupo de negocios. Cuéntanos sobre el tuyo y te contactaremos.