Développeurs · Référence API
Endpoints, événements et erreurs.
L’API HTTP des agents hébergés, telle qu’elle existe dans la version actuelle. Les chemins passeront sous un préfixe de version au lancement.
NrtVix AI / Développeurs / Référence API
Endpoints
Agents hébergés.
| Endpoint | Ce qu’elle fait |
|---|---|
GET /api/m17/agents | Lister vos agents hébergés. |
POST /api/m17/agents | Créer un agent : nom, outils, budget mensuel, type d’agent, informations d’entreprise. |
GET /api/m17/agents/{id}/messages | La conversation récente avec un agent. |
POST /api/m17/agents/{id}/chat | Envoyer un message et recevoir la réponse complète. |
POST /api/m17/agents/{id}/chat/stream | Envoyer un message et recevoir la réponse en événements serveur. |
POST /api/m17/agents/{id}/continue | Après l’approbation du propriétaire, exécuter une demande une fois. |
PUT /api/m17/agents/{id}/knowledge | Remplacer les informations d’entreprise de l’agent. |
POST /api/m17/agents/{id}/archive | Arrêter un agent et annuler ses autorisations inutilisées. |
Demande
POST /api/m17/agents/{id}/chat Content-Type: application/json X-SaaS-CSRF: <token from your session> {"message": "Refund ORDER-1042 for $180"}
Réponse
{
"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"
}
Toutes les requêtes d’écriture exigent une session propriétaire connectée et un jeton CSRF, et doivent venir de la même origine. Les requêtes d’autres sites sont refusées.
Événements en streamingThe
The /chat/stream endpoint.
| É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. |
États
Ce que peut indiquer un résultat 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. |
Erreurs et limites
À quoi s’attendre quand quelque chose est refusé.
| É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. |
| 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 |
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é.
Accès anticipé · décembre 2026
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.