沙箱工具介绍

什么是沙箱工具

沙箱工具是我们为Agent提供的在安全的沙箱环境中运行的技能增强包。通过代码解释器等原生工具，Agent能够超越纯文本对话，具备处理复杂逻辑计算 、实时信息获取乃至跨系统操作的能力。所有工具均运行在受控的沙箱环境中，确保执行过程的高效与安全。

应用场景

为Agent提供在安全、隔离的代码执行环境中运行的内置工具，使其能够调用安全隔离的运行环境，完成代码执行、文件管理、系统命令执行等复杂任务，从而赋予智能体安全可控的自动化执行能力。

工作原理

图1 工作原理

1. Agent/SDK：应用程序或客户端通过Agent或SDK发起请求。
2. 网关：Agent/SDK发起的请求首先会到达网关。网关作为系统的入口，负责接收和处理来自客户端的所有请求。
3. inbound认证：请求通过网关后，会进入inbound认证阶段。在此阶段，系统会对请求进行身份验证和授权检查，确保请求来自合法的用户或服务。只有通过认证的请求才能继续向下传递。
4. 沙箱工具：通过inbound认证的请求最终会到达沙箱工具。沙箱工具是一个隔离的环境，用于在不影响生产环境的情况下测试和验证代码、功能或服务。它可以模拟真实的运行环境，提供安全的测试平台，帮助开发人员调试和优化应用程序。
5. 响应：沙箱工具处理完请求后，会生成相应的响应，并通过网关返回给Agent/SDK。响应可能包含测试结果、错误信息或其他相关数据，帮助开发人员了解请求的处理情况。

使用流程

1. 创建工具：当前仅支持创建代码解释器工具，并支持配置访问权限和网络设置，确保代码在受控的隔离环境中执行。具体请参见创建沙箱工具。
2. 在智能体中集成工具：将工具集成至智能体代码，可让智能体调用隔离环境完成代码运行等复杂任务。具体请参见在智能体中集成沙箱工具。
3. 查看工具日志：在工具详情页面，您可以查看代码解释器在使用过程中产生的日志。具体请参见查看代码解释器日志。