Placez le Guardian devant l’agent que vous avez déjà.
Si votre agent appelle des outils, il peut le faire via NrtVix. L’agent propose une action ; le Guardian répond par une décision ; la passerelle de confiance exécute ce qui est autorisé.
NrtVix AI / Développeurs
Trois étapes vers un appel d’outil protégé.
- Étape 1
Enregistrer un agent
Créez un agent dans votre espace et choisissez les outils qu’il peut utiliser. L’agent reçoit une identité, jamais un secret utilisable.
- Étape 2
Appeler les outils via le Guardian
Utilisez la boîte à outils protégée au lieu d’appeler vos outils directement. Chaque appel est validé, puis proposé au Guardian.
- Étape 3
Traiter la décision
Lisez l’état : exécuté, en attente d’approbation ou bloqué. Dites la vérité à votre utilisateur sur ce qui s’est passé.
- Ensuite
Reprendre après approbation
Quand le propriétaire approuve, reprenez la même demande par son identifiant. Elle s’exécute une fois, dans la passerelle.
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"}
Aperçu. Tout ce qui figure sur cette page décrit la version actuelle. Les noms et chemins peuvent changer avant la sortie, et l’API hébergée n’est pas encore en ligne. La documentation ouvre entièrement avec l’accès anticipé.
Un appel. Un état clair.
Le même type de demande peut se terminer de différentes façons. Votre agent lit l’état et dit la vérité à son utilisateur sur ce qui s’est passé.
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
Vérification du Guardian
Approbation requise
Une petite surface. De solides garanties.
Outils protégés
Un catalogue fixe d’outils avec des schémas d’arguments stricts. L’agent ne peut pas inventer un outil.
Un format de décision unique
Les mêmes états pour chaque outil, pour que la logique de votre agent reste simple.
API de chat en streaming
Les réponses arrivent sous forme d’événements serveur pendant que le modèle écrit, avec les résultats d’outils entre les deux.
Aucun secret dans votre agent
Votre agent ne détient qu’une identité. Les identifiants des outils restent dans la passerelle.
Un audit vérifiable
Un endpoint recalcule la chaîne de hachage de l’audit de votre espace.
Laboratoire local
Tout s’exécute en local sur des données d’exemple, pour tester en sécurité avant la mise en service.
Quatre outils aujourd’hui. D’autres arrivent.
| Outil | Arguments | Ce qu’elle fait | Ce que vérifie le Guardian |
|---|---|---|---|
lookup_customer | customer | Trouver une fiche client par référence | Lecture seule |
refund_order | order, amount | Rembourser une commande en dollars américains | Limites de montant, budget, approbation |
add_support_note | ticket, note | Ajouter à un ticket une note de 500 caractères maximum | Limite de longueur |
export_customer_manifest | export, rows | Préparer un export clients de 1 à 1 000 lignes | Limites de lignes, approbation |
Ce que peut renvoyer un appel d’outil.
| État | Signification |
|---|---|
executed | La passerelle de confiance a exécuté l’action une fois. |
awaiting_approval | La demande est dans la file du propriétaire. Rien ne s’est encore passé. |
already_executed | Cette demande a déjà été traitée ; elle n’est pas exécutée deux fois. |
blocked | Les règles ne l’autorisent pas. Ne réessayez pas. |
rejected | Le propriétaire a refusé. |
expired | L’approbation ou l’autorisation a expiré. |
invalid | Les arguments n’étaient pas acceptables. |
duplicate_refused | Le même appel a déjà été fait dans cette tâche. |
limit_reached | La tâche a utilisé tous les appels d’outils autorisés. |
Le texte au fil de l’écriture. Les résultats au fil des décisions.
| Événement | Données | Signification |
|---|---|---|
delta | {text} | Le texte tel que le modèle l’écrit. |
turn | {} | Un nouveau tour du modèle commence après les appels d’outils ; le texte diffusé auparavant n’était qu’un aperçu. |
tool | {tool, status, executed, event_id, reason} | Un résultat d’outil vérifié par le Guardian. |
done | {reply, tool_results, pending_approvals, stopped} | La réponse enregistrée et tous les résultats. |
error | {detail, status} | L’exécution n’a pas pu aboutir. |
Des limites raisonnables, annoncées d’avance.
| Limite | Valeur |
|---|---|
| Longueur du message | De 1 à 2 000 caractères |
| Tours du modèle par message | Up to 6 |
| Appels d’outils par message | Jusqu’à 4 ; les doublons sont refusés |
| Mémoire de conversation | Les 8 derniers tours, chacun de longueur limitée |
| Informations de l’entreprise | Jusqu’à 6 000 caractères par agent |
| Messages par agent et par jour | 50 par défaut ; configurable |
| Taille de la réponse en streaming | Limitée ; un flux inutilisable est redemandé une fois sans streaming |
De simples codes d’état HTTP.
| État | Signification |
|---|---|
401 | Non connecté. |
403 | Jeton CSRF manquant ou incorrect, ou requête provenant d’un autre site. |
404 | L’agent n’existe pas dans votre espace. |
409 | L’agent est archivé. |
422 | Le corps de la requête n’est pas valide. |
429 | La limite quotidienne de messages de cet agent est atteinte. |
503 | Le modèle IA n’est pas configuré sur le serveur. |
Prévu pour les développeurs.
Webhooks Prévu
Soyez prévenu quand une demande est approuvée, refusée ou expire.
SDK JavaScript Prévu
La boîte à outils protégée pour Node.js et le navigateur.
Clés API Prévu
Clés à portée limitée pour l’API hébergée, renouvelées depuis le tableau de bord.
API versionnée Prévu
Des chemins stables sous un préfixe de version au lancement.
Quels modèles et frameworks fonctionnent ?
Tout modèle ou framework capable d’appeler une fonction. L’agent hébergé de la version actuelle utilise un grand modèle de langage via l’API de son fournisseur ; le SDK est indépendant du modèle.
Mon agent peut-il approuver ses propres demandes ?
Non. L’approbation est une action distincte et authentifiée du propriétaire, liée à la demande exacte. Un agent peut seulement demander.
Que se passe-t-il si mon agent relance un appel bloqué ?
Il est de nouveau refusé. Les appels identiques répétés dans une tâche sont refusés comme doublons, et les actions bloquées restent bloquées.
Quand pourrai-je utiliser l’API hébergée ?
Avec l’accès anticipé, prévu en décembre 2026. D’ici là, l’API ne fonctionne que dans la version locale.
Laissez les agents agir. Gardez le contrôle.
Nous ouvrons d’abord NrtVix AI à un petit groupe d’entreprises. Parlez-nous de la vôtre et nous vous recontacterons.
Prêt à commencer ?
Demandez l'accès anticipé, ou parlez-nous de votre entreprise et nous préparerons votre premier agent avec vous.
Voir les offres
Des offres mensuelles simples, prévues pour le lancement. Rien à payer aujourd'hui.
Détails des tarifsCommencer à créer
Décrivez la tâche avec des mots simples et votre premier agent est prêt en quelques minutes.
Découvrir le créateur d’agents