Gérer les agents personnalisés avec l'Admin API

Dans ce document d’aide

Découvrez comment les administrateurs Enterprise peuvent utiliser l'Admin API pour gérer les agents personnalisés, suivre l'utilisation des crédits et appliquer des contrôles à l'échelle de l'espace de travail.

Aller directement aux questions fréquentes

Si vous êtes administrateur sur le forfait Enterprise, vous pouvez gérer les agents personnalisés de votre espace de travail avec l'Admin API. Au lieu de parcourir les paramètres agent par agent, votre équipe peut extraire les informations sur les agents et leur utilisation dans vos propres outils et appliquer les mêmes règles à plusieurs agents à la fois. L'Admin API est disponible uniquement pour les administrateurs d'organisation Enterprise utilisant un jeton d'administration appartenant à l'organisation.

  • Voir chaque agent personnalisé de votre espace de travail. Obtenez une liste de tous les agents, y compris qui a créé chacun d'eux, s'il est actif, quel modèle il utilise, quand il a été exécuté pour la dernière fois et à quoi il a accès.

  • Suivre qui a accès à un agent personnalisé. Mettez à jour les autorisations de partage d'un agent.

  • Suivre l'utilisation des crédits. Voyez combien de crédits chaque agent a utilisés et suivez l'utilisation des crédits en masse.

  • Définir des limites de crédit. Définissez ou modifiez la limite de crédit pour un seul agent, ou définissez un /défaut pour tous les agents personnalisés de l'espace de travail.

  • Choisir qui peut créer des agents. Définissez la politique de création d'agents de votre espace de travail et interrompez tous les agents de l'espace de travail si nécessaire.

  • Activer ou désactiver un agent. Arrêtez l'exécution d'un agent spécifique sans supprimer sa configuration, et réactivez-le plus tard.

  • Supprimer un agent. Retirez un agent de l'utilisation. Sa configuration est conservée afin de pouvoir être récupérée si nécessaire.

  • Votre espace de travail doit être au forfait Enterprise.

  • L'Admin API utilise un accès administrateur au niveau de l'organisation configuré par votre organisation, et non des jetons d'intégration personnels. Pour les étapes de configuration, consultez la documentation pour les développeurs →

Chaque action de l'Admin API dispose d'un contrôle correspondant dans Notion :

  • Le répertoire des agents (ParamètresNotion AIAgents) affiche et gère les agents de votre espace de travail.

  • Le dashboard des crédits Notion affiche l'utilisation des crédits par les agents.

  • Les contrôles de création définissent qui peut créer des agents.

Utilisez les paramètres pour les modifications ponctuelles. Utilisez l'Admin API lorsque vous souhaitez automatiser ces tâches, gérer de nombreux agents à la fois ou intégrer les données d'utilisation dans vos propres outils de Rapport.

  • Intégrez l'utilisation des crédits dans les Rapports internes, afin que chaque équipe puisse voir ce que coûtent ses agents personnalisés.

  • Appliquez les mêmes limites ou règles à plusieurs agents à la fois.

  • Transférez la propriété des agents qui doivent être conservés. Désactivez ou supprimez les agents qui ne sont plus nécessaires.


Questions fréquentes

L'Admin API apparaît-elle dans le journal d'audit ?

Les modifications effectuées via l'Admin API sont attribuées à l'accès administrateur de votre organisation, ce qui vous permet de suivre ce qui a été modifié et quand. En savoir plus sur les journaux d'audit →

Où puis-je trouver la référence complète de l’API ?


Donner votre avis

Cette ressource vous a-t-elle été utile ?


Powered by Fruition