TypeScript Agent 到 A2A Agent

connection 生成器可以将您的 TypeScript Agent 连接到远程 A2A 代理 — 可以是 TypeScript 或 Python — 这样您的代理就可以将任务委托给另一个代理作为工具使用。

该生成器会设置所有必要的配置,使您的代理能够发现并调用远程 A2A 代理,无论是部署到 AWS(通过 Bedrock AgentCore)还是在本地运行时都可以。

前提条件

在使用此生成器之前,请确保您具备:

一个包含 Agent 组件的 TypeScript 项目(任何协议)
一个使用 --protocol=A2A 和 --auth=IAM 生成的 Agent 组件项目(可以是 ts#agent 或 py#agent)
两个组件都使用 infra: agentcore 创建

用法

安装 Nx Console VSCode Plugin 如果您尚未安装
在VSCode中打开Nx控制台
点击 Generate (UI) 在"Common Nx Commands"部分
搜索 @aws/nx-plugin - connection
填写必需参数
点击 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

您还可以执行试运行以查看哪些文件会被更改

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

选择您的宿主代理项目作为源,选择您的 A2A 代理项目作为目标。如果您的项目包含多个组件,请指定 sourceComponent 和 targetComponent 选项以消除歧义。

选项

参数	类型	默认值	描述
sourceProject 必需	string	-	源项目
targetProject 必需	string	-	要连接到的目标项目
sourceComponent	string	-	要从其连接的源组件（组件名称、相对于源项目根目录的路径或生成器 ID）。使用 '.' 显式选择项目作为源。
targetComponent	string	-	要连接到的目标组件（组件名称、相对于目标项目根目录的路径或生成器 ID）。使用 '.' 显式选择项目作为目标。
preferInstallDependencies	boolean	true	是否在生成器运行后优先安装依赖项。设置为 false 可在批量运行多个生成器时延迟安装（如果后续生成器需要计算 Nx 项目图，仍会运行安装）；在最后统一安装一次。

生成器输出

生成器会创建一个共享的 agent-connection 包并修改您的代理代码:

文件夹packages/common/agent-connection
- 文件夹src
  - 文件夹app
    <target-agent-name>-client-strands.ts 连接的 A2A 代理的高级 Strands 客户端
  - 文件夹core
    agentcore-endpoints.ts 框架无关的 ARN/URL 解析
    agentcore-fetch.ts 框架无关的 SigV4 / JWT / 会话转发 fetch
    agentcore-a2a-client-config.ts 框架无关的 A2A 客户端配置(签名的 clientFactory)
    agentcore-a2a-client-strands.ts 包装配置的 Strands A2A 客户端
  - index.ts 导出所有客户端
- project.json
- tsconfig.json

此外,它还会:

转换您代理的 agent.ts 以将远程 A2A 代理注册为 Strands tool
更新代理的 serve-local 目标以依赖于目标代理的 serve-local 目标
安装所需的依赖项

使用连接的 A2A 代理

生成器会转换您代理的 agent.ts 以将远程 A2A 代理包装为工具:

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

export const getAgent = async (sessionId: string) => {
  const remoteAgent = await RemoteAgentClientStrands.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],
  });
};

sessionId 参数从调用者传递过来,确保 Bedrock AgentCore 可观测性的一致性。

在底层,RemoteAgentClientStrands.create(sessionId) 返回一个配置了 SigV4 签名 clientFactory 的 Strands A2AAgent(当部署到 AWS 时),以及一个普通的 http://localhost:<port>/ 端点(当 SERVE_LOCAL=true 时)。签名和端点解析位于框架无关的 agentcore-a2a-client-config.ts 中;只有轻量的 agentcore-a2a-client-strands.ts 依赖于 Strands。

基础设施

运行连接生成器后,您需要授予宿主代理调用远程 A2A 代理的权限。

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);

A2A 代理上的 grantInvokeAccess 会同时配置 bedrock-agentcore:InvokeAgentRuntime 和 bedrock-agentcore:GetAgentCard — A2A 客户端需要这两者来获取代理卡片并发送消息。

远程代理的 AgentCore 运行时 ARN 会由生成的 CDK 构造自动注册到运行时配置的 agentcore 命名空间中,以便宿主代理可以在运行时发现它。

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

  appconfig_application_id  = module.runtime_config_appconfig.application_id
  appconfig_application_arn = module.runtime_config_appconfig.application_arn
}

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

  appconfig_application_id  = module.runtime_config_appconfig.application_id
  appconfig_application_arn = module.runtime_config_appconfig.application_arn
}

# 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
}

远程代理的 AgentCore 运行时 ARN 会由生成的 Terraform 模块自动注册到运行时配置的 agentcore 命名空间中,以便宿主代理可以在运行时发现它。

本地开发

生成器会配置宿主代理的 dev 目标以:

自动启动连接的 A2A 代理
设置 LOCAL_DEV=true,使生成的客户端直接连接到 http://localhost:<port>/ 而不是 AgentCore

使用以下命令在本地运行代理:

pnpm nx <agent-name>-dev <project-name>

yarn nx <agent-name>-dev <project-name>

npx nx <agent-name>-dev <project-name>

bunx nx <agent-name>-dev <project-name>

这将同时启动宿主代理和所有连接的 A2A 代理,宿主代理通过分配的本地端口使用普通 HTTP 调用远程代理。 �理。