agentcore-samples

环境要求

• Node.js 与 npm（用于全局安装 AgentCore CLI）
• 可用的 AWS 账号及 AWS 凭证（部署与 Notebook 运行都需要）
• Python 环境（运行仓库中的 Jupyter Notebook 样例）
• 已安装 Jupyter Notebook 及相关依赖

安装与启动步骤

1. 1安装 AgentCore CLI

   README 推荐的官方方式，用 npm 全局安装 CLI，用于创建、开发和部署智能体

   npm install -g @aws/agentcore

   复制

2. 2创建智能体项目

   README 该步骤标题为 Install the CLI and Create a Project，但未给出创建命令，需参考 CLI 仓库文档

3. 3配置 AWS 凭证

   README 要求在运行/部署前导出或激活所需 AWS 凭证，具体命令未在 README 中给出

4. 4部署到 AgentCore

   使用 CLI 把智能体部署到 Amazon Bedrock AgentCore，需要先完成凭证配置

   agentcore deploy

   复制

5. 5调用已部署智能体

   部署完成后用 CLI 直接测试调用效果，确认智能体在云上可正常工作

   agentcore invoke

   复制

6. 6创建虚拟环境

   运行仓库中 Jupyter Notebook 样例前，先建立并激活 Python 虚拟环境

   python -m venv .venv
   source .venv/bin/activate

   复制

7. 7安装 Notebook 依赖

   在已激活的虚拟环境中安装仓库 requirements.txt 里的所有依赖包

   pip install -r requirements.txt

   复制

8. 8注册内核并运行 Notebook

   把虚拟环境注册为 Jupyter 内核，再运行样例 Notebook，并注意选择正确内核

   python -m ipykernel install --user --name=notebook-venv --display-name="Python (notebook-venv)"
   jupyter kernelspec list
   jupyter notebook path/to/your/notebook.ipynb

   复制

如何确认成功

agentcore invoke 能返回智能体响应即部署成功；Notebook 中内核选为 Python (notebook-venv) 后能正常跑通。

常见问题

注意事项

• README 节选中 CLI 步骤只给出了安装（npm install -g @aws/agentcore）与部署/调用命令，创建项目的具体命令缺失。
• 本仓库为示例集合，README 未提供仓库克隆命令，请自行从 GitHub 获取样例目录。
• Notebook 样例在运行前必须先导出/激活 AWS 凭证，否则相关调用会失败。
• Notebook 打开后务必手动把内核切换为 Python (notebook-venv)，否则虚拟环境中的包不可见。