通用型智能体指南

什么是通用型智能体

通用型智能体是专为复杂任务场景设计的智能体类型。系统会为通用型智能体分配独立的执行电脑（沙箱环境），使其能够执行代码、访问文件系统、进行深度操作等。

前提条件：使用通用型智能体前，需要先部署智能体电脑服务。详细部署步骤请参考：智能体电脑部署指南

任务型 vs 问答型

特性	通用型智能体	问答型智能体
执行环境	独立电脑沙箱	无独立环境
响应速度	较慢（需要启动沙箱）	快速
资源消耗	高（需4G+内存、2核+CPU）	低
技能支持	✅ 支持	❌ 不支持
子智能体	✅ 支持	❌ 不支持
代码执行	✅ 支持	❌ 不支持
文件操作	✅ 支持	❌ 不支持
联网能力	✅ 支持	需插件支持
适用场景	复杂任务、开发、分析	知识问答、客服

适用场景

通用型智能体特别适合以下场景：

应用开发：编写、调试、运行代码
深度调研：多轮搜索、数据整理、报告生成
数据分析：处理数据文件、生成图表
演示文稿制作：制作PPT、设计文档
文件处理：批量转换、格式处理
自动化任务：定时执行复杂操作流程

创建通用型智能体

1. 创建智能体

打开工作空间，在"智能体开发"中，点击"创建智能体"，选择任务型。

2. 配置系统提示词

创建成功后会跳转到智能体编排页面，配置系统提示词。通用型智能体的提示词需要明确指定：

任务目标和要求
输出格式规范
文件操作需求
代码执行说明

官方Nuwax智能体提示词示例：

你是Nuwax，一个综合AI助手，可以帮助用户完成应用开发、报告生成、文档处理、数据分析等复杂任务。

# 网页设计要求
- 使用Tailwind CSS (使用CDN加速地址：<link rel="stylesheet" href="https://static-resources.nuwax.com/tailwind.min.css">)提高代码效率。
- 使用CSS样式美化不同模块的样式，可以使用javascript来增强与用户的交互，使用Echart（使用CDN加速地址：<script type="text/javascript" src="https://static-resources.nuwax.com/echarts.min.js"></script>）工具体现数据与数据变化趋势。
- 不要使用googleapis.com相关地址，如果需要用到谷歌字体请引用 <link rel="stylesheet" href="https://static-resources.nuwax.com/g-fonts.css"> 或<link href="https://static-resources.nuwax.com/g-fonts.css" rel="stylesheet">
- 当需要开发网页或生成报告时，请使用 frontend-design 技能来完成开发。
- 完整性： HTML 页面应包含<任务内容>中所有重要的内容信息。
- 逻辑性： 报告各部分之间应保持逻辑联系，确保读者能够理解报告的整体思路。
- 输出的HTML网页应包含上述内容，并且应该是可交互的，允许用户查看和探索数据。
- 在用户没有特别要求时，结果输出的文件尽量使用html单页面（包含js、css），为了使结果更加丰富，可以生成中间临时文件，最终合并成完整页面。

# 报告生成要求
- 数据准确性： 报告中的所有数据和结论都应基于提供的信息，不要编造未提供的数据内容，避免误导性信息。
- 明确的数据引用来源，在相关数据后面增加引用链接 <a href="引用链接">[引用编号]</a>
示例
跨年夜12万人齐聚...<a href="引用链接">[引用编号]</a>

# 数据采集要求
- 数据采集使用子任务完成，避免主Loop的上下文窗口被占满，过程数据可以边收集边总结成临时结果文件。
- 当需要获取数据时，请使用浏览器相关工具进行获取。
- 尽量使用中国大陆的网站进行数据检索，不要访问中国大陆无法访问的网站。
- 数据搜索时，可以使用 cn.bing.com

# 依赖安装要求
- 当需要安装node依赖时，请使用 pnpm，例如 pnpm install playwright

# 文件上传
在某些工具传入的参数需要URL时，可以使用以下接口，记住，以下接口返回的内容有效期仅为1小时，慎用。
接口地址：https://tools-api.nuwax.com/api/file/upload
form字段为 file
示例：
formData.append('file', fileBlob, filename);
let uploadResponse = await fetch(`https://tools-api.nuwax.com/api/file/upload`, {
method: 'POST',
body: formData
});

# 其他
- 你的工作目录在互联网上的根路径为：https://agent.nuwax.com/api/computer/static/{{CONVERSATION_ID}}/
- 不要把 https://agent.nuwax.com/api/computer/static/{{CONVERSATION_ID}}/ 开头的链接直接发给用户。
- 网页中引用工作目录下的内容时，路径不要携带工作目录（/home/user/{{CONVERSATION_ID}}/），例如：https://agent.nuwax.com/api/computer/static/{{CONVERSATION_ID}}/sample.png
- 不要在对话中暴露工作目录 /home/user/{{CONVERSATION_ID}}/
- 图片展示： ![](图片链接)，图片链接可能包含认证信息不要丢失
- 音视频处理使用 ffmpeg
- 再次强调：当需要开发网页或生成报告时，请使用 frontend-design 技能来完成开发。

3. 添加技能 [推荐]

**技能（Skills）**是通用型智能体的核心能力之一。技能包含指令、脚本和资源，可以显著提升智能体在专门任务上的性能。

技能管理

什么是技能？

技能教会智能体如何以可重复的方式完成特定任务，例如：

按照公司品牌指南创建文档
使用组织特定的工作流程分析数据
自动化个人任务
代码解释、文档生成、数据处理等

添加技能

在智能体编排页面，找到技能卡片
点击添加按钮，从技能库中选择合适的技能
技能添加后，智能体会根据任务自动选择使用

添加技能

技能优势

特定任务性能提升：为专门任务提供专业能力
组织知识捕获：将工作流程、最佳实践打包复用
易于定制：通过 Markdown 编写，无需编码
动态加载：智能体根据任务自动应用相关技能

详细技能管理请参考：技能管理文档

4. 配置工具能力

除了技能外，通用型智能体还默认具备以下能力：

代码执行：支持Python、JavaScript等多种语言
文件操作：读取、写入、转换文件
终端操作：执行shell命令
网络访问：联网搜索、API调用

可根据任务需求添加其他插件能力（如联网搜索、邮件发送等）。

5. 发布智能体

配置完成后，点击"发布"按钮，使智能体生效。

使用通用型智能体

基础对话

在空间广场中打开发布的通用型智能体，直接发送任务需求。

请根据这个数据文件，分析2025年手机市场情况

基础对话

示例结果查看

查看执行过程

通用型智能体执行时可以查看：

代码执行日志
文件操作记录
终端输出信息

获取结果

任务完成后，智能体会返回：

分析结果
生成的文件
可视化图表
操作总结

最佳实践

1. 提示词编写

明确指定输入输出格式
说明数据处理步骤
定义异常处理方式
设置合理的超时时间

2. 资源管理

通用型智能体默认分配 4G 内存、2 核 CPU
可在系统配置中调整资源配额
大数据任务建议分批处理

3. 安全建议

不要在提示词中暴露敏感信息
定期清理沙箱环境
对文件上传进行大小限制

4. 性能优化

简化任务流程，减少不必要的操作
使用缓存机制避免重复计算
合理设置并发任务数量

注意事项

模型选择

通用型智能体目前支持以下模型协议：

Anthropic 协议：支持国内各家的编程套餐

DeepSeek：DeepSeek 系列（文档）
Moonshot：kimi-k2（文档）
字节跳动：doubao-seed-code（文档）
智谱 GLM：GLM 系列（文档）

注意：非编程套餐的 Anthropic 协议接口，需要在添加模型时的模型描述中增加 use nuwax_cli 指令。

OpenAI 协议：基本都支持（需支持流式函数调用）

提示：配置模型时，请确保选择的模型支持相应协议，并在模型设置中正确配置 API 地址和密钥。同时注意设置足够大的最大输出token，否则可能导致智能体无法完整执行并输出结果。

资源限制

每个通用型智能体需要独立的沙箱环境
服务器资源有限，请合理规划智能体数量
大文件处理可能需要较长时间

执行时间

任务执行时间取决于任务复杂度
简单任务：1-3分钟
复杂任务：5-15分钟
超时任务会自动终止

数据安全

沙箱环境每次任务后重置
重要文件请及时下载保存
不建议在沙箱中存储敏感数据

常见问题

Q: 通用型智能体启动很慢怎么办？

A: 首次启动需要初始化沙箱环境，耗时约1-2分钟。后续启动会复用已有环境，速度较快。

Q: 如何查看智能体执行的代码？

A: 在对话界面点击"查看详情"，可以进入远程桌面查看完整的执行过程和代码。

Q: 文件大小有限制吗？

A: 建议单文件不超过100MB，大文件处理会占用较多内存和时间。

Q: 可以同时运行多个任务吗？

A: 可以，但受服务器资源限制。默认每台沙箱服务器支持20个并发用户，可在系统配置中调整。

Q: 任务失败了怎么办？

A: 查看执行日志定位问题，可以调整提示词后重试。如持续失败，请联系管理员检查沙箱服务状态。

通用型智能体指南 ​

什么是通用型智能体 ​

任务型 vs 问答型 ​

适用场景 ​

创建通用型智能体 ​

1. 创建智能体 ​

2. 配置系统提示词 ​

3. 添加技能 [推荐] ​

什么是技能？ ​

添加技能 ​

技能优势 ​

4. 配置工具能力 ​

5. 发布智能体 ​

使用通用型智能体 ​

基础对话 ​

查看执行过程 ​

获取结果 ​

最佳实践 ​

1. 提示词编写 ​

2. 资源管理 ​

3. 安全建议 ​

4. 性能优化 ​

注意事项 ​

模型选择 ​

资源限制 ​

执行时间 ​

数据安全 ​

常见问题 ​

相关文档 ​

通用型智能体指南

什么是通用型智能体

任务型 vs 问答型

适用场景

创建通用型智能体

1. 创建智能体

2. 配置系统提示词

3. 添加技能 [推荐]

什么是技能？

添加技能

技能优势

4. 配置工具能力

5. 发布智能体

使用通用型智能体

基础对话

查看执行过程

获取结果

最佳实践

1. 提示词编写

2. 资源管理

3. 安全建议

4. 性能优化

注意事项

模型选择

资源限制

执行时间

数据安全

常见问题

相关文档