本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 开始使用 AgentCore 代码解释器
<a name="code-interpreter-getting-started"></a>

AgentCore 代码解释器使您的代理能够在安全的托管环境中执行 Python 代码。该代理可以执行计算、分析数据、生成可视化效果，并通过执行代码来验证答案。

本页介绍了先决条件，并提供了两种入门方法：
+  **使用 Amazon Strands **-一种高级代理框架，通过内置工具集成、对话管理和自动会话处理来简化 AI 代理的构建。
+  **直接使用 **-SDK 和 Boto3 方法，为自定义实现提供对会话管理和代码执行的更多控制。

**Topics**
+ [先决条件](#code-interpreter-prerequisites)
+ [配置凭证](#code-interpreter-credentials-config)
+ [通过以下方式使用 AgentCore 代码解释器 Amazon Strands](code-interpreter-using-strands.md)
+ [直接使用 AgentCore 代码解释器](code-interpreter-using-directly.md)

## 先决条件
<a name="code-interpreter-prerequisites"></a>

在开始之前，请确保您有：
+  Amazon 配置了凭据的账户。请参阅[配置您的证书](#code-interpreter-credentials-config)。
+ 已安装 Python 3.10\+
+ Boto3 已安装。请参阅 [ Boto3 文档。](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)
+ 具有所需权限的 IAM 执行角色。请参阅[配置您的证书](#code-interpreter-credentials-config)。
+ 模型访问权限：亚马逊 Bedrock 控制台[中](https://docs.amazonaws.cn/bedrock/latest/userguide/model-access-modify.html)启用了 Anthropic Claude Sonnet 4.0。有关在 Strands 代理中使用其他模型的信息，请参阅 Strands Agent [ s SDK 文档中的*模型提供者*部分。](https://strandsagents.com/latest/documentation/docs/)
+  Amazon 亚马逊 Bedrock 可用 AgentCore 的地区。请参阅[支持的 Amazon 区域](agentcore-regions.md)。

## 配置凭证
<a name="code-interpreter-credentials-config"></a>

执行以下步骤来配置您的 Amazon 证书并附加所需的权限。

1.  **验证您的 Amazon 证书 ** 

   确认您的 Amazon 证书已配置：

   ```
   aws sts get-caller-identity
   ```
**注意**  
记下此处返回的用户或证书，因为您将在附加所需权限时使用它。

   如果此命令失败，请配置您的证书。有关更多信息，请参阅 C Amazon LI [ 中的](https://docs.amazonaws.cn/cli/latest/userguide/cli-configure-files.html)配置和凭据文件设置。

1.  **附上所需的权限 ** 

   您的 IAM 用户或角色需要权限才能使用 AgentCore 代码解释器。将此政策附加到您的 IAM 身份：
**注意**  
在以下政策中`<region>`替换为您选择的地区（例如`us-west-2`）和`<account_id>`您的 Amazon 账户 ID：

   ```
   {
       "Version":"2012-10-17",	
       "Statement": [
           {
               "Sid": "BedrockAgentCoreCodeInterpreterFullAccess",
               "Effect": "Allow",
               "Action": [
                   "bedrock-agentcore:CreateCodeInterpreter",
                   "bedrock-agentcore:StartCodeInterpreterSession",
                   "bedrock-agentcore:InvokeCodeInterpreter",
                   "bedrock-agentcore:StopCodeInterpreterSession",
                   "bedrock-agentcore:DeleteCodeInterpreter",
                   "bedrock-agentcore:ListCodeInterpreters",
                   "bedrock-agentcore:GetCodeInterpreter",
                   "bedrock-agentcore:GetCodeInterpreterSession",
                   "bedrock-agentcore:ListCodeInterpreterSessions"
               ],
               "Resource": "arn:aws:bedrock-agentcore:<region>:++<account_id>++:code-interpreter/*"
           }
       ]
   }
   ```

 **附上此政策 ** 

按照以下步骤进行操作：

1. 转到 IAM 控制台。

1. 从 `get-caller-identity` API 操作返回的响应中查找您的用户或角色。

1. 选择 “**添加权限”**，然后选择 “**创建内联策略” ** 

1. 切换到 JSON 视图并粘贴上面的政策

1. 给它命名`AgentCoreCodeInterpreterAccess`然后保存

**注意**  
如果您要向 Amazon Bedrock AgentCore Runtime 部署代理，则还需要使用服务信任策略创建 IAM 执行角色。有关更多信息，请参阅 AgentCore Runtime [ 入门](runtime-getting-started.md)。

以下各节向您展示如何在代理框架和不带代理框架的情况下使用 Amazon Bedrock AgentCore 代码解释器。当你想以编程方式执行特定的代码片段时，在没有代理框架的情况下直接使用代码解释器特别有用。