Comprendre les agents IA et l'API
Ce que les agents IA tels que Claude, ChatGPT, Claude Code, Codex et Cursor peuvent faire dans votre espace de travail Clevera, les moyens de les connecter, les forfaits (Pro et supérieurs), les limites, les rôles, les coûts et la sécurité.
AI agents & API permet aux applications IA telles que Claude, ChatGPT, Claude Code, Codex et Cursor, ainsi qu'à vos propres scripts, de travailler dans votre espace de travail Clevera : trouver des enregistrements, demander des vidéos, des clips sociaux et des articles, exporter des vidéos et travailler sur des sites de documentation. Vous décidez exactement ce que chaque agent peut faire, combien de crédits il peut dépenser et quand une personne doit approuver.
Ce que les agents peuvent faire
| Zone | Ce qu'un agent peut faire |
|---|---|
| Vidéos | Lister et lire vos enregistrements, vidéos, articles et transcriptions ; demander des vidéos pratiques, des démonstrations de produits, des vidéos nettoyées et stylisées à partir d'un enregistrement, des clips sociaux, des articles à partir d'un enregistrement et des traductions vidéo ; exporter des MP4 jusqu'en 4K ; ajouter des images, des vidéos et des PDF à vos téléchargements. |
| Sites de documentation | Lire, rédiger, organiser, traduire et publier des pages de site de documentation et le journal des modifications, répondre aux lecteurs à partir des pages publiées, lire les informations sur les lecteurs, et modifier les paramètres du site ou créer des sites. |
Les agents ne peuvent pas encore effectuer de recherche sur les sites web ou de visites guidées enregistrées.
L'agent fait la demande ; l'IA de Clevera crée la vidéo ou l'article, de la même manière que lorsque vous le lancez dans l'application. Un agent ne voit jamais plus que ce que son propriétaire pourrait voir : les enregistrements dans une collection privée restent cachés à moins que le propriétaire du jeton n'y ait accès.
Moyens de connexion
| Moyen | Pour | Configurer dans |
|---|---|---|
| Jeton API | Claude Code, Codex CLI, Cursor, tout client MCP et vos propres scripts via l'API REST | Jetons → Nouveau jeton. Voir Créer un jeton API. |
| Application connectée | Claude (claude.ai) et ChatGPT en tant que connecteur personnalisé ; pas de jeton, vous vous connectez | L'application, avec l'URL du connecteur depuis Applications connectées. Voir Connecter des applications et agents IA. |
| API REST | Scripts et services backend | Un jeton API. Voir Utiliser l'API REST. |
Le serveur MCP est https://app.clevera.ai/mcp et l'API REST est sous https://app.clevera.ai/api/v1.
Trouver la page
Ouvrez le menu de l'espace de travail et choisissez AI agents & API. Sur les sites de documentation, elle se trouve également sur la page d'accueil de la documentation et dans le menu Paramètres d'un site. La page (« Laissez Claude, Codex, ChatGPT et vos scripts travailler dans cet espace de travail. ») comporte cinq onglets, chacun avec son compteur :
| Onglet | Ce qui s'y trouve |
|---|---|
| Jetons | Vos jetons API ; les propriétaires et les administrateurs voient chaque jeton. Gérer les jetons API |
| Applications connectées | L'URL du connecteur et les applications connectées par les utilisateurs. Connecter des applications et agents IA |
| Requêtes de l'agent | Travail payant en attente d'approbation par une personne, avec un badge de compteur, et l'historique. Contrôler les dépenses et les approbations des agents |
| Webhooks | Notifications signées vers vos propres systèmes. Configurer des webhooks |
| Activité | Ce que les agents ont fait. Lire l'activité de l'agent |
Forfaits
AI agents & API est disponible sur les forfaits Pro, Entreprise et Personnalisé. Cela inclut les jetons API, les connecteurs pour Claude et ChatGPT, et les webhooks.
Sur les forfaits Gratuit et Starter, la page affiche « AI agents & API sont inclus dans Pro » : « Passez à Pro pour laisser Claude, ChatGPT et vos scripts travailler dans cet espace de travail. Les jetons et applications existants cessent de fonctionner jusqu'à ce moment-là ; vous pouvez toujours les révoquer ici. » Cliquez sur Passer à Pro. Les contrôles verrouillés indiquent « L'accès à l'API et aux agents est disponible sur Pro et supérieur », « Les connecteurs Claude.ai et ChatGPT sont disponibles sur Pro et supérieur » ou « Les webhooks sont disponibles sur Pro et supérieur ».
| Limite | Pro, Entreprise, Personnalisé |
|---|---|
| Jetons API actifs par espace de travail | 50 |
| Applications connectées par personne | 20 |
| Webhooks par espace de travail | 10 |
| Approuver automatiquement ci-dessous au maximum | Pro et Entreprise : 500 crédits. Personnalisé : 1 000 crédits. |
Si l'espace de travail quitte Pro
Rien n'est supprimé, mais tout est mis en pause jusqu'à ce que vous passiez à nouveau à la version supérieure :
| Après le passage à Starter ou Gratuit | |
|---|---|
| Jetons API | Restent listés et peuvent être révoqués. Chaque appel est refusé : « L'API de l'agent n'est pas sur le forfait de cet espace de travail. Elle est disponible sur Pro et supérieur. » Ils ne peuvent pas être régénérés (Régénérer le secret ouvre la boîte de dialogue de mise à niveau). |
| Applications connectées | Restent listées et peuvent être déconnectées. Leurs appels échouent ; Claude ou ChatGPT peuvent seulement dire qu'ils n'ont pas pu se connecter. |
| Webhooks | Restent listés, mais rien n'est envoyé. Envoyer un événement de test et Relivrer indiquent « Les webhooks ne sont pas sur votre forfait. » |
| Requêtes de l'agent | Approuver indique « L'accès à l'API et aux agents n'est pas sur votre forfait. » Refuser fonctionne toujours. |
| Nouveaux jetons | « L'accès à l'API et aux agents n'est pas sur votre forfait. » |
Le passage à Pro permet aux jetons, applications et webhooks de fonctionner à nouveau. Les jetons expirent toujours à leurs dates d'origine.
Qui peut faire quoi
Un agent agit en tant que personne ayant créé son jeton ou l'ayant connecté, dans les limites autorisées par le rôle de cette personne. Il ne peut jamais faire plus que ce que cette personne pourrait faire dans l'application, et le rôle est vérifié à chaque appel, de sorte qu'un changement de rôle prend effet immédiatement.
| Tâche | Propriétaire | Admin | Éditeur | Créateur de contenu |
|---|---|---|---|---|
| Créer des jetons et connecter des applications pour vous-même | Oui | Oui | Oui | Oui |
| Voir et révoquer chaque jeton et application dans l'espace de travail | Oui | Oui | Les siens uniquement | Les siens uniquement |
| Donner à un agent la permission de demander des vidéos et de dépenser des crédits | Oui | Oui | Non | Oui |
| Donner à un agent la permission de publier des sites de documentation | Oui | Oui | Oui | Non |
| Approuver le travail payant demandé par les agents | Oui | Oui | Non | Non |
| Gérer les webhooks | Oui | Oui | Non | Non |
La liste complète se trouve dans Autorisations de l'agent.
Ce que cela coûte
- Les appels API et MCP sont gratuits : lire, rechercher, citer et vérifier un travail ne coûtent aucun crédit. Il en va de même pour les exportations vidéo.
- Le travail qui utilise l'IA coûte des crédits, de la même manière que lorsque vous le lancez dans l'application : vidéos, clips sociaux, articles à partir d'enregistrements, traductions et pages de site générées par l'IA.
- Un agent ne peut commencer un travail payant qu'avec un jeton qui dispose de
credits:spend. Chaque démarrage est d'abord cité et vérifié par rapport aux plafonds de dépenses du jeton, et une personne l'approuve à moins qu'il ne soit inférieur à la ligne Approuver automatiquement ci-dessous du jeton. Voir Contrôler les dépenses et les approbations des agents.
Comment Clevera assure la sécurité des agents
- Les jetons expirent toujours : après 7 jours, 30 jours, 90 jours ou 1 an. Il n'existe pas de « jamais ».
- Les secrets ne sont affichés qu'une seule fois. Clevera ne stocke qu'une empreinte numérique et affiche les quatre derniers caractères.
- Accès minimal. Chaque jeton ne possède que les autorisations, les sites de documentation et les adresses IP que vous choisissez.
- Les personnes approuvent les dépenses. Un agent ne peut pas approuver ses propres dépenses ; seul le propriétaire de l'espace de travail ou un administrateur peut le faire.
- Les jetons divulgués sont révoqués. Un jeton Clevera trouvé dans un dépôt GitHub public est révoqué automatiquement.
- L'activité inhabituelle est arrêtée. Des rafales d'appels refusés révoquent le jeton ; des rafales de modifications ou de dépenses le mettent en pause, et le propriétaire est averti.
- Tout est consigné dans activité, conservé pendant 13 mois. Les modifications du site de documentation par un agent apparaissent également dans l'historique de la page sous le nom « Agent nom (jeton) ».