Ajouter une passerelle d'agent

Configurer une passerelle d'agent dans Okta.

Pourquoi et quand exécuter cette tâche

Lorsque vous ajoutez une passerelle d'agent, vous configurez son chemin d'URL unique et autorisez les agents IA qui peuvent acheminer les requêtes via celle-ci. Ensuite, vous personnalisez les outils du serveur MCP que vous souhaitez inclure.

Avant de commencer

Vous avez un rôle d'administrateur avec l'autorisation de gérer les passerelles d'agent.
Vous avez configuré les serveurs MCP dont vous souhaitez utiliser les outils. Consultez Ajouter des serveurs MCP.
Vous avez enregistré un agent IA dans votre org.

Procédure

Créer un profil

Dans la console des administrateurs, accédez à Sécurité > Passerelle d'agent.
Cliquez sur Créer une passerelle d'agent.
Dans l'onglet Profil, saisissez un nom d'affichage et une description.
Le Chemin d'URL de la passerelle d'agent affiche une URL hébergée par Okta pour la passerelle. Cliquez sur Personnaliser le chemin d'URL pour le modifier.

Remarque : Vous ne pouvez pas modifier cette URL après l'avoir enregistrée. Pour utiliser une URL différente, supprimez la passerelle d'agent et recréez-la.
Cliquez sur Créer.
Cliquez sur Suivant.

Ajouter des agents IA

Sélectionnez les agents IA qui peuvent appeler la passerelle d'agent. La page Agents IA affiche le nom de cette passerelle à côté de vos sélections et dans l'onglet Connexions de ressources de l'agent IA.

Dans l'onglet Agents IA, cliquez sur Modifier.
Sélectionnez les agents IA qui sont autorisés à appeler la passerelle.
Cliquez sur Enregistrer.
Cliquez sur Suivant.

Ajouter des connexions de ressources

Sélectionnez les serveurs MCP que vous souhaitez inclure dans la passerelle.

Dans l'onglet Connexions de ressources, cliquez sur Ajouter une connexion.
Sélectionnez les serveurs MCP que vous souhaitez inclure dans la passerelle.
Cliquez sur Enregistrer.
Cliquez sur Suivant.

Personnaliser vos outils

Définissez les outils de serveur MCP que vous souhaitez inclure. Notez que les noms d'outil longs peuvent être hachés silencieusement dans l'interface utilisateur.

Dans l'onglet Personnalisation des outils, cliquez sur Gérer les outils à côté d'un serveur MCP.
Sélectionnez les outils que vous souhaitez connecter à la passerelle. Vous pouvez ajouter jusqu'à 200 outils par passerelle.

Remarque : Cliquez sur Redécouvrir les outils à tout moment pour actualiser la liste des outils disponibles.
Cliquez sur Enregistrer.

Activer la passerelle d'agent

Lorsque la passerelle d'agent est prête à être activée, un lien Activer maintenant apparaît. Cliquez sur ce lien ou sélectionnez Actions > Activer.
Pour désactiver la passerelle d'agent, sélectionnez Actions > Désactiver.
Cliquez sur Terminer.

Remarque : Vous pouvez également activer et désactiver la passerelle depuis la page principale Passerelle d'agent. Sélectionnez les points de suspension verticaux à côté d'une passerelle, puis sélectionnez Activer ou Désactiver.

Configurer le client d'agent IA

Une fois que vous avez activé la passerelle d'agent, configurez le client d'agent IA pour qu'il envoie des requêtes via Okta au lieu de vos serveurs MCP.

Remarque : Ce processus se déroule en dehors d'Okta et varie selon le fournisseur d'agent IA. Reportez-vous à la documentation de votre fournisseur d'agent IA pour des instructions spécifiques. Consultez les Configurations des clients d'agent IA pour obtenir des liens vers la documentation relative aux clients d'agents IA courants.

Accédez à l'onglet Passerelle d'agent > Profil et copiez le Chemin d'URL de la passerelle d'agent. Conservez-le dans un endroit sûr.
Allez à l'onglet Agent IA > Enregistrement du client et copiez l'identifiant du client (ID client, Secret client ou Clé publique/privée). Conservez-le dans un endroit sûr.
Dans la plateforme du client d'agent IA, ajoutez le chemin de l'URL de la passerelle d'agent en tant que point de terminaison du serveur MCP distant.

Remarque : Utilisez un chemin de déploiement géré par l'administrateur ou centralisé chaque fois que possible. Le déploiement centralisé garantit que toutes les requêtes des agents IA sont envoyées via la passerelle d'agent et évite aux développeurs de configurer les paramètres manuellement.