Stellen Sie den Guardian vor den Agenten, den Sie schon haben.
Wenn Ihr Agent Tools aufruft, kann er sie über NrtVix aufrufen. Der Agent schlägt eine Aktion vor; der Guardian antwortet mit einer Entscheidung; das vertrauenswürdige Gateway führt aus, was erlaubt ist.
NrtVix AI / Entwickler
Drei Schritte zu einem geschützten Tool-Aufruf.
- Schritt 1
Agent registrieren
Legen Sie einen Agenten in Ihrem Arbeitsbereich an und wählen Sie, welche Tools er nutzen darf. Der Agent erhält eine Identität, nie ein nutzbares Geheimnis.
- Schritt 2
Tools über den Guardian aufrufen
Nutzen Sie die geschützte Toolbox, statt Ihre Tools direkt aufzurufen. Jeder Aufruf wird validiert und dann dem Guardian vorgelegt.
- Schritt 3
Mit der Entscheidung umgehen
Lesen Sie den Status: ausgeführt, wartet auf Freigabe oder blockiert. Sagen Sie Ihrem Nutzer die Wahrheit über das, was passiert ist.
- Danach
Nach der Freigabe fortsetzen
Wenn der Inhaber freigibt, setzen Sie dieselbe Anfrage über ihre ID fort. Sie läuft einmal, am Gateway.
from nrtvix import GuardedToolbox tools = GuardedToolbox(bridge) # your workspace + agent identity result = tools.call("refund_order", order="ORDER-1042", amount=180) if result.status == "executed": ... # done by the trusted gateway elif result.status == "awaiting_approval": ... # tell the customer it is with the owner else: ... # blocked or refused: do not retry
const res = await fetch(APP + "/api/m17/agents/" + agentId + "/chat/stream", { method: "POST", credentials: "include", headers: { "Content-Type": "application/json", "X-SaaS-CSRF": csrf }, body: JSON.stringify({ message: "Refund ORDER-1042 for $180" }), }); const reader = res.body.getReader(); // server-sent events over POST // event: delta -> text as the model writes it // event: tool -> one Guardian-checked tool result // event: done -> the final reply and all results
curl -X POST "$APP/api/m17/agents/$AGENT_ID/chat" \ -H "Content-Type: application/json" \ -H "X-SaaS-CSRF: $CSRF" -b cookies.txt \ -d '{"message": "Look up CUSTOMER-01"}' # {"reply": "...", "tool_results": [{"tool": "lookup_customer", # "status": "executed", "executed": true, ...}], "stopped": "completed"}
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.
Ein Aufruf. Ein klarer Status.
Dieselbe Art von Anfrage kann unterschiedlich enden. Ihr Agent liest den Status und sagt seinem Nutzer die Wahrheit über das, was passiert ist.
executed: the gateway ran the action onceawaiting_approval: the owner decides; resume the same request afterwardsblocked: policy does not allow it, so do not retryalready_executed: a repeated request is never run twice
executed
Guardian-Prüfung
Freigabe erforderlich
Eine kleine Oberfläche. Starke Garantien.
Geschützte Tools
Ein fester Katalog von Tools mit strengen Argumentschemata. Der Agent kann kein Tool erfinden.
Ein Entscheidungsformat
Dieselben Status für jedes Tool, damit die Logik Ihres Agenten einfach bleibt.
Chat-API mit Streaming
Antworten kommen als Server-Sent Events, während das Modell schreibt, mit Tool-Ergebnissen dazwischen.
Keine Geheimnisse in Ihrem Agenten
Ihr Agent hat nur eine Identität. Tool-Zugangsdaten bleiben im Gateway.
Prüfprotokoll, das Sie verifizieren können
Ein Endpunkt berechnet die Hash-Kette des Prüfprotokolls Ihres Arbeitsbereichs neu.
Lokales Labor
Alles läuft lokal mit Beispieldaten, damit Sie sicher testen können, bevor es live geht.
Heute vier Tools. Weitere folgen.
| Tool | Argumente | Was sie tut | Was der Guardian prüft |
|---|---|---|---|
lookup_customer | customer | Einen Kundendatensatz per Referenz finden | Nur lesend |
refund_order | order, amount | Eine Bestellung in US-Dollar erstatten | Betragsgrenzen, Budget, Freigabe |
add_support_note | ticket, note | Einem Ticket eine Notiz mit bis zu 500 Zeichen hinzufügen | Längenlimit |
export_customer_manifest | export, rows | Einen Kundenexport mit 1 bis 1.000 Zeilen vorbereiten | Zeilenlimits, Freigabe |
Was ein Tool-Aufruf zurückgeben 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. |
Text, während er geschrieben wird. Ergebnisse, während sie entschieden werden.
| 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. |
Sinnvolle Grenzen, vorab genannt.
| 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 |
Einfache HTTP-Statuscodes.
| 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. |
Geplant für Entwickler.
Webhooks Geplant
Werden Sie benachrichtigt, wenn eine Anfrage freigegeben, abgelehnt wird oder abläuft.
JavaScript SDK Geplant
Die geschützte Toolbox für Node.js und den Browser.
API-Schlüssel Geplant
Bereichsbeschränkte Schlüssel für die gehostete API, im Dashboard rotierbar.
Versionierte API Geplant
Stabile Pfade unter einem Versionspräfix zum Start.
Welche Modelle und Frameworks funktionieren?
Jedes Modell oder Framework, das eine Funktion aufrufen kann. Der gehostete Agent der aktuellen Version nutzt ein großes Sprachmodell über die API seines Anbieters; das SDK ist modellunabhängig.
Kann mein Agent seine eigenen Anfragen freigeben?
Nein. Die Freigabe ist eine separate, authentifizierte Aktion des Inhabers, gebunden an die exakte Anfrage. Ein Agent kann nur fragen.
Was passiert, wenn mein Agent einen blockierten Aufruf wiederholt?
Er wird erneut abgelehnt. Wiederholte identische Aufrufe in einer Aufgabe werden als Duplikate abgelehnt, und blockierte Aktionen bleiben blockiert.
Wann kann ich die gehostete API nutzen?
Mit dem Early Access, geplant für Dezember 2026. Bis dahin läuft die API nur in der lokalen Version.
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.