Bedrock AgentCore SDK

无需任何基础设施，即可将您的本地 AI 助手部署至 Bedrock AgentCore

文档 ◆ 示例 ◆ Discord ◆ Boto3 Python SDK ◆ 运行时 Python SDK ◆ 入门工具包

概述

Amazon Bedrock AgentCore 让您能够使用任意框架和模型，安全、大规模地部署和运营高效智能体。借助 Amazon Bedrock AgentCore，开发者可以快速将 AI 智能体投入生产环境，同时确保其具备实际部署所需的规模、可靠性和安全性。AgentCore 提供了提升智能体效能的工具与能力，专为安全扩展而构建的基础架构，以及用于管理可信智能体的控制机制。Amazon Bedrock AgentCore 服务具有可组合性，兼容主流开源框架和各类模型，因此您无需在开源灵活性与企业级安全可靠性之间做出取舍。

🚀 从本地开发到 Bedrock AgentCore

from bedrock_agentcore import BedrockAgentCoreApp
app = BedrockAgentCoreApp()

from strands import Agent # 或者使用您自己的智能体。

@app.entrypoint
async def handler(request):
    prompt = request.get("prompt")

    agent = Agent()

    async for event in agent.stream_async(prompt):
        yield (event)

app.run()

使用 Bedrock AgentCore 您将获得：

• ✅ 保留您的智能体逻辑 - 兼容 Strands、LangGraph、CrewAI、Autogen 或自定义框架
• ✅ 无需管理基础设施 - 无需服务器、容器或考虑扩缩容问题
• ✅ 企业级平台 - 内置身份验证、记忆存储、可观ability 和安全保障
• ✅ 生产就绪的部署 - 可靠、可扩展且符合合规要求的托管服务

Amazon Bedrock AgentCore 服务

• 🚀 运行时 - 安全且会话隔离的计算资源：运行时快速入门
• 🧠 记忆存储 - 跨会话的持久化知识：记忆存储快速入门
• 🔗 网关 - 将 API 转换为 MCP 工具：网关快速入门
• 💻 代码解释器 - 安全的沙箱执行环境：代码解释器快速入门
• 🌐 浏览器 - 基于云的网页自动化：浏览器快速入门
• 📊 可观ability - OpenTelemetry 追踪：可观ability 快速入门
• 🔐 身份验证 - AWS 及第三方身份验证：身份验证快速入门

AG-UI 协议支持

使用 AG-UI 协议，无需任何样板代码即可部署智能体。只需一个 entrypoint 处理程序，即可通过 SSE（POST /invocations）和 WebSocket（/ws）提供服务。

from bedrock_agentcore.runtime import serve_ag_ui

# 具有 .run() 方法的框架智能体 —— 一行代码
serve_ag_ui(agui_agent)

或者使用装饰器形式编写自定义智能体：

from bedrock_agentcore.runtime import AGUIApp
from ag_ui.core import RunAgentInput, RunStartedEvent, RunFinishedEvent

app = AGUIApp()

@app.entrypoint
async def my_agent(input_data: RunAgentInput):
    yield RunStartedEvent(thread_id=input_data.thread_id, run_id=input_data.run_id)
    # ... 您的智能体逻辑，产出 AG-UI 事件 ...
    yield RunFinishedEvent(thread_id=input_data.thread_id, run_id=input_data.run_id)

app.run()

安装命令：pip install "bedrock-agentcore[ag-ui]"

完整详情请参阅 AG-UI 协议规范。

🏗️ 部署

快速入门： 使用 Bedrock AgentCore 入门工具包，实现快速原型设计。

生产环境： AWS CDK。

A2A 协议支持

在 Bedrock AgentCore 运行时上，使用 A2A（智能体间）协议 为您的智能体提供服务。该协议适用于任何提供 a2a-sdk AgentExecutor 的框架（Strands、LangGraph、Google ADK 或自定义框架）。

pip install "bedrock-agentcore[a2a]"

from strands import Agent
from strands.a2a import StrandsA2AExecutor
from bedrock_agentcore.runtime import serve_a2a

agent = Agent(model="us.anthropic.claude-sonnet-4-20250514", system_prompt="您是一位乐于助人的助手。")
serve_a2a(StrandsA2AExecutor(agent))

有关 LangGraph、Google ADK 以及高级用法的示例，请参阅 A2A 协议示例。

📝 许可证与贡献

• 许可证: Apache 2.0 - 请参阅 LICENSE.txt
• 贡献: 请参阅 CONTRIBUTING.md
• 安全: 请通过 SECURITY.md 报告漏洞

Bedrock AgentCore SDK (Python) 快速上手指南

本指南帮助中国开发者快速将本地 AI Agent 部署到 Amazon Bedrock AgentCore，实现零基础设施管理的企业级部署。

环境准备

在开始之前，请确保满足以下要求：

• 操作系统: Linux, macOS 或 Windows
• Python 版本: 3.9 或更高版本
• AWS 凭证: 已配置 AWS CLI (aws configure) 或设置了 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量
• 依赖框架 (可选): 根据需求安装 Strands, LangGraph, CrewAI 等框架（示例中使用 Strands）

提示: 国内用户建议配置 pip 国内镜像源以加速安装：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

使用 pip 安装核心 SDK：

pip install bedrock-agentcore

如果您需要使用特定协议支持，可选择安装额外依赖：

• AG-UI 协议支持:

  pip install "bedrock-agentcore[ag-ui]"
  

• A2A (Agent-to-Agent) 协议支持:

  pip install "bedrock-agentcore[a2a]"
  

基本使用

以下是最简单的入门示例，展示如何将一个基于 Strands 框架的 Agent 部署到 Bedrock AgentCore。

1. 编写 Agent 代码

创建一个 Python 文件（例如 app.py），代码如下：

from bedrock_agentcore import BedrockAgentCoreApp
app = BedrockAgentCoreApp()

from strands import Agent # 或者引入您自己的 Agent 框架

@app.entrypoint
async def handler(request):
    prompt = request.get("prompt")

    agent = Agent()

    async for event in agent.stream_async(prompt):
        yield (event)

app.run()

2. 运行应用

在终端中直接运行该脚本：

python app.py

SDK 会自动处理与 Bedrock AgentCore 的连接，将您的本地逻辑转换为可扩展的云服务。

3. 进阶：使用 AG-UI 协议 (可选)

如果您希望利用标准的 AG-UI 协议通过 SSE 或 WebSocket 暴露 Agent，可以使用更简洁的写法：

from bedrock_agentcore.runtime import serve_ag_ui
from strands import Agent

# 初始化您的 Agent
agui_agent = Agent()

# 一行代码启动服务
serve_ag_ui(agui_agent)

4. 进阶：使用 A2A 协议 (可选)

若需实现 Agent 到 Agent 的通信：

from strands import Agent
from strands.a2a import StrandsA2AExecutor
from bedrock_agentcore.runtime import serve_a2a

agent = Agent(model="us.anthropic.claude-sonnet-4-20250514", system_prompt="You are a helpful assistant.")
serve_a2a(StrandsA2AExecutor(agent))

下一步: 完成本地测试后，建议使用 Bedrock AgentCore Starter Toolkit 进行快速原型开发，或使用 AWS CDK 进行生产环境部署。