Partager via

Utiliser les briques de l’agent : Agent de supervision pour créer un système multi-agent coordonné

Cette page explique comment utiliser Agent Bricks : Agent de supervision pour créer un système de superviseur multi-agent qui orchestre les agents et les outils IA pour travailler ensemble sur des tâches complexes. Vous pouvez améliorer leur coordination en fonction des commentaires en langage naturel de vos experts en matière.

Agent Bricks fournit une approche simple pour créer et optimiser des systèmes d’agent IA spécifiques au domaine et haute qualité pour les cas d’utilisation courants de l’IA.

Qu’est-ce qu’Agent Bricks : Agent de supervision ?

Utilisez Agent Bricks : Supervisor Agent pour créer un système de supervision qui coordonne les Genie Spaces, les points de terminaison des agents, les fonctions du Unity Catalog et les serveurs MCP pour accomplir des tâches complexes à travers différents domaines spécialisés. L’agent de supervision utilise des modèles d’orchestration IA avancés pour gérer les interactions de l’agent, la délégation de tâches et la synthèse des résultats pour fournir des solutions complètes.

Briques de l’agent : l’agent de supervision crée le système pour vous et vous permet de l’améliorer au fil du temps avec des commentaires humains. Il est idéal pour prendre en charge les cas d’usage suivants :

  • Fournissez des analyses et des insights sur le marché en recherchant des rapports de recherche et des données d’utilisation.
  • Répondez aux questions sur les processus internes et automatisez la gestion de la file d'attente des tickets pour ces processus.
  • Accélérez le service client en répondant aux questions liées aux politiques, aux FAQ, aux comptes et à d'autres sujets.

L’agent de supervision vous permet d’améliorer la qualité de coordination du superviseur et d’ajuster le comportement de l’agent en fonction des commentaires en langage naturel de vos experts en matières concernées. Fournissez des exemples et des instructions pour optimiser les performances du système.

L’agent de supervision crée un point de terminaison complet que vous pouvez utiliser en aval pour vos applications. Par exemple, vous pouvez interagir avec le point de terminaison en envoyant des invites dans Playground ou en créant une application de conversation à l’aide de Databricks Apps. Le superviseur dispose de contrôles d’accès intégrés, afin que ses utilisateurs finaux accèdent uniquement aux sous-agents et aux données auxquels ils ont accès.

Agent Bricks utilise le stockage par défaut pour stocker des transformations de données temporaires, des points de contrôle de modèle et des métadonnées internes qui alimentent chaque agent. Lors de la suppression de l’agent, toutes les données associées à l’agent sont supprimées du stockage par défaut.

Requirements

Créer un système de superviseur multi-agent

Accédez à l’icône Agents.Agents dans le volet de navigation gauche de votre espace de travail. Dans la vignette Agent de supervision , cliquez sur Générer.

Étape 1 : Créer des sous-agents et accorder des autorisations

Avertissement

L’exécution d’un code arbitraire dans un outil d’agent peut exposer des informations sensibles ou privées auxquelles l’agent a accès. Les clients sont responsables d’exécuter uniquement du code approuvé et d’implémenter des garde-fous et des autorisations appropriées pour empêcher l’accès involontaire aux données.

Étant donné qu'Agent Bricks : Agent de Supervision crée un système de superviseur qui coordonne les sous-agents pour qu'ils travaillent ensemble à l'accomplissement de tâches complexes, vous devez d'abord fournir des sous-agents pour qu'ils soient coordonnés. Ces sous-composants peuvent être des Genie Spaces, des points de terminaison d'agent Knowledge Assistant, des fonctions du Catalogue Unity ou des serveurs MCP. Vous devez également accorder aux utilisateurs finaux un accès explicite à chaque sous-agent afin que le superviseur retourne des réponses utiles de cette sous-partie.

Espace Génie

  1. Pour créer un espace Genie, suivez les étapes décrites dans Configurer et gérer un espace AI/BI Genie.
  2. Accordez aux utilisateurs finaux l’accès à l’espace Genie et à ses objets catalogue Unity sous-jacents. Suivez les étapes décrites dans Partager un espace Génie.

Point de terminaison de l’agent

  1. Pour créer un agent Assistant Connaissances, suivez les étapes décrites dans Use Agent Bricks : Knowledge Assistant pour créer un chatbot de haute qualité sur vos documents.
  2. Accordez aux utilisateurs finaux l’autorisation CAN QUERY sur le point de terminaison de l’assistant de connaissances.

Fonction Unity Catalog

  1. Pour créer des fonctions de catalogue Unity en tant qu’outils d’agent IA, suivez les étapes décrites dans Créer des outils d’agent IA à l’aide des fonctions catalogue Unity.
  2. Accordez aux utilisateurs finaux l’autorisation EXECUTE sur la fonction Catalogue Unity.

Serveur MCP externe

  1. Pour installer un serveur MCP à partir de Databricks Marketplace, consultez Obtenir l’accès aux serveurs MCP externes. Pour configurer des serveurs MCP externes, suivez les étapes décrites dans Utiliser des serveurs MCP externes. La connexion doit utiliser l’authentification par jeton du porteur ou l’authentification OAuth Machine à Machine. Consultez les méthodes d’authentification pour les services externes.
  2. Accordez aux utilisateurs finaux l’autorisation USE CONNECTION sur la connexion du catalogue Unity.

Étape 2 : Configurer votre superviseur

Sous l’onglet Build , configurez votre superviseur et ajoutez les agents qu’il coordonnera.

Note

Le superviseur dispose de contrôles d’accès intégrés, afin que ses utilisateurs finaux accèdent uniquement aux sous-agents et aux données auxquels ils ont accès.

  • Pour les points de terminaison d’agent, les utilisateurs finaux nécessitent l’autorisation CAN QUERY sur le point de terminaison.
  • Pour les espaces Genie, les utilisateurs finaux ont besoin d’accéder à l’espace Genie et à l’accès aux données à ses objets catalogue Unity sous-jacents. Voir Partager un espace Génie.
  • Pour les fonctions catalogue Unity, les utilisateurs finaux nécessitent l’autorisation EXECUTE sur la fonction.
  • Pour les serveurs MCP externes, les utilisateurs finaux nécessitent l’autorisation USE CONNECTION sur la connexion du catalogue Unity.

Si l’utilisateur final n’a pas accès à des sous-agents, le superviseur met fin à la conversation. Si l’utilisateur final a accès à certains sous-éléments, mais pas tous les sous-éléments, le superviseur redirige la conversation loin des sous-agents que l’utilisateur ne peut pas accéder.

  1. Dans le champ Nom , entrez un nom pour votre agent de superviseur.

  2. Dans le champ Description , décrivez ce que votre système de supervision peut faire.

  3. Sous Configurer des agents, sélectionnez jusqu’à 20 agents et/ou outils.

    Espace Génie

    Pour fournir un espace Génie :

    1. Dans le champ Type , sélectionnez Génie Espace.

    2. Sélectionnez votre espace Génie dans le menu déroulant de l’espace Génie .

    3. Le nom de l’agent et décrire les champs de contenu sont automatiquement renseignés lorsque cela est possible. Vous pouvez modifier le nom et la description si vous le souhaitez.

      Le superviseur utilise les informations contenues dans la description pour l’aider à coordonner les agents. Fournissez autant de détails que possible pour améliorer sa délégation de tâches.

    Pour en savoir plus sur les espaces Genie, consultez Qu’est-ce qu’un espace Génie IA/BI. Pour configurer un espace Genie, consultez Configurer et gérer un espace AI/BI Genie

    Point de terminaison de l’agent

    Pour configurer un point d'accès agent :

    1. Dans le champ Type , sélectionnez Point de terminaison de l’agent.
    2. Sélectionnez le point de terminaison dans le menu déroulant Point de terminaison de l’agent . Seuls les points de terminaison d’agent créés via Agent Bricks : Assistant de Connaissances sont pris en charge.
    3. Le champ Nom de l’agent est automatiquement renseigné. Vous pouvez le modifier si vous le souhaitez.
    4. Sous Décrire le contenu, décrivez ce que cet agent peut faire pour aider le superviseur à comprendre quand déléguer des tâches à cet agent.

    Fonction Unity Catalog

    Pour fournir une fonction de catalogue Unity :

    1. Dans le champ Type , sélectionnez Fonction catalogue Unity.
    2. Sélectionnez la fonction dans le menu déroulant Unity Catalog Function.
    3. Dans le champ Nom de l’agent , indiquez un nom pour cet outil.
    4. Sous Décrire le contenu, décrivez ce que fait cette fonction et quand elle doit être utilisée. Cela permet au superviseur de comprendre quand utiliser cet outil.

    Pour en savoir plus sur la création de fonctions de catalogue Unity en tant qu’outils d’agent, consultez Créer des outils d’agent IA à l’aide des fonctions de catalogue Unity.

    Serveur MCP externe

    Pour fournir un serveur MCP externe :

    1. Dans le champ Type , sélectionnez Serveur MCP externe.
    2. Sélectionnez la connexion dans le menu déroulant de la connexion du catalogue Unity.
    3. Dans le champ Nom de l’agent , indiquez un nom pour ce serveur MCP.
    4. Sous Décrire le contenu, décrivez ce que fournit ce serveur MCP et quand il doit être utilisé. Cela permet au superviseur de comprendre quand déléguer à ce serveur.

    Pour en savoir plus sur les serveurs MCP externes, consultez Utiliser des serveurs MCP externes.

  4. (Facultatif) Pour ajouter d’autres agents, cliquez sur + Ajouter. Vous pouvez fournir jusqu’à 20 agents.

  5. (Facultatif) Dans le champ Instructions , spécifiez les instructions relatives à la façon dont le superviseur doit répondre.

  6. Cliquez sur Créer un agent.

Vous êtes redirigé vers l’onglet Configurer . La création de votre système multi-agent et de votre agent de supervision peut prendre quelques minutes.

Étape 3 : Tester votre agent de superviseur

Une fois que votre superviseur a terminé de construire, testez-le pour voir comment il coordonne plusieurs agents pour gérer des tâches complexes. Dans Tester votre agent dans le volet droit, discutez avec l’agent pour évaluer ses réponses.

  1. (Facultatif) Vous pouvez également tester l’agent dans AI Playground. Cliquez sur Ouvrir dans Playground. Cela ouvre AI Playground avec votre point de terminaison de superviseur connecté. Si vous avez activé les fonctionnalités d'assistance d'IA, vous pouvez activer AI Judge et génération de tâches synthétiques pour vous aider à évaluer votre superviseur.
  2. Sous Tester votre agent ou dans AI Playground, entrez une tâche complexe pour votre superviseur.
  3. Évaluez sa réponse. Assurez-vous que le superviseur délègue correctement les tâches aux agents appropriés.
  4. En fonction des réponses de votre agent, ajustez les champs Description et Instructions dans le volet gauche pour améliorer sa configuration.
  5. Cliquez sur Mettre à jour l’agent.

Si vous êtes satisfait du rendement de votre superviseur, continuez à utiliser le superviseur as-is.

Étape 4 : Améliorer le superviseur

Briques de l’agent : l’agent de supervision peut ajuster le comportement du superviseur en fonction des commentaires en langage naturel. Rassemblez des commentaires d’experts via la page de configuration pour améliorer la qualité de coordination de votre superviseur. La collecte de données étiquetées pour votre superviseur peut améliorer ses performances. Agent Bricks réentraînent et optimisent le superviseur à partir des nouvelles données.

Sous l’onglet Exemples , ajoutez des questions et des scénarios de tâches pour le superviseur.

  1. Ajoutez des questions à l’étiquette :

    1. Cliquez sur + Ajouter pour ajouter une question.
    2. Dans le mode Ajouter une question , entrez votre question.
    3. Cliquez sur Ajouter. La question doit apparaître dans l’interface utilisateur.
    4. Répétez jusqu’à ce que vous ayez ajouté toutes les questions que vous souhaitez évaluer.
    5. Pour supprimer une question, cliquez sur le menu kebab, puis supprimez.

  2. Une fois que vous avez terminé d’ajouter vos questions, vous pouvez partager l’agent avec des tiers afin de vous aider à créer un jeu de données étiqueté de haute qualité. Partagez un lien vers votre page de configuration agent Bricks : Agent de supervision pour recueillir des commentaires d’experts.

  3. Assurez-vous que les experts ont accès à l’agent de superviseur et aux sous-agents appropriés :

    1. Dans le coin supérieur droit, cliquez sur l’icône de menu Kebab. puis sur gérer les autorisations. Accordez aux experts des autorisations CAN_MANAGE afin qu’ils puissent accéder à l’agent et fournir des commentaires.
    2. Vérifiez que la PME a accès aux sous-agents appropriés :
      • Pour chaque espace Genie, accordez à la PME toutes les autorisations appropriées pour interagir avec l’espace. Voir Partager un espace Génie.
      • Pour chaque point de terminaison de l’agent, accordez à LA PME l’autorisation CAN QUERY .
      • Pour chaque fonction de catalogue Unity, accordez à la PME l’autorisation EXECUTE sur la fonction.
      • Pour chaque serveur MCP externe, accordez à la PME l’autorisation USE CONNECTION sur la connexion du catalogue Unity.

    Si la PME n’a pas accès à des sous-agents, le superviseur termine la conversation. Si l’utilisateur final a accès à certains sous-éléments, mais pas tous les sous-éléments, le superviseur redirige la conversation loin des sous-agents que l’utilisateur ne peut pas accéder.

  4. Pour étiqueter les données, cliquez sur une question et ajoutez des instructions dans le panneau qui s’affiche. Les instructions s’appliquent juste après leur enregistrement.

  5. Testez à nouveau l’agent dans la page de configuration ou AI Playground pour voir ses performances améliorées. Si nécessaire, ajoutez d’autres questions et recommandations pour continuer à améliorer le comportement.

Gérer les autorisations

Par défaut, seuls les auteurs de l’agent Bricks et les administrateurs de l’espace de travail disposent d’autorisations pour l’agent. Pour permettre à d’autres utilisateurs de modifier ou d’interroger votre agent, vous devez leur accorder explicitement l’autorisation.

Pour gérer les autorisations sur votre agent :

  1. Ouvrez votre agent dans Agent Bricks.
  2. En haut, cliquez sur l’icône de menu Kebab. Menu kebab.
  3. Cliquez sur Gérer les autorisations.
  4. Dans la fenêtre Paramètres d’autorisation , sélectionnez l’utilisateur, le groupe ou le principal du service.
  5. Sélectionnez l’autorisation d’accorder :
    • Peut gérer : permet de gérer les briques de l’agent, notamment la définition des autorisations, la modification de la configuration de l’agent et l’amélioration de sa qualité.
    • Peut exécuter des requêtes : permet d'exécuter des requêtes sur le point de terminaison Agent Bricks dans AI Playground et via l’API. Les utilisateurs disposant uniquement de cette autorisation ne peuvent pas afficher ou modifier l’agent dans Agent Bricks.
  6. Cliquez sur Ajouter.
  7. Cliquez sur Enregistrer.

Note

Pour les points de terminaison d’agent créés avant le 16 septembre 2025, vous pouvez accorder des autorisations Can Query au point de terminaison à partir de la page Points de terminaison de service .

Interroger le point de terminaison de l’agent

Dans la page de l’agent, cliquez sur l’icône de service Modèle. Consultez l’état de l’agent en haut à droite pour obtenir votre point de terminaison d’agent déployé et voir les détails du point de terminaison.

Il existe plusieurs façons d’interroger le point de terminaison de supervisor créé. Utilisez les exemples de code fournis dans AI Playground comme point de départ.

  1. Sous l’onglet Build , cliquez sur Ouvrir dans le terrain de jeu.
  2. Dans Playground, cliquez sur Obtenir le code.
  3. Choisissez la façon dont vous souhaitez utiliser le point de terminaison :
    • Sélectionnez l’API Curl pour obtenir un exemple de code pour interroger le point de terminaison à l’aide de curl.
    • Sélectionnez l’API Python pour un exemple de code pour interagir avec le point de terminaison à l’aide de Python.

Limitations

  • Last updated on