REST + OpenAPI
Appelez /agent/v1 avec une clé d'API Bearer. /agent/v1/openapi.json fournit la description de l'interface afin que les outils connaissent les requêtes disponibles.
Laissez l'IA diagnostiquer. Vous décidez de l'exécution.
Confiez la topologie, les métriques, les événements et les diagnostics aux outils d'IA que vous utilisez. Connectez-les via REST ou MCP, et c'est vous qui définissez le périmètre des ressources, les autorisations de configuration et la préautorisation de réparation.
En savoir plus sur la connexion des outilsConnectez les outils que vous utilisez déjà.
MCP HTTP distant
Connectez-vous via /mcp à l'aide d'une clé d'API ou d'une autorisation OAuth PKCE. REST et MCP partagent les mêmes autorisations, tâches et règles d'audit.
Un Agent,une identité.
Ressources et fonctionnalités, des périmètres distincts.
Choisissez des ressources précises ou toutes les ressources du compte, puis utilisez les portées de fonctionnalités (Scope) pour déterminer ce qui peut être lu, diagnostiqué ou modifié. La portée couvrant toutes les ressources inclut aussi celles ajoutées ultérieurement.
Lecture et diagnostic par défaut, l'écriture est accordée séparément.
La création, la modification, la suppression ou la publication de configurations client, de règles de routage du trafic, du routage des nœuds et de la sécurité des sources nécessite l'autorisation de gestion correspondante. La génération, l'exécution et la consultation des tâches nécessitent également l'autorisation de consultation des tâches.
Durée de validité et quota, à définir selon vos besoins.
Définissez pour chaque identité une durée de validité, un quota d'appels par minute et un quota de tâches par jour. Une clé d'API n'est affichée intégralement qu'une seule fois, lors de sa création ou de sa rotation ; conservez-la dans votre gestionnaire d'identifiants, vous pourrez la renouveler ou la révoquer ultérieurement.
Consultez d'abord le diagnostic, puis décidez de l'exécution.
Lorsqu'un battement de cœur de nœud est anormal, accordez les autorisations de diagnostic et de planification afin que l'outil puisse lire la topologie, les métriques et les événements concernés et générer un plan de réparation. Consultez les preuves et le plan dans les détails de la tâche, puis décidez quelles réparations autoriser.
La pré-autorisation de réparation sélectionne séparément les nœuds, les actions, la durée de validité et un plafond quotidien de réparations. Vous pouvez autoriser la restauration des services d'un nœud, l'hébergement d'un Agent, l'installation d'un nœud personnel, ou le traitement d'une mise à niveau de firmware échouée ; l'exécution nécessite également la portée (Scope) correspondante.
Actuellement, la pré-autorisation de réparation ne s'applique qu'aux nœuds sans Relay actif. Lors de l'exécution, le plan, les ressources, l'identité du firmware et les conditions de santé sont vérifiés. Les réparations peuvent interrompre brièvement les services du nœud ; en cas d'échec, l'exécution s'arrête et la raison précise est conservée.
Diagnostics et réparations, tous consignés.
Le diagnostic, la planification et l'exécution disposent tous d'un historique des tâches. Les preuves et les plans peuvent être consultés ultérieurement, tandis que les résultats d'exécution et les revérifications de l'état des nœuds sont affichés séparément, ce qui permet de déterminer facilement si le service a été rétabli.
La page d'accès AI Agent enregistre la gestion des Keys, la pré-autorisation des clients, les appels d'interface, l'exécution des tâches et la revue, ce qui permet de retrouver une tâche précise par action, résultat et horodatage.
En savoir plus sur l'état et la restauration des nœuds →Questions fréquentes.
L'autorisation OAuth étend-elle les permissions existantes de l'Agent ?
Non. Lors de l'autorisation, vous sélectionnez le compte d'équipe et l'identité de l'Agent, et l'application ne peut utiliser que les permissions et le périmètre de ressources déjà accordés à cette identité. Les jetons d'accès sont valables quinze minutes au maximum ; la rotation ou la révocation d'une API Key invalide également l'autorisation OAuth d'origine.
Si les permissions de diagnostic sont accordées, la remédiation peut-elle être exécutée automatiquement ?
Non. La planification, l'exécution et la consultation des tâches nécessitent chacune des permissions distinctes, et l'exécution d'une remédiation requiert en outre une pré-autorisation séparée du nœud, de l'action, de la période de validité et du quota, ainsi que le respect des conditions de maintenance en vigueur au moment de l'exécution.
La révocation d'une identité annule-t-elle les opérations déjà émises ?
La révocation bloque les nouveaux accès ainsi que les remédiations non encore exécutées. Les opérations déjà émises continuent d'être suivies jusqu'à leur résultat final ; consultez l'état des tâches dans la console.