Agent TypeScript Strands vers Agent A2A

Le générateur connection peut connecter votre Agent Strands TypeScript à un agent A2A distant — soit TypeScript ou 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 lors de l’exécution locale.

Prérequis

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

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

Utilisation

Exécuter le générateur

VSCode

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

CLI

pnpm

pnpm nx g @aws/nx-plugin:connection

yarn

yarn nx g @aws/nx-plugin:connection

npm

npx nx g @aws/nx-plugin:connection

bun

bunx nx g @aws/nx-plugin:connection

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

pnpm

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

yarn

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

npm

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

bun

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 package partagé agent-connection et modifie le code de votre agent :

• Répertoirepackages/common/agent-connection

  • Répertoiresrc

    • Répertoireapp

      • <target-agent-name>-client.ts Client de haut niveau pour l’agent A2A connecté
    • Répertoirecore

      • agentcore-a2a-client.ts Client A2A AgentCore de bas niveau avec authentification SigV4
    • index.ts Exporte tous les clients
  • project.json
  • tsconfig.json

De plus, il :

• Transforme le fichier agent.ts de votre agent pour enregistrer l’agent A2A distant en tant que tool Strands
• Met à jour la cible serve-local de l’agent pour dépendre de la cible serve-local de l’agent cible
• Installe les dépendances requises

Utiliser l’agent A2A connecté

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

packages/example/src/my-agent/agent.ts

import { Agent, tool } from '@strands-agents/sdk';
import { RemoteAgentClient } from ':my-scope/agent-connection';
import { z } from 'zod';

export const getAgent = async (sessionId: string) => {
  const remoteAgent = await RemoteAgentClient.create(sessionId);
  const remoteAgentTool = tool({
    name: 'askRemoteAgent',
    description: 'Delegate a question to the remote RemoteAgent A2A agent and return its reply.',
    inputSchema: z.object({ prompt: z.string() }),
    callback: async ({ prompt }) => (await remoteAgent.invoke(prompt)).toString(),
  });
  return new Agent({
    systemPrompt: '...',
    tools: [remoteAgentTool],
  });
};

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

En coulisses, RemoteAgentClient.create(sessionId) retourne un A2AAgent Strands configuré avec un clientFactory signant SigV4 lorsqu’il est déployé sur AWS, et un endpoint simple http://localhost:<port>/ 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

packages/infra/src/stacks/application-stack.ts

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.

Terraform

packages/infra/src/main.tf

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 :

1. Démarrer automatiquement le(s) agent(s) A2A connecté(s)
2. 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

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

yarn

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

npm

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

bun

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.