沙箱工具介绍

什么是沙箱工具

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

应用场景

为Agent提供在安全、隔离的代码执行环境中运行的内置工具，使其具备运行代码、操作文件、执行系统命令的能力，从而支撑数据分析、自动化脚本、可视化报告生成等业务场景。

工作原理

图1 工作原理

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

使用流程

图2 使用流程

1. 创建工具：允许用户在安全的环境中测试和验证智能体的功能，确保在实际部署前能够发现和解决问题，当前仅支持创建代码解释器工具。具体请参见创建沙箱工具。
2. 在智能体中集成工具：将工具集成至智能体代码，可让智能体调用隔离环境完成代码运行等复杂任务。具体请参见在智能体中集成工具。
3. 管理工具：在工具详情页面，您可以查看网关在使用过程中产生的日志。具体请参见查看代码解释器日志。