使用 SDK 集成将 AWS Strands Agent 与 AgentCore Runtime 集成的指南

Source: Dev.to

前置条件

有两种 AgentCore 的部署方式：

• SDK 集成 – 自动 HTTP 设置和内置部署选项。
• 自定义 – 手动配置。

SDK 集成

使用 SDK 将 AWS Strands Agent 与 AgentCore 运行时集成。

安装

pip install bedrock-agentcore

创建代理

from bedrock_agentcore.runtime import BedrockAgentCoreApp
from strands import Agent

app = BedrockAgentCoreApp()
agent = Agent()

@app.entrypoint
def invoke(payload):
    """Process user input and return a response."""
    user_message = payload.get("prompt", "Hello")
    result = agent(user_message)
    return {"result": result.message}

if __name__ == "__main__":
    app.run()

测试代理

在本地运行脚本：

python my_agent.py

使用 curl 测试端点：

curl -X POST http://localhost:8080/invocations \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello world!"}'

选择部署方式

使用 StarterToolkit（方法 1 – 快速原型）

目录结构：

your_project_directory/
│   __init__.py      # Makes the directory a Python package
│   requirements.txt

注意： agentcore launch --local 命令需要容器引擎（Docker、Finch 或 Podman）进行本地测试。此步骤为可选；如果不需要本地测试，可以直接跳过，使用 agentcore launch 进行 AWS 部署。

使用 Boto3（方法 2 – 手动部署）

为了更好地控制部署过程：

1. 将代码打包为容器镜像。
2. 将镜像推送到 Amazon Elastic Container Registry（ECR）。
3. 使用 Boto3 脚本或 AWS SDK 调用进行部署。