Python Strands 代理

生成一个用于构建AI智能体工具的Python Strands Agent，并可选部署到Amazon Bedrock AgentCore Runtime。默认情况下，生成器使用FastAPI暴露HTTP服务器。或者，您可以选择Agent-to-Agent (A2A)协议，以实现与其他A2A兼容智能体的互操作性，或选择AG-UI协议，通过CopilotKit直接集成前端。

什么是Strands？

Strands是一个轻量级、生产就绪的Python框架，用于构建AI智能体。主要特性包括：

• 轻量且可定制：简洁的智能体循环设计，不干扰开发
• 生产就绪：完整的可观测性、追踪和规模化部署选项
• 模型与供应商无关：支持多种不同供应商的模型
• 社区驱动工具：强大的社区贡献工具集
• 多智能体支持：支持智能体团队和自主智能体等高级技术
• 灵活交互模式：支持对话式、流式和非流式交互

使用方式

生成Strands智能体

可通过两种方式生成Python Strands智能体：

VSCode

1. 安装 Nx Console VSCode Plugin 如果您尚未安装
2. 在VSCode中打开Nx控制台
3. 点击 Generate (UI) 在"Common Nx Commands"部分
4. 搜索 @aws/nx-plugin - py#strands-agent
5. 填写必需参数
6. 点击 Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:py#strands-agent

yarn

yarn nx g @aws/nx-plugin:py#strands-agent

npm

npx nx g @aws/nx-plugin:py#strands-agent

bun

bunx nx g @aws/nx-plugin:py#strands-agent

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

pnpm

pnpm nx g @aws/nx-plugin:py#strands-agent --dry-run

yarn

yarn nx g @aws/nx-plugin:py#strands-agent --dry-run

npm

npx nx g @aws/nx-plugin:py#strands-agent --dry-run

bun

bunx nx g @aws/nx-plugin:py#strands-agent --dry-run

项目前提条件

建议先使用py#project生成器创建项目，再添加Strands智能体。

选项配置

参数	类型	默认值	描述
project 必需	string	-	要添加 Strands Agent 的项目
computeType	string	BedrockAgentCoreRuntime	托管 Strands Agent 的计算类型
name	string	-	Strands Agent 的名称（默认：agent）
auth	string	IAM	用于与 Strands Agent 进行身份验证的方法。可选择 IAM（默认）或 Cognito。
protocol	string	HTTP	Strands Agent 的服务器协议。HTTP 暴露一个 FastAPI HTTP 服务器。A2A 暴露一个 Agent-to-Agent 协议服务器。AG-UI 暴露一个 Agent-User Interaction 协议服务器，用于直接前端集成。
iacProvider	string	Inherit	首选的 IaC 提供商。默认情况下，这将继承自您的初始选择。

生成器输出

生成器将在现有Python项目中添加以下文件。生成的文件取决于所选的protocol：

HTTP协议（默认）

• 文件夹your-project/

  • 文件夹your_module/

    • 文件夹agent/ (可自定义名称)

      • __init__.py Python包初始化文件
      • init.py 配置CORS和错误处理中间件的FastAPI应用设置
      • agent.py 主智能体定义（含示例工具）
      • main.py Bedrock AgentCore Runtime的FastAPI入口点
      • Dockerfile 智能体托管入口文件（当computeType设为None时不生成）
  • pyproject.toml 更新Strands依赖
  • project.json 更新服务目标配置

A2A协议

当protocol设为A2A时，入口点使用Strands A2A Server而非FastAPI：

• 文件夹your-project/

  • 文件夹your_module/

    • 文件夹agent/ (可自定义名称)

      • __init__.py Python包初始化文件
      • agent.py 主智能体定义（含示例工具）
      • main.py A2A服务器入口点
      • Dockerfile 智能体托管入口文件（当computeType设为None时不生成）
  • pyproject.toml 更新Strands依赖
  • project.json 更新服务目标配置

AG-UI协议

当protocol设为AG-UI时，入口点使用ag-ui-strands集成，通过AG-UI协议暴露智能体，以便直接与CopilotKit进行前端集成：

• 文件夹your-project/

  • 文件夹your_module/

    • 文件夹agent/ (可自定义名称)

      • __init__.py Python包初始化文件
      • agent.py 主智能体定义（含示例工具）
      • main.py 使用ag-ui-strands的AG-UI服务器入口点
      • Dockerfile 智能体托管入口文件（当computeType设为None时不生成）
  • pyproject.toml 更新Strands和AG-UI依赖
  • project.json 更新服务目标配置

连接到React网站

AG-UI智能体可以使用connection生成器连接到React前端，该生成器将设置CopilotKit组件以提供丰富的聊天体验。

基础设施

无服务器部署

若选择None作为computeType，生成器不会创建任何基础设施即代码。

由于该生成器会根据您选择的 iacProvider 以基础设施即代码的形式输出，它将在 packages/common 目录下创建一个包含相关 CDK 构造体或 Terraform 模块的项目。

通用的基础设施即代码项目结构如下：

CDK

• 文件夹packages/common/constructs

  • 文件夹src

    • 文件夹app/ 针对特定项目/生成器的基础设施构造体

      • …
    • 文件夹core/ 被 app 目录构造体重用的通用构造体

      • …
    • index.ts 导出 app 目录构造体的入口文件
  • project.json 项目构建目标与配置

生成的项目

此项目使用 ts#project 生成器创建，因此配置了相同的构建目标。

Terraform

• 文件夹packages/common/terraform

  • 文件夹src

    • 文件夹app/ 针对特定项目/生成器的 Terraform 模块

      • …
    • 文件夹core/ 被 app 目录模块重用的通用模块

      • …
  • project.json 项目构建目标与配置

生成的项目

此项目使用 terraform#project 生成器创建，因此配置了相同的构建目标。

部署Strands智能体时生成以下文件：

CDK

• 文件夹packages/common/constructs/src

  • 文件夹app

    • 文件夹agents

      • 文件夹<project-name>

        • <project-name>.ts 部署智能体的CDK构造

Terraform

• 文件夹packages/common/terraform/src

  • 文件夹app

    • 文件夹agents

      • 文件夹<project-name>

        • <project-name>.tf 部署智能体的Terraform模块
  • 文件夹core

    • 文件夹agent-core

      • runtime.tf 部署到Bedrock AgentCore Runtime的通用模块

使用Strands智能体

添加工具

工具是AI智能体可调用的功能函数。Strands框架使用基于装饰器的简单方式定义工具。

在agent.py文件中添加新工具：

from strands import Agent, tool

@tool
def calculate_sum(numbers: list[int]) -> int:
    """计算数字列表的总和"""
    return sum(numbers)

@tool
def get_weather(city: str) -> str:
    """获取城市天气信息"""
    # 此处集成天气API
    return f"{city}天气：晴，25°C"

# 将工具添加到智能体
agent = Agent(
    system_prompt="您是一个拥有多种工具的智能助手。",
    tools=[calculate_sum, get_weather],
)

Strands框架自动处理：

• 基于函数类型提示的类型验证
• 工具调用的JSON模式生成
• 错误处理和响应格式化

使用预置工具

通过strands-tools包使用预置工具：

from strands_tools import current_time, http_request, file_read

agent = Agent(
    system_prompt="您是一个智能助手。",
    tools=[current_time, http_request, file_read],
)

模型配置

默认使用Claude 4 Sonnet模型，可自定义模型供应商。参考Strands模型供应商文档进行配置：

from strands import Agent
from strands.models import BedrockModel

# 创建Bedrock模型实例
bedrock_model = BedrockModel(
    model_id="anthropic.claude-sonnet-4-20250514-v1:0",
    region_name="us-west-2",
    temperature=0.3,
)

agent = Agent(model=bedrock_model)

使用MCP服务

可通过添加MCP服务工具扩展智能体功能。

对于使用py#mcp-server或ts#mcp-server生成器创建的MCP服务，可以使用connection生成器。

VSCode

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

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

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

关于连接设置的详细信息，请参考connection生成器指南。

对于其他MCP服务，请参考Strands文档。

更多信息

深入指南请参考Strands官方文档。

协议

智能体的服务器协议决定其通信方式。所有选项都由FastAPI提供服务——区别在于入口点：

• HTTP（默认）：标准FastAPI服务器，带有自定义/invocations端点、CORS和流式传输。最适合自定义客户端集成。
• A2A：将Strands A2A Server挂载到FastAPI应用上。最适合需要被其他A2A兼容智能体发现和调用的场景。
• AG-UI：ag-ui-strands集成，通过SSE暴露AG-UI协议。最适合在React网站中通过CopilotKit直接集成前端。

所有协议都暴露/ping端点以满足AgentCore运行时健康检查契约。A2A智能体监听端口9000；HTTP和AG-UI智能体监听端口8080。生成的Dockerfile和基础设施已为您配置。

FastAPI服务器（HTTP协议）

生成的HTTP服务器包含：

• 配置CORS中间件的FastAPI应用
• 错误处理中间件
• OpenAPI模式生成
• 健康检查端点（/ping）
• 智能体调用端点（/invocations）

使用Pydantic自定义调用输入和输出

智能体的调用端点使用Pydantic模型来定义和验证请求及响应模式。您可以在main.py中自定义这些模型以满足智能体需求。

定义输入模型

默认的InvokeInput模型接受消息。

from pydantic import BaseModel

class InvokeInput(BaseModel):
    message: str

您可以扩展此模型以包含智能体所需的任何额外字段。

会话ID从x-amzn-bedrock-agentcore-runtime-session-id HTTP标头中提取，符合Bedrock AgentCore Runtime会话契约。如果未提供该标头，将生成随机UUID作为后备。

代码组织

如果用户直接调用您的智能体，您可能需要对调用者抽象部分或全部会话ID。例如，您可以使用已认证用户ID作为会话ID的一部分。

还需要注意的是，根据您的使用场景，可能需要为会话实现授权机制，例如确保用户只能访问自己的会话而不能访问其他用户的会话。

定义输出模型

对于流式响应，生成器提供JsonStreamingResponse，它会自动将Pydantic模型序列化为JSON Lines格式（application/jsonl）。该格式兼容OpenAPI 3.2的流式规范，并与生成的TypeScript客户端无缝协作。

默认情况下，智能体yield包含智能体响应文本的StreamChunk对象：

class StreamChunk(BaseModel):
    content: str

您可以自定义StreamChunk模型以满足需求：

from pydantic import BaseModel

class StreamChunk(BaseModel):
    content: str
    timestamp: str
    token_count: int

FastAPI流式限制

注意，由于FastAPI目前不支持为流式响应生成OpenAPI规范，我们必须为每个流式操作显式设置响应模型，例如：

@app.post(
    "/invocations",
    response_class=JsonStreamingResponse,
    responses={200: JsonStreamingResponse.openapi_response(StreamChunk)},
)
async def invoke(input: InvokeInput) -> JsonStreamingResponse:
    return JsonStreamingResponse(handle_invoke(input))

FastAPI有一个关于原生支持的开放功能请求。

Bedrock AgentCore Python SDK

生成器包含对Bedrock AgentCore Python SDK的依赖，用于PingStatus常量。如果需要，可以直接使用BedrockAgentCoreApp替代FastAPI，但请注意会失去类型安全性。

SDK功能详情请参阅文档。

基础设施即代码

由于生成器提供CDK或Terraform基础设施来管理部署，无需使用文档中提到的bedrock-agentcore-starter-toolkit进行部署。

A2A服务器（A2A协议）

当protocol=A2A时，生成的main.py将A2AServer.to_fastapi_app()挂载到父FastAPI应用上，该应用同时暴露/ping端点。部署到AgentCore时，入口点会从AppConfig解析运行时的公共ARN，并在智能体卡片中发布。

大多数用户无需修改此文件——编辑agent.py即可更改工具或系统提示。A2A服务器从Agent构造函数的name和description填充智能体卡片（/.well-known/agent-card.json）。

AG-UI服务器（AG-UI协议）

当protocol=AG-UI时，生成的main.py将您的Strands Agent包装在ag_ui_strands.StrandsAgent中，并通过create_strands_app()创建FastAPI应用。生成的应用暴露一个POST端点，通过Server-Sent Events (SSE)流式传输AG-UI事件，以及用于AgentCore运行时健康检查的/ping端点。

大多数用户无需修改此文件——编辑agent.py即可更改工具或系统提示。

连接到React网站

AG-UI智能体设计为可直接被前端使用。使用connection生成器，通过CopilotKit提供器和AG-UI HttpAgent客户端将您的React网站连接到智能体。

运行Strands智能体

本地开发

生成器配置了名为<your-agent-name>-serve的目标，用于本地开发和测试：

pnpm

pnpm nx agent-serve your-project

yarn

yarn nx agent-serve your-project

npm

npx nx agent-serve your-project

bun

bunx nx agent-serve your-project

该命令使用uv run通过Bedrock AgentCore Python SDK运行智能体。

部署Strands智能体到Bedrock AgentCore Runtime

基础设施即代码

如果您为 computeType 选择了 BedrockAgentCoreRuntime，将生成相关的 CDK 或 Terraform 基础设施，您可以使用它将 Strands Agent 部署到 Amazon Bedrock AgentCore Runtime。

CDK

系统会为您的代理生成一个 CDK 构造，其名称基于您运行生成器时选择的 name，或默认为 <ProjectName>Agent。

您可以在 CDK 应用程序中使用此 CDK 构造：

import { MyProjectAgent } from ':my-scope/common-constructs';

export class ExampleStack extends Stack {
  constructor(scope: Construct, id: string) {
    new MyProjectAgent(this, 'MyProjectAgent');
  }
}

Alpha CDK构造

此构造使用 @aws-cdk/aws-bedrock-agentcore-alpha 模块。

Terraform

系统会为您生成一个 Terraform 模块，其名称基于您运行生成器时选择的 name，或默认为 <ProjectName>-agent。

您可以在 Terraform 项目中使用此 terraform 模块：

# Agent
module "my_project_agent" {
  # Relative path to the generated module in the common/terraform project
  source = "../../common/terraform/src/app/agents/my-project-agent"
}

Bedrock 模型权限

生成的代理构造默认授予调用所有 Bedrock 基础模型和推理配置文件的权限（对 arn:aws:bedrock:*:*:foundation-model/* 和 arn:aws:bedrock:*:*:inference-profile/* 的 bedrock:InvokeModel 和 bedrock:InvokeModelWithResponseStream 权限）。

您可能希望将其范围缩小到您的代理使用的特定模型。您可以在 Strands 文档中找到 Strands 代理使用的默认模型；有关配置不同模型的信息，请参阅 Strands 模型提供商指南。

需要Docker

构建和部署 Strands Agent 需要 Docker。请确保您已安装并启动 Docker，以避免出现如下错误：

ERROR: Cannot connect to the Docker daemon at unix://path/to/docker.sock.

身份验证

生成器提供了一个 auth 选项来配置 Strands Agent 的身份验证。您可以在生成代理时选择 IAM（默认）或 Cognito 身份验证。

IAM

默认情况下，您的 Strands Agent 将使用 IAM 身份验证进行保护，只需在不带任何参数的情况下部署它：

CDK

import { MyProjectAgent } from ':my-scope/common-constructs';

export class ExampleStack extends Stack {
  constructor(scope: Construct, id: string) {
    new MyProjectAgent(this, 'MyProjectAgent');
  }
}

您可以使用 grantInvokeAccess 方法授予调用 Bedrock AgentCore Runtime 上代理的访问权限，例如：

import { MyProjectAgent } from ':my-scope/common-constructs';

export class ExampleStack extends Stack {
  constructor(scope: Construct, id: string) {
    const agent = new MyProjectAgent(this, 'MyProjectAgent');
    const lambdaFunction = new Function(this, ...);

    agent.grantInvokeAccess(lambdaFunction);
  }
}

Terraform

# Agent
module "my_project_agent" {
  # Relative path to the generated module in the common/terraform project
  source = "../../common/terraform/src/app/agents/my-project-agent"
}

要授予调用代理的访问权限，您需要添加如下策略，引用 module.my_project_agent.agent_core_runtime_arn 输出：

{
  Effect = "Allow"
  Action = [
    "bedrock-agentcore:InvokeAgentRuntime"
  ]
  Resource = [
    module.my_project_agent.agent_core_runtime_arn,
    "${module.my_project_agent.agent_core_runtime_arn}/*"
  ]
}

Cognito 身份验证

当您选择 Cognito 身份验证时，生成器会配置代理使用 Cognito 进行身份验证。

CDK

生成的构造接受一个 identity 属性来配置 Cognito 身份验证：

import { MyProjectAgent, UserIdentity } from ':my-scope/common-constructs';

export class ExampleStack extends Stack {
  constructor(scope: Construct, id: string) {
    const identity = new UserIdentity(this, 'Identity');

    new MyProjectAgent(this, 'MyProjectAgent', {
      identity,
    });
  }
}

UserIdentity 构造可以使用 ts#react-website#auth 生成器生成，或者您可以创建自己的 CDK UserPool 和 UserPoolClient。

Terraform

生成的模块接受 user_pool_id 和 user_pool_client_ids 变量用于 Cognito 身份验证：

module "user_identity" {
  source = "../../common/terraform/src/core/user-identity"
}

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

  user_pool_id         = module.user_identity.user_pool_id
  user_pool_client_ids = [module.user_identity.user_pool_client_id]
}

自定义OIDC提供者

如果您需要使用非 Cognito OIDC 提供商的自定义 JWT 身份验证，您可以直接修改为您的代理生成的 CDK 构造或 Terraform 模块。请注意，连接生成器仅支持 IAM 或 Cognito 身份验证。

打包与Docker目标

为构建Bedrock AgentCore Runtime部署包，项目中添加了bundle目标：

• 使用uv export导出Python依赖到requirements.txt
• 使用uv pip install为目标平台（aarch64-manylinux_2_28）安装依赖

同时添加智能体专用的docker目标，将Dockerfile和打包构建产物复制到docker上下文目录。这使Dockerfile与构建输出位于同一位置，允许CDK使用AgentRuntimeArtifact.fromAsset直接构建Docker镜像。

可观测性

通过Dockerfile中的自动配置，使用AWS分布式OpenTelemetry（ADOT）实现可观测性。

在CloudWatch控制台选择”GenAI Observability”查看追踪数据，需启用事务搜索。

详细配置参考AgentCore可观测性文档。

调用Strands智能体

调用本地服务器

要调用通过<your-agent-name>-serve目标本地运行的智能体，可以向本地智能体运行端口的/invocations发送简单的POST请求。例如，使用curl：

curl -N -X POST http://localhost:8081/invocations \
  -d '{"message": "what is 3 + 5?"}' \
  -H "Content-Type: application/json"

Curl流式标志

传递给curl的-N参数禁用输出流缓冲，以便实时查看流式响应。

调用已部署的智能体

要调用部署到 Bedrock AgentCore Runtime 的 Agent,您可以使用 URL 编码的运行时 ARN 向 Bedrock AgentCore Runtime 数据平面端点发送 POST 请求。

您可以按如下方式从基础设施中获取运行时 ARN:

CDK

import { CfnOutput } from 'aws-cdk-lib';
import { MyProjectAgent } from ':my-scope/common-constructs';

export class ExampleStack extends Stack {
  constructor(scope: Construct, id: string) {
    const agent = new MyProjectAgent(this, 'MyProjectAgent');

    new CfnOutput(this, 'AgentArn', {
      value: agent.agentCoreRuntime.agentRuntimeArn,
    });
  }
}

Terraform

# Agent
module "my_project_agent" {
  # Relative path to the generated module in the common/terraform project
  source = "../../common/terraform/src/app/agents/my-project-agent"
}

output "agent_arn" {
  value = module.my_project_agent.agent_core_runtime_arn
}

ARN 将具有以下格式:arn:aws:bedrock-agentcore:<region>:<account>:runtime/<agent-runtime-id>。

然后,您可以通过将 : 替换为 %3A 和将 / 替换为 %2F 来对 ARN 进行 URL 编码。

浏览器控制台

在浏览器控制台或 Node REPL 中使用内置的 encodeURIComponent 方法可以轻松实现:

encodeURIComponent('arn:aws:bedrock-agentcore:<region>:<account>:runtime/<agent-runtime-id>')

用于调用 agent 的 Bedrock AgentCore Runtime 数据平面 URL 如下:

https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations

调用此 URL 的具体方式取决于所使用的身份验证方法。

IAM认证

对于IAM认证，请求必须使用AWS Signature Version 4（SigV4）签名。

acurl <region> bedrock-agentcore -N -X POST \
'https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations' \
-d '{"message": "what is 3 + 5?"}' \
-H 'Content-Type: application/json'

点击此处了解配置上述acurl命令的更多详情

JWT / Cognito认证

对于Cognito认证，在Authorization标头中传递Cognito访问令牌：

curl -N -X POST 'https://bedrock-agentcore.<region>.amazonaws.com/runtimes/<url-encoded-arn>/invocations' \
  -d '{"message": "what is 3 + 5?"}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access-token>"

可使用AWS CLI的cognito-idp admin-initiate-auth命令获取访问令牌，例如：

aws cognito-idp admin-initiate-auth \
  --user-pool-id <user-pool-id> \
  --client-id <user-pool-client-id> \
  --auth-flow ADMIN_NO_SRP_AUTH \
  --auth-parameters USERNAME=<username>,PASSWORD=<password> \
  --region <region> \
  --query 'AuthenticationResult.AccessToken' \
  --output text

浏览器 / React网站

要从React网站调用Strands智能体，可以使用connection生成器，它会自动设置具有正确认证方式（IAM或Cognito）的客户端。

VSCode

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

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

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

关于连接设置的详细信息，请参考connection生成器指南。

将A2A智能体作为工具调用

要将工作从此智能体委托给远程A2A智能体（TypeScript或Python），请使用connection生成器。它为目标智能体提供SigV4认证的客户端，并对此智能体的agent.py进行AST转换，将远程A2A智能体注册为@tool装饰的委托。

VSCode

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

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

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

关于连接设置的详细信息，请参考connection生成器指南。