Créez une collaboration entre plusieurs agents - Amazon Bedrock

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez une collaboration entre plusieurs agents

Note

La fonctionnalité de collaboration multi-agents est en version préliminaire pour Amazon Bedrock et est sujette à modification.

La création d'une collaboration multi-agents comprend les étapes suivantes :

  1. Créez et déployez 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-agents.

  2. Créez un nouvel agent superviseur ou attribuez le 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 gère 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 assigner à 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 de routage des informations réduit le temps de latence.

  3. Associez la version alias des agents collaborateurs à l'agent superviseur.

    Note

    Vous pouvez associer un maximum de 10 agents collaborateurs à un agent superviseur pour le moment.

  4. Préparez et testez votre équipe de collaboration multi-agents.

  5. Déployez et appelez l'agent de supervision.

Vous pouvez créer une collaboration multi-agents dans la console Amazon Bedrock, à l' APIsaide de la AWS CLI ou du AWS SDK. Pour savoir comment créer une collaboration multi-agents, 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 un rôle de superviseur à un agent existant
  1. Si vous créez un nouvel agent superviseur, suivez les instructions Création et configuration manuelles de l'agent et 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 générateur d'agents, procédez comme suit :

    1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse. https://console.aws.amazon.com/bedrock/

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

    3. Choisissez Modifier dans Agent Builder.

    4. Dans le générateur d'agents, faites défiler la page jusqu'à la section Collaboration multi-agents et choisissez Modifier.

  3. Sur la page Collaboration multi-agents, dans la section État de la collaboration, activez la collaboration multi-agents. 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 routage.

    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-agents.

    1. Pour l'agent collaborateur, sélectionnez un agent collaborateur et un alias d'agent 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 autre nom pour votre agent collaborateur. Ce nom ne remplacera pas le nom d'origine de cet agent.

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

    4. (Facultatif) Activez 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 multi-agent-collaboration équipe. 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, sélectionnez l'une des options suivantes :

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

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

Étape 4 : Préparer et tester une collaboration multi-agents
  • Suivez les instructions pour préparer et tester votre équipe de collaboration multi-agents.

Étape 5 : Déployer une collaboration multi-agents
  • Déployez la collaboration multi-agents en configurant l'agent superviseur pour qu'il fasse une InvokeAgent demande.

API

Procédez comme suit pour créer une équipe de collaboration multi-agents,

É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 un rôle de superviseur à un agent existant
  • Pour créer un nouvel agent superviseur, envoyez un CreateAgentdemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock Build-time.

    Pour attribuer un rôle de superviseur à un agent existant, envoyez un UpdateAgentdemande auprès d'un point de terminaison Agents for Amazon Bedrock au moment de la création. Comme tous les champs seront remplacés, incluez à la fois les champs que vous souhaitez mettre à jour et les champs que vous souhaitez conserver inchangés.

    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
    Modèle de fondation Pour spécifier un modèle de base (FM) avec lequel l'agent doit orchestrer
    instruction Fournir des instructions pour indiquer à l'agent ce qu'il doit faire. Utilisé dans l'espace réservé $instructions$ du modèle d'invite d'orchestration.
    Collaboration entre agents

    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 surDISABLED.

    Les champs suivants sont facultatifs :

    Champ Cas d’utilisation
    description Décrit ce que fait l'agent
    Secondes de session inactives TTLIn Durée après 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
    balises Pour associer des tags à votre agent.
    promptOverrideConfiguration Pour personnaliser les instructions envoyées au FM à chaque étape de l'orchestration.
    Configuration du garde-corps Pour ajouter un garde-corps à l'agent. Spécifiez l'ID ou l'ARN du garde-corps et la version à utiliser.
    clientToken Pour garantir que la demande d'API ne soit terminée qu'une seule fois. Pour plus d'informations, consultez la section Garantir l'idempuissance.

    La réponse renvoie un CreateAgentobjet contenant des informations sur l'agent superviseur que vous venez de créer. Si votre agent ne parvient pas à être créé, le CreateAgentl'objet de la réponse renvoie une liste failureReasons et une liste recommendedActions de problèmes à résoudre.

Étape 3 : Ajouter des agents collaborateurs
  • Pour associer des agents collaborateurs à l'agent superviseur, envoyez une AssociateAgentCollaborator demande (voir le lien pour les formats de demande et de réponse et les détails des champs) à un point de terminaison Agents for Amazon Bedrock au moment de la création.

    Vous devez inclure au minimum les champs suivants :

    Champ Cas d’utilisation
    Nom du collaborateur Pour spécifier un autre nom pour l'agent collaborateur. Ce nom apparaît uniquement dans les instructions de collaboration et ne remplace pas le nom d'agent d'origine.
    Descripteur d'agent Pour spécifier l'alias Arn de l'agent.
    Instructions relatives à la collaboration 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éparez et testez votre équipe de collaborateurs multi-agents
  • Suivez les instructions pour préparer et tester votre équipe de collaboration multi-agents.

Étape 4 : Déployez votre équipe de collaboration multi-agents
  • Déployez votre équipe de collaboration multi-agents en configurant votre agent superviseur pour qu'il fasse une InvokeAgent demande.