Création d’une collaboration multi-agent - Amazon Bedrock

Création d’une collaboration multi-agent

La création d’une collaboration multi-agent comprend les étapes suivantes :

  1. Création et déploiement des agents collaborateurs. Assurez-vous de configurer chaque agent collaborateur pour implémenter une tâche spécifique dans le flux de travail de collaboration multi-agent.

  2. Création d’un nouvel agent superviseur ou attribution du rôle de superviseur à un agent existant. Lorsque vous créez un nouvel agent superviseur ou que vous identifiez un agent existant en tant qu’agent superviseur, vous pouvez également spécifier la manière dont vous souhaitez que l’agent superviseur traite les informations entre plusieurs agents collaborateurs.

    Vous pouvez confier à l’agent superviseur la tâche de coordonner les réponses des agents collaborateurs ou vous pouvez attribuer à l’agent superviseur la tâche d’acheminer les informations vers l’agent collaborateur approprié pour envoyer la réponse finale. L’attribution à l’agent de supervision de la tâche d’acheminement des informations réduit le temps de latence.

  3. Association de la version d’alias des agents collaborateurs à un agent superviseur.

    Note

    Pour le moment, vous pouvez associer un maximum de 10 agents collaborateurs à un agent superviseur.

  4. Préparation et test de votre équipe de collaboration multi-agent.

  5. Déploiement et invocation d’un agent superviseur.

Vous pouvez créer une collaboration multi-agent dans la console Amazon Bedrock, à l’aide des API, de l’AWS CLI ou du kit AWS SDK. Pour découvrir comment créer une collaboration multi-agent, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes :

Console
Étape 1 : créer des agents collaborateurs

  • Suivez les instructions pour créer et configurer un agent. Assurez-vous de configurer chaque agent collaborateur pour effectuer une tâche spécifique.

Étape 2 : créer un nouvel agent superviseur ou attribuer le rôle de superviseur à un agent existant

  1. Lors de la création d’un nouvel agent superviseur, suivez les instructions de Création et configuration manuelles de l’agent, puis passez à l’étape suivante.

    Si un agent est déjà configuré et que vous souhaitez lui attribuer un rôle de superviseur, passez à l’étape suivante.

  2. Si vous n’êtes pas encore dans le créateur d’agents, procédez comme suit :

    1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse https://console.aws.amazon.com/bedrock.

    2. Dans le volet de navigation de gauche, sélectionnez Agents. Choisissez ensuite un agent dans la section Agents.

    3. Choisissez Modifier dans le créateur d’agents.

    4. Dans le créateur d’agents, faites défiler la page jusqu’à la section Collaboration multi-agent et choisissez Modifier.

  3. Sur la page Collaboration multi-agent, dans la section Statut de la collaboration, activez Collaboration multi-agent. Cela permettra d’identifier l’agent en tant qu’agent superviseur.

  4. Dans la section Configuration de la collaboration, choisissez la manière dont vous souhaitez que l’agent superviseur traite les informations entre plusieurs agents collaborateurs afin de coordonner une réponse finale.

    1. Si vous souhaitez que l’agent superviseur coordonne les réponses des agents collaborateurs, sélectionnez Superviseur.

    2. Si vous souhaitez que l’agent superviseur achemine les informations vers l’agent collaborateur approprié pour envoyer la réponse finale, sélectionnez Superviseur avec acheminement.

    3. Passez aux étapes suivantes pour ajouter des agents collaborateurs.

Étape 3 : ajouter des agents collaborateurs

  1. Développez la section Agent collaborateur et fournissez des informations sur l’agent collaborateur que vous avez créé pour la collaboration multi-agent.

    1. Pour Agent collaborateur, sélectionnez un agent collaborateur et un Alias d’agentf dans le menu déroulant. Vous pouvez choisir Afficher pour afficher les détails de l’agent collaborateur.

    2. Dans Nom du collaborateur, entrez un nom alternatif pour votre agent collaborateur. Ce nom ne remplacera pas le nom d’origine de cet agent.

    3. Dans Instructions de collaboration, entrez les détails indiquant quand ce collaborateur doit être utilisé par l’agent superviseur.

    4. (Facultatif) Activez Activer l’historique des conversations si vous souhaitez que l’agent superviseur partage le contexte des conversations précédentes avec cet agent collaborateur. Si cette option est activée, le superviseur inclura l’historique complet de la session en cours, y compris le texte saisi par l’utilisateur et la réponse de l’agent superviseur à chaque étape de la conversation.

  2. Choisissez Ajouter un collaborateur pour ajouter cet agent collaborateur à votre équipe de collaboration multi-agent. Pour ajouter d’autres agents collaborateurs, répétez l’étape 1 jusqu’à ce que vous ayez ajouté tous vos agents collaborateurs.

  3. Lorsque vous avez terminé d’ajouter des agents collaborateurs, choisissez l’une des options suivantes :

    • Pour rester dans la collaboration multi-agent, choisissez Enregistrer et passez à l’étape suivante pour préparer et tester votre équipe de collaboration multi-agent.

    • Pour revenir à la page Détails de l’agent, choisissez Enregistrer et quitter.

Étape 4 : préparer et tester une collaboration multi-agent
Étape 5 : déployer une collaboration multi-agent

  • Déployez la collaboration multi-agent en configurant l’agent superviseur pour qu’il fasse une demande InvokeAgent.

API

Pour créer une équipe de collaboration multi-agent, procédez comme suit :

Étape 1 : créer des agents collaborateurs

  • Suivez les instructions pour créer et configurer un agent. Assurez-vous de configurer chaque agent collaborateur pour effectuer une tâche spécifique.

Étape 2 : créer un nouvel agent superviseur ou attribuer le rôle de superviseur à un agent existant

  • Pour créer un nouvel agent superviseur, envoyez une demande CreateAgent (consultez le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison de développement des agents Amazon Bedrock.

    Pour attribuer un rôle de superviseur à un agent existant, envoyez une demande UpdateAgent avec un point de terminaison de développement des agents Amazon Bedrock. Étant donné que tous les champs seront écrasés, incluez à la fois les champs que vous souhaitez mettre à jour et ceux que vous souhaitez conserver tels quels.

    Vous devez inclure au minimum les champs suivants :

    Champ Cas d’utilisation
    agentResourceRoleArn Pour spécifier un ARN du rôle de service autorisé à appeler des opérations d’API sur l’agent
    foundationModel Pour spécifier un modèle de fondation (FM) avec lequel l’agent doit orchestrer
    instruction Pour fournir des instructions pour indiquer à l’agent ce qu’il doit faire. Utilisé dans l’espace réservé $instructions$ du modèle d’invite de l’orchestration.
    agentCollaboration

    Pour attribuer le rôle de superviseur à l’agent.

    Spécifiez SUPERVISOR si vous souhaitez que l’agent superviseur coordonne les réponses des agents collaborateurs et publie la réponse.

    Spécifiez SUPERVISOR_ROUTER si vous souhaitez que l’agent superviseur achemine les informations vers l’agent collaborateur approprié pour envoyer la réponse finale.

    Par défaut, ce champ est défini sur DISABLED.

    Les champs suivants sont facultatifs :

    Champ Cas d’utilisation
    description Décrit ce que fait l’agent
    idleSessionTTLInSeconds Durée au terme de laquelle l’agent met fin à la session et supprime toutes les informations stockées.
    customerEncryptionKeyArn ARN d’une clé KMS pour chiffrer les ressources de l’agent
    tags Pour associer des balises à votre agent.
    promptOverrideConfiguration Pour personnaliser les invites envoyées au modèle de fondation à chaque étape de l’orchestration.
    guardrailConfiguration Pour ajouter une barrière de protection à l’agent. Spécifiez l’ID ou l’ARN de la barrière de protection et la version à utiliser.
    clientToken Pour garantir que la demande d’API n’est exécutée qu’une seule fois. Pour plus d’informations, consultez Garantie de l’idempotence.

    La réponse renvoie un objet CreateAgent contenant des informations sur l’agent superviseur que vous venez de créer. Si l’agent ne parvient pas à être créé, l’objet CreateAgent de la réponse renvoie une liste d’éléments failureReasons et une liste d’éléments recommendedActions pour vous aider à résoudre le problème.

Étape 3 : ajouter des agents collaborateurs

  • Pour associer des agents collaborateurs à l’agent superviseur, envoyez une demande AssociateAgentCollaborator (consultez le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison de développement des agents Amazon Bedrock.

    Vous devez inclure au minimum les champs suivants :

    Champ Cas d’utilisation
    collaboratorName Pour spécifier un nom alternatif pour l’agent collaborateur. Ce nom apparaît uniquement dans les instructions de collaboration et ne remplace pas le nom d’agent d’origine.
    agentDescriptor Pour spécifier l’Arn de l’alias de l’agent.
    collaborationInstruction Pour fournir des instructions pour indiquer à l’agent collaborateur ce qu’il doit faire.
    relayConversationHistory

    Définissez sur TO_COLLABORATOR pour spécifier que l’agent superviseur partagera le contexte des conversations précédentes avec cet agent collaborateur.

    Valeurs valides : TO_COLLABORATOR | DISABLED.
Étape 4 : préparer et tester votre équipe de collaborateurs multi-agent
Étape 4 : déployer votre équipe de collaboration multi-agent

  • Déployez votre équipe de collaboration multi-agent en configurant votre agent superviseur pour qu’il fasse une demande InvokeAgent.