Agent Python Strands vers Agent A2A

Le générateur connection peut connecter votre Agent Strands Python à un agent A2A distant — soit TypeScript soit Python — afin que votre agent puisse déléguer à un autre agent en tant qu’outil.

Le générateur configure tout le câblage nécessaire pour que votre agent puisse découvrir et invoquer l’agent A2A distant, à la fois lorsqu’il est déployé sur AWS (via Bedrock AgentCore) et lorsqu’il s’exécute localement.

Prérequis

Avant d’utiliser ce générateur, assurez-vous d’avoir :

Un projet Python avec un composant Strands Agent (n’importe quel protocole)
Un projet avec un composant Strands Agent généré avec --protocol=A2A et --auth=IAM (soit ts#strands-agent soit py#strands-agent)
Les deux composants créés avec computeType: BedrockAgentCoreRuntime

Utilisation

Installez le Nx Console VSCode Plugin si ce n'est pas déjà fait
Ouvrez la console Nx dans VSCode
Cliquez sur Generate (UI) dans la section "Common Nx Commands"
Recherchez @aws/nx-plugin - connection
Remplissez les paramètres requis
Cliquez sur Generate

pnpm nx g @aws/nx-plugin:connection

yarn nx g @aws/nx-plugin:connection

npx nx g @aws/nx-plugin:connection

bunx nx g @aws/nx-plugin:connection

Vous pouvez également effectuer une simulation pour voir quels fichiers seraient modifiés

pnpm nx g @aws/nx-plugin:connection --dry-run

yarn nx g @aws/nx-plugin:connection --dry-run

npx nx g @aws/nx-plugin:connection --dry-run

bunx nx g @aws/nx-plugin:connection --dry-run

Sélectionnez votre projet d’agent hôte comme source et votre projet d’agent A2A comme cible. Si vos projets contiennent plusieurs composants, spécifiez les options sourceComponent et targetComponent pour lever l’ambiguïté.

Options

Paramètre	Type	Par défaut	Description
sourceProject Requis	string	-	Le projet source
targetProject Requis	string	-	Le projet cible auquel se connecter
sourceComponent	string	-	Le composant source depuis lequel se connecter (nom du composant, chemin relatif à la racine du projet source, ou identifiant du générateur). Utilisez '.' pour sélectionner explicitement le projet comme source.
targetComponent	string	-	Le composant cible auquel se connecter (nom du composant, chemin relatif à la racine du projet cible, ou identifiant du générateur). Utilisez '.' pour sélectionner explicitement le projet comme cible.

Sortie du générateur

Le générateur crée un projet Python partagé agent_connection dans packages/common/agent_connection/ (s’il n’existe pas déjà). Les modules clients par connexion sont générés dans ce projet partagé :

Répertoirepackages/common/agent_connection
- Répertoire<scope>_agent_connection
  - __init__.py Ré-exporte les clients par connexion
  - Répertoirecore
    agentcore_a2a_client.py Client A2A AgentCore de base avec authentification SigV4
  - Répertoireapp
    <target_agent_name>_client.py Client par connexion pour chaque agent A2A

De plus, le générateur :

Transforme le fichier agent.py de votre agent pour enregistrer l’agent A2A distant comme outil en utilisant @tool
Ajoute le projet agent_connection comme dépendance d’espace de travail de votre projet d’agent
Met à jour la cible serve-local de l’agent pour dépendre de la cible serve-local de l’agent cible

Utilisation de l’agent A2A connecté

Le générateur transforme le fichier agent.py de votre agent pour encapsuler l’agent A2A distant en tant qu’outil :

from contextlib import contextmanager
from strands import Agent, tool

from my_scope_agent_connection import RemoteAgentClient

@contextmanager
def get_agent(session_id: str):
    remote_agent = RemoteAgentClient.create(session_id=session_id)

    @tool
    def ask_remote_agent(prompt: str) -> str:
        """Delegate a question to the remote RemoteAgent A2A agent and return its reply."""
        return str(remote_agent(prompt))

    yield Agent(
        system_prompt="...",
        tools=[ask_remote_agent],
    )

Le paramètre session_id est transmis depuis l’appelant, garantissant la cohérence pour Bedrock AgentCore Observability.

En interne, RemoteAgentClient.create(session_id=...) retourne un A2AAgent Strands configuré avec un httpx.AsyncClient qui signe les requêtes avec SigV4 lorsqu’il est déployé sur AWS, et un point de terminaison http://localhost:<port>/ simple lorsque SERVE_LOCAL=true.

Infrastructure

Après avoir exécuté le générateur de connexion, vous devez accorder à l’agent hôte la permission d’invoquer l’agent A2A distant.

CDK
Terraform

const remoteAgent = new RemoteAgent(this, 'RemoteAgent');
const myAgent = new MyAgent(this, 'MyAgent');

// Grant the host agent permission to invoke the remote A2A agent
remoteAgent.grantInvokeAccess(myAgent);

grantInvokeAccess sur un agent A2A configure à la fois bedrock-agentcore:InvokeAgentRuntime et bedrock-agentcore:GetAgentCard — le client A2A a besoin des deux pour récupérer la carte de l’agent et envoyer des messages.

L’ARN du runtime AgentCore de l’agent distant est automatiquement enregistré dans l’espace de noms agentcore de la Configuration d’Exécution par la construction CDK générée, afin que l’agent hôte puisse le découvrir au moment de l’exécution.

module "remote_agent" {
  source = "../../common/terraform/src/app/agents/remote-agent"
}

module "my_agent" {
  source = "../../common/terraform/src/app/agents/my-agent"
}

# Grant the host agent permission to invoke the remote A2A agent
resource "aws_iam_policy" "agent_invoke_a2a" {
  name = "AgentInvokeA2aPolicy"
  policy = jsonencode({
    Version = "2012-10-17"
    Statement = [{
      Effect = "Allow"
      Action = [
        "bedrock-agentcore:InvokeAgentRuntime",
        "bedrock-agentcore:GetAgentCard",
      ]
      Resource = module.remote_agent.agent_core_runtime_arn
    }]
  })
}

resource "aws_iam_role_policy_attachment" "agent_invoke_a2a" {
  role       = module.my_agent.agent_core_runtime_role_arn
  policy_arn = aws_iam_policy.agent_invoke_a2a.arn
}

L’ARN du runtime AgentCore de l’agent distant est automatiquement enregistré dans l’espace de noms agentcore de la Configuration d’Exécution par le module Terraform généré, afin que l’agent hôte puisse le découvrir au moment de l’exécution.

Développement local

Le générateur configure la cible serve-local de l’agent hôte pour :

Démarrer automatiquement le(s) agent(s) A2A connecté(s)
Définir SERVE_LOCAL=true afin que le client généré se connecte directement à http://localhost:<port>/ au lieu d’AgentCore

Exécutez l’agent localement avec :

pnpm nx <agent-name>-serve-local <project-name>

yarn nx <agent-name>-serve-local <project-name>

npx nx <agent-name>-serve-local <project-name>

bunx nx <agent-name>-serve-local <project-name>

Cela démarrera à la fois l’agent hôte et tous les agents A2A connectés, l’agent hôte appelant les agents distants via HTTP simple sur leurs ports locaux assignés.