API de gouvernance des agents d'IA et documentation MCP
Maetra est un plan de contrôle d'exécution pour les agents d'IA. Utilisez l'API REST ou le serveur MCP pour garder le travail aligné sur la tâche de l'utilisateur, arrêter les actions sensibles pour l'approbation politique ou humaine, analyser le contenu risqué, et préserver la preuve de ce qui s'est passé après l'approbation.
Nouveau pour Maetra ? Commencez par le Démarrer rapidementC'est vrai. Vous branchez un agent ou un assistant ? Utiliser la Guide du serveur MCPC'est vrai. Tu as juste besoin d'un point final ? Aller à la Référence API.
Les trois contrôles d'exécution#
Task Guard
Alignement des tâches de l'agent d'IA. Transformez l'objectif, les contraintes, la portée et les critères de réussite de l'utilisateur en contrat de travail actif. Avant une action matérielle, Task Guard vérifie si le travail est aligné, soutenu, a besoin d'une explication, demande une confirmation de l'utilisateur, ou devrait être recentré. Par la suite, il peut comparer les effets attendus et signalés.
Govern
Les approbations et les reçus d'exécution pour les humains dans la boucle. Avant qu'un agent déplace de l'argent, supprime des données, ou envoie des courriels à un client, il appelle Maetra. Des politiques exactes ou des renseignements de décision peuvent approuver, bloquer ou orienter l'action vers un humain. Une décision signée est liée à l'action exacte charge utile, et les reçus d'exécution peuvent lier cette approbation aux tentatives et au résultat observé.
Secure
Numérisation du contenu de l'exécution. Invitations à l'écran, appels d'outils et sorties de modèles contre les règles de votre espace de travail — injection rapide, exfiltration de données, outils refusés — et obtenir un verdict (safe, flagged, bloqué) et une action recommandée. Tout ce qui est signalé ou bloqué devient un incident.
Deux façons d'intégrer#
| Interface | Meilleur pour | |
|---|---|---|
| API REST | Appels de moteurs et de services /v1 sur HTTPS. | Démarrage rapide → |
| Serveur MCP | Agents et assistants de l'IA qui parlent le Protocole de Contexte Modèle. | Aperçu d'MCP → |
Les deux sont soutenus par le même moteur d'évaluation et authentifiés avec la même clé API espace de travail.
Ce que vous pouvez construire#
- Agents de paiement et de financement qui ne peuvent pas modifier le compte, le montant ou la monnaie approuvés après examen.
- Agents d'exploitation des clients qui s'arrête avant les remboursements, les changements de compte ou les messages externes.
- Assistants de longue durée qui revérifient leur contrat de travail avant les actions matérielles et déclarent les effets réels après.
- Agents liés à MCP qui ne découvrent que les outils Task Guard, Govern et Secure activés pour leur espace de travail et leur clé API.
L'approbation et l'exécution sont des faits distincts. Une décision prouve ce qu'Maetra a autorisé; reçu d'exécution indique la façon dont cette action exacte a été tentée et les effets observés.
Bon à savoir Vous n'avez pas besoin d'enregistrer vos agents d'abord. Chaque paramètre accepte un texte libre
agent_name, afin que vous puissiez intégrer en quelques minutes et enregistrer des agents plus tard pour des rapports plus riches. Govern évalue toujours les agents API seulement et MCP contre les politiques à l'échelle de l'organisation; quandagent_nameouagent_idcorrespond à un agent enregistré, les politiques d'agent-scoped peuvent s'appliquer. Voir Agents.
URL de base#
https://api.maetra.io
Tous les paramètres d'REST sont déclinés sous /v1C'est vrai. Le serveur MCP a sa propre URL de base — voir Aperçu d'MCP.
Prochaines étapes#
- Créer une clé API dans le tableau de bord.
- Exécutez votre premier point de contrôle et scannez, connecter un client MCPou commencer une tâche Task Guard.
- Parcourir la référence complète de l'API.