
# 沙箱工具介绍
#### 什么是沙箱工具
沙箱工具是我们为Agent提供的在安全的沙箱环境中运行的技能增强包。通过代码解释器等原生工具，Agent能够超越纯文本对话，具备处理复杂逻辑计算 、实时信息获取乃至跨系统操作的能力。所有工具均运行在受控的沙箱环境中，确保执行过程的高效与安全。
#### 应用场景
为Agent提供在安全、隔离的代码执行环境中运行的内置工具，使其能够调用安全隔离的运行环境，完成代码执行、文件管理、系统命令执行等复杂任务，从而赋予智能体安全可控的自动化执行能力。
#### 工作原理
图1工作原理   
![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002569125581.png)
1. **Agent/SDK** **：**应用程序或客户端通过Agent或SDK发起请求。
2. **网关**：Agent/SDK发起的请求首先会到达网关。网关作为系统的入口，负责接收和处理来自客户端的所有请求。
3. **inbound认证**：请求通过网关后，会进入inbound认证阶段。在此阶段，系统会对请求进行身份验证和授权检查，确保请求来自合法的用户或服务。只有通过认证的请求才能继续向下传递。
4. **沙箱工具**：通过inbound认证的请求最终会到达沙箱工具。沙箱工具是一个隔离的环境，用于在不影响生产环境的情况下测试和验证代码、功能或服务。它可以模拟真实的运行环境，提供安全的测试平台，帮助开发人员调试和优化应用程序。
5. **响应**：沙箱工具处理完请求后，会生成相应的响应，并通过网关返回给Agent/SDK。响应可能包含测试结果、错误信息或其他相关数据，帮助开发人员了解请求的处理情况。
 
#### 使用流程
1. 创建工具：当前仅支持创建代码解释器工具，并支持配置访问权限和网络设置，确保代码在受控的隔离环境中执行。具体请参见[创建沙箱工具](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_011.html)。
2. 在智能体中集成工具：将工具集成至智能体代码，可让智能体调用隔离环境完成代码运行等复杂任务。具体请参见[在智能体中集成沙箱工具](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_012.html)。
3. 查看工具日志：在工具详情页面，您可以查看代码解释器在使用过程中产生的日志。具体请参见[查看代码解释器日志](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_013.html#agentarts_10_013__section1065455115154)。
 
