准备环境

首先，你需要一个 AWS 账号（亚马逊云服务账号）。如果你还没有，去 aws.amazon.com 注册，免费套餐足够入门。然后，在电脑上安装 AWS CLI（命令行工具，用来和 AWS 交互）和 Python 3.9+（编程语言）。

• 下载 AWS CLI：访问 AWS CLI 官网，根据你的系统（Windows/Mac/Linux）下载安装包，一路默认安装。
• 安装 Python：去 python.org 下载最新版，安装时勾选“Add Python to PATH”。
• 配置 AWS CLI：打开终端（Windows 用 cmd 或 PowerShell），输入 aws configure，按提示输入你的 Access Key ID 和 Secret Access Key（在 AWS 控制台“我的安全凭证”里生成）。区域选 us-east-1 或离你近的。

安装 Amazon Bedrock AgentCore

Amazon Bedrock AgentCore 是 AWS 的一个服务，帮你快速搭建 AI 代理（可以理解成能调用工具的智能助手）。我们用 Python 的 SDK（软件开发工具包）来操作它。

1. 打开终端，运行 pip install boto3 安装 AWS 的 Python SDK。
2. 创建一个新文件夹，比如 my_agent，在里面新建文件 agent.py。
3. 用文本编辑器打开 agent.py，复制下面代码：

   import boto3
   client = boto3.client('bedrock-agent-runtime')
   response = client.invoke_agent(
       agentId='你的代理ID',
       agentAliasId='你的别名ID',
       sessionId='test-session',
       inputText='今天天气怎么样？'
   )
   print(response)

4. 但先别运行，我们还需要创建一个代理并获取 ID。去 AWS 控制台搜索“Bedrock”，进入后左侧点“Agents”，点击“Create Agent”。名称填 MyFirstAgent，基础模型选 Claude 3 Haiku（便宜又快），指令写“你是一个助手，可以用网页搜索回答实时问题”。
5. 创建后，在代理详情页找到“Agent ID”和“Agent Alias ID”，复制到代码中替换。

添加网页搜索工具并验证

现在给代理加上 Web Search 工具（让代理能查实时信息）。

• 在代理编辑页面，点击“Add tool”，选择“Web Search”，然后保存并创建别名。
• 回到终端，运行 python agent.py。如果看到返回的 JSON 结果，说明代理成功调用了网页搜索。
• 常见坑：如果报错 AccessDeniedException，说明你的 IAM 用户缺少权限。去 AWS 控制台 IAM 服务，给用户附加 AmazonBedrockFullAccess 策略。

下一步可以做什么

你已经跑通了第一个 AI 代理！接下来可以：

• 修改 inputText 问不同问题，比如“2026年世界杯在哪举办”。
• 学习如何用 LangChain（一个 AI 编程框架）把多个工具组合起来。
• 注意：免费套餐有调用次数限制，用多了会收费，记得看 AWS 账单。