创建代码解释器

创建沙箱工具允许用户在安全的环境中测试和验证智能体的功能，确保在实际部署前能够发现和解决问题。代码解释器能够理解并解释代码的逻辑，帮助用户更好地理解代码的运行机制和功能。

创建代码解释器有两种方式：

• 通过控制台创建代码解释器
• 通过SDK创建代码解释器

1. 在左侧导航栏选择“托管与运行 > 代码解释器”，进入代码解释器界面。
2. 单击右上角“创建代码解释器”。
3. 在“创建代码解释器”的弹框中，输入相关配置信息，参数说明请参考表2，配置完成后单击“立即创建”。

   表2 参数说明

   参数		说明
   基本信息	名称	工具的名称，同一账号下沙箱工具名称不可重复，创建后不支持修改。 命名规则： 以小写字母开头，小写字母或数字结尾。 名称中可包含数字、字母、中划线。 长度为2~40个字符。 系统会默认生成工具的名称，可根据需求自定义修改。
   	描述	用于对工具内容和用途的简要说明。 规则：长度不大于4096个字符。
   权限与身份认证	委托	（可选）授予的代理权限或代理功能，允许代表智能体与外部系统进行通信和交互。 可不填写，如需手动创建，请单击“创建委托”并参考如下配置创建。 委托名称：自定义。 信任主体类型：选择“云服务”。 云服务：搜索service.WorkloadSandboxMetadata。 其余参数使用默认值。 图2 创建委托 委托创建完成后可对委托进行授权，操作具体详情请参考创建委托并授权。
   	入站身份认证	配置代码解释器的身份认证方式。入站身份认证是指代码解释器在接收和处理来自智能体或SDK的请求时，对请求进行身份验证，确保只有经过验证的请求才能访问沙箱工具中的资源，提高系统的安全性和可靠性。 支持以下认证方式： IAM认证：将华为云IAM身份配置为入站身份认证，以验证调用者的身份。 API Key认证：通过接口的访问密钥进行身份验证和授权。系统会自动生成API Key的名称，可根据需求自定义修改。 身份认证凭证在凭据管理服务（DEW）托管，托管按需计费，费用说明请参考DEW 计费说明。
   可观测配置	日志记录	未开启，工具运行过程产生的日志无法上报至云日志服务。 开启后，工具运行过程产生的日志会上报云日志服务（LTS），日志管理费用按需收取，有关计费相关内容请参考LTS计费详情。
   高级配置	出网网络配置	公网访问：能够连接到外部的互联网，访问外部的资源和服务。 私网访问：能够连接到内部的私有网络，访问内部的资源和服务。 当选择“私网访问”时，需配置如下参数： 选择已配置的VPC，如未配置，请单击“新建VPC”，具体请参考创建虚拟私有云和子网。 选择已配置的子网，如未配置，请单击“新建子网”，具体请参考创建虚拟私有云和子网。 选择已配置的安全组，如未配置，请单击“新建安全组”，具体请参考创建安全组。 配置后单击刷新。
   	标签 (可选)	由“标签键”和“标签值”组成，用于标识和分类云资源。 您可以在TMS中创建预定义标签，用于使用同一标签标识多种云资源，创建后可在标签输入框下拉选择同一标签，具体操作请参考创建预定义标签，创建后单击刷新。 单击“添加标签”，选择在TMS中创建的预定义标签，或自定义输入标签键和标签值。 可添加一个或多个标签，最多添加20个标签。

在Python文件中通过SDK创建代码解释器，相关参数说明以及配置示例如下：

• 方法名：create_code_interpreter
• 配置以下参数：

  参数名	类型	描述
  name	str	Required code_interpreter名称。
  auth_type	str	认证类型，支持 "API_KEY" 或 "IAM"，默认 "API_KEY"。
  api_key_name	str	Required API Key名称。
  description	str	代码解释器的描述。Default：None
  execution_agency_name	str	为代码解释器提供访问云服务的权限的IAM委托名。Default：None
  observability	Dict	可观测性配置（日志+指标）。Default：None
  network_config	Dict	出站网络配置。Default：None
  agent_gateway_id	str	Agent Gateway ID。Default： None
  tags	List	标签列表。Default：None

• 返回值如下：
  包含代码解释器信息的字典，包括：

  • id (str): 代码解释器的ID。
  • name (str): 代码解释器的名称。该名称在您的账户中必须是唯一的。
  • description (str): 代码解释器的描述，用于LLM上下文分析。
  • created_at (str): 创建时间。
  • updated_at (str): 更新时间。
  • execution_agency_name(str): IAM委托名。
  • agent_gateway_id (str): Agent Gateway ID。
  • workload_identity (Dict): 认证信息。
  • observability (Dict): 可观测性配置（日志+指标）。
  • access_endpoint(str): 访问域名。
  • tags(List): 标签列表。
  • network_config(Dict): 出站网络配置。

from agentarts.sdk.tools import CodeInterpreter
demo_client = CodeInterpreter(region="your_region", auth_type="API_KEY")
code_interpreter = demo_client.create_code_interpreter(
    name="your_code_interpreter_name",
    api_key_name="your_api_key_name"
)

IAM代码示例：

from agentarts.sdk.tools import CodeInterpreter
demo_client = CodeInterpreter(region="your_region", auth_type="IAM")
code_interpreter = client.create_code_interpreter(
    name="your_code_interpreter_name",
    auth_type="IAM"
    )