Claude Platform Docs
Managed AgentsManaged Agents auto-hébergé

Utiliser la console sur votre serveur

Configurez la connexion à la console sur votre serveur Claude Managed Agents auto-hébergé, puis créez des agents et exécutez des sessions dans un navigateur.

La console sur votre serveur est une page web qu’un serveur Claude Managed Agents auto-hébergé sert à la même adresse que son API. Vous y créez des agents, exécutez des sessions et gérez des environnements, des coffres d’identifiants, des magasins de mémoire et des skills, sans SDK ni CLI.

Il ne s’agit pas de la Claude Console sur platform.claude.com. Elle n’affiche que ce qui se trouve sur votre serveur.

Configurer la connexion

Un administrateur configure la connexion une seule fois. Pour plutôt essayer la console sur une seule machine, suivez Essayer la console de votre serveur, qui utilise le fournisseur de connexion fictif de la version.

  1. Configurer l’authentification unique et la connexion depuis le terminal

    Suivez Authentification unique, y compris Permettre aux développeurs de se connecter depuis un terminal. La console connecte les utilisateurs via l’application que vous avez enregistrée pour la connexion depuis le terminal. Elle vérifie chaque jeton par rapport à la première entrée de audiences dans l’entrée de l’émetteur ; placez donc l’audience de cette application en premier.

  2. Servir la console via HTTPS

    Placez un proxy qui termine TLS devant le port 8400. Placer TLS devant le serveur indique ce que le proxy doit faire. En HTTP simple, la connexion ne fonctionne qu’à localhost ou 127.0.0.1.

  3. Ajouter l’adresse de la console à l’application

    Dans votre fournisseur d’identité, ajoutez l’adresse HTTPS de votre serveur comme deuxième URI de redirection de cette application, avec une barre oblique finale : https://cma.example.com/. Autorisez également son origine, https://cma.example.com, pour les requêtes « cross-origin » (inter-origines), ou CORS.

Pour vérifier la configuration, ouvrez la console et connectez-vous.

Ouvrir la console

Si vos applications appellent https://cma.example.com, ouvrez https://cma.example.com/ dans un navigateur, puis cliquez sur Continue with SSO.

Vous vous connectez via votre fournisseur d’identité. La console n’accepte pas la clé API du serveur. Si la console indique que la connexion n’est pas configurée sur ce serveur, un administrateur doit configurer la connexion.

Exécuter un agent depuis la console

Les outils intégrés d’un agent vierge, tels que bash, s’exécutent sur un worker ; sélectionnez donc un environnement qu’un worker interroge. Ce qui s’exécute où explique ce qu’est un worker. Sans worker, le premier appel d’outil attend qu’un worker l’exécute. Les administrateurs créent les environnements et peuvent voir les workers d’un environnement dans son onglet Workers.

  1. Créer un agent

    Dans la barre latérale, sélectionnez Agents, puis cliquez sur Create agent. Sélectionnez un point de départ, tel que Blank agent, puis saisissez un nom.

    Cliquez sur Create agent. La page de l’agent s’ouvre.

  2. Démarrer une session

    Sur la page de l’agent, cliquez sur Start session. Sélectionnez un environnement, puis cliquez sur Create session. La page de la session s’ouvre.

  3. Envoyer un message

    Saisissez un message dans la zone en bas de la page, puis envoyez-le. La page se met à jour au fur et à mesure que l’agent travaille. Si un appel d’outil attend votre action, sa carte affiche Approve et Deny.

Tant qu’un appel d’outil attend votre action, le badge de la session indique Idle.

Pour ouvrir toute autre session, comme une session démarrée par une application via l’API, sélectionnez Sessions dans la barre latérale, puis sélectionnez la session.

Qui voit quoi

Votre rôle détermine ce qu’affiche la console, comme dans l’API :

  • Les administrateurs voient et modifient tout sur le serveur.
  • Les personnes ayant le rôle developer ou user voient tous les environnements. Parmi les agents, sessions, coffres, magasins de mémoire et skills, elles ne voient que ce qu’elles ont créé sous leur propre connexion.

Un agent ou une session créé avec la clé API du serveur, comme ceux du guide de démarrage rapide, n’apparaît qu’aux administrateurs. Pour le tableau complet, consultez Ce que chaque rôle peut faire.

Désactiver la console

Le serveur sert la console par défaut. Pour la désactiver, définissez console.serve: false dans le fichier de paramètres, puis redémarrez le serveur. Le serveur cesse alors de servir la console. Les agents et les sessions continuent de fonctionner via l’API.

Étapes suivantes

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