Entwickler · API-Referenz
Endpunkte, Ereignisse und Fehler.
Die HTTP-API hinter gehosteten Agenten, wie sie in der aktuellen Version existiert. Pfade werden zum Start unter ein Versionspräfix verschoben.
NrtVix AI / Entwickler / API-Referenz
Endpunkte
Gehostete Agenten.
| Endpunkt | Was sie tut |
|---|---|
GET /api/m17/agents | Ihre gehosteten Agenten auflisten. |
POST /api/m17/agents | Einen Agenten erstellen: Name, Tools, Monatsbudget, Agententyp, Unternehmensinformationen. |
GET /api/m17/agents/{id}/messages | Das jüngste Gespräch mit einem Agenten. |
POST /api/m17/agents/{id}/chat | Nachricht senden und die vollständige Antwort erhalten. |
POST /api/m17/agents/{id}/chat/stream | Nachricht senden und die Antwort als Server-Sent Events erhalten. |
POST /api/m17/agents/{id}/continue | Nach der Freigabe durch den Inhaber eine Anfrage einmal ausführen. |
PUT /api/m17/agents/{id}/knowledge | Die Unternehmensinformationen des Agenten ersetzen. |
POST /api/m17/agents/{id}/archive | Einen Agenten stoppen und seine ungenutzten Berechtigungen stornieren. |
Anfrage
POST /api/m17/agents/{id}/chat Content-Type: application/json X-SaaS-CSRF: <token from your session> {"message": "Refund ORDER-1042 for $180"}
Antwort
{
"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"
}
Alle schreibenden Anfragen brauchen eine angemeldete Inhabersitzung und ein CSRF-Token und müssen vom selben Ursprung kommen. Anfragen von anderen Websites werden abgelehnt.
Streaming-EreignisseThe
The /chat/stream endpoint.
| Ereignis | Daten | Bedeutung |
|---|---|---|
delta | {text} | Text, während das Modell ihn schreibt. |
turn | {} | Nach Tool-Aufrufen beginnt eine neue Modellrunde; zuvor gestreamter Text war nur eine Vorschau. |
tool | {tool, status, executed, event_id, reason} | Ein vom Guardian geprüftes Tool-Ergebnis. |
done | {reply, tool_results, pending_approvals, stopped} | Die gespeicherte Antwort und alle Ergebnisse. |
error | {detail, status} | Der Lauf konnte nicht beendet werden. |
Status
Was ein Tool-Ergebnis aussagen kann.
| Status | Bedeutung |
|---|---|
executed | Das vertrauenswürdige Gateway hat die Aktion einmal ausgeführt. |
awaiting_approval | Die Anfrage liegt in der Liste des Inhabers. Noch ist nichts passiert. |
already_executed | Diese Anfrage wurde bereits abgeschlossen; sie läuft nicht zweimal. |
blocked | Die Richtlinie erlaubt es nicht. Nicht erneut versuchen. |
rejected | Der Inhaber hat abgelehnt. |
expired | Die Freigabe oder Berechtigung ist abgelaufen. |
invalid | Die Argumente waren nicht zulässig. |
duplicate_refused | Derselbe Aufruf wurde in dieser Aufgabe bereits gemacht. |
limit_reached | Die Aufgabe hat alle erlaubten Tool-Aufrufe verbraucht. |
Fehler und Limits
Was Sie erwartet, wenn etwas abgelehnt wird.
| Status | Bedeutung |
|---|---|
401 | Nicht angemeldet. |
403 | CSRF-Token fehlt oder ist falsch, oder es ist eine seitenfremde Anfrage. |
404 | Der Agent existiert in Ihrem Arbeitsbereich nicht. |
409 | Der Agent ist archiviert. |
422 | Der Anfrageinhalt ist ungültig. |
429 | Das Tageslimit an Nachrichten für diesen Agenten ist erreicht. |
503 | Das KI-Modell ist auf dem Server nicht konfiguriert. |
| Limit | Wert |
|---|---|
| Nachrichtenlänge | 1 bis 2.000 Zeichen |
| Modellrunden pro Nachricht | Up to 6 |
| Tool-Aufrufe pro Nachricht | Bis zu 4; Duplikate werden abgelehnt |
| Gesprächsgedächtnis | Die letzten 8 Runden, jeweils in der Länge begrenzt |
| Unternehmensinformationen | Bis zu 6.000 Zeichen pro Agent |
| Nachrichten pro Agent und Tag | Standardmäßig 50; konfigurierbar |
| Größe der gestreamten Antwort | Begrenzt; ein unbrauchbarer Stream wird einmal ohne Streaming wiederholt |
Vorschau. Alles auf dieser Seite beschreibt die aktuelle Version. Namen und Pfade können sich vor dem Release ändern, und die gehostete API ist noch nicht live. Die Dokumentation öffnet vollständig mit dem Early Access.
Early Access · Dezember 2026
Lassen Sie Agenten handeln. Behalten Sie die Kontrolle.
Wir öffnen NrtVix AI zuerst für eine kleine Gruppe von Unternehmen. Erzählen Sie uns von Ihrem, wir melden uns.