智能体开发
在智能体开发页面中，您可以创建、配置和管理智能体。智能体是 Nexent 的核心功能，它们能够理解您的需求并执行相应的任务。
🔧 创建智能体
在智能体管理页签下，点击"创建 Agent"即可创建一个空白智能体，点击"退出创建"即可退出创建模式。 如果您有现成的智能体配置，也可以导入使用：
- 点击"导入 Agent"
- 在弹出的文件选择对话框中选择智能体配置文件（JSON 格式）
- 点击"打开"按钮，系统会验证配置文件的格式和内容，并显示导入的智能体信息
⚠️ 提示：如果导入了重名的智能体，系统会弹出提示弹窗。您可以选择：
- 直接导入：保留重复名称，导入后的智能体会处于不可用状态，需手动修改智能体名称和变量名后才能使用
- 重新生成并导入：系统将调用 LLM 对智能体进行重命名，会消耗一定的模型 token 数，可能耗时较长
📌 重要说明：通过导入创建的智能体，如果其工具中包含
knowledge_base_search等知识库检索工具，这些工具只会检索当前登录用户在本环境中有权限访问的知识库。导入文件中原有的知识库配置不会自动继承，因此实际检索结果和回答效果，可能与智能体原作者环境下的表现存在差异。
👥 配置协作智能体/工具
您可以为创建的智能体配置其他协作智能体，也可以为它配置可使用的工具，以赋予智能体能力完成复杂任务。
🤝 协作 Agent
- 点击"协作 Agent"页签下的加号，弹出可选择的智能体列表
- 在下拉列表中选择要添加的智能体
- 允许选择多个协作智能体
- 可点击 × 取消选择此智能体
🛠️ 选择智能体的工具
智能体可以使用各种工具来完成任务，如知识库检索、文件解析、图片解析、收发邮件、文件管理等本地工具，也可接入第三方 MCP 工具，或自定义工具。
- 在"选择智能体的工具"页签右侧，点击"刷新工具"来刷新可用工具列表
- 选择想要添加工具所在的分组
- 查看分组下可选用的所有工具，可点击 ⚙️ 查看工具描述，进行工具参数配置
- 点击工具名即可选中该工具，再次点击可取消选择
- 如果工具有必备参数没有配置，选择时会弹出弹窗引导进行参数配置
- 如果所有必备参数已配置完成，选择则会直接选中
💡 小贴士：
- 请选择
knowledge_base_search工具，启用知识库的检索功能。- 请选择
analyze_text_file工具，启用文档类、文本类文件的解析功能。- 请选择
analyze_image工具，启用图片类文件的解析功能。📚 想了解系统已经内置的所有本地工具能力？请参阅 本地工具概览。
🔌 添加 MCP 工具
在"选择智能体的工具"页签右侧，点击"MCP 配置"，可在弹窗中进行 MCP 服务器的配置，查看已配置的 MCP 服务器
您可以通过以下两种方式在 Nexent 中添加 MCP 服务
1️⃣ 通过 URL 添加 MCP 服务
🔔 该方法适用于已有独立部署的 MCP 服务（支持 SSE 与 Streamble HTTP 协议）：
- 在界面上方的 Add MCP Server 区域填写 Server name 、 Server URL
⚠️ 注意：服务器名称只能包含英文字母和数字，不能包含空格、下划线等其他字符
- 点击 右侧 + Add 按钮，完成单个服务添加
2️⃣ 通过 JSON 配置添加容器化 MCP 服务
🔔 该方法适用于 npx 部署的容器化 MCP 服务
- 在 Add Containerized MCP Service 输入框中，填写符合示例格式的 JSON 配置
json{ "mcpServers": { "service-name": { "args": [ "mcp-package-name@version", "additional-parameters" ], "command": "npx" } } }
- 在下方 Port 输入框中，填写容器化服务对应的端口号
- 点击右侧 + Add 按钮，完成容器化服务添加
有许多第三方服务如 ModelScope 提供了 MCP 服务，您可以快速接入使用。 您也可以自行开发 MCP 服务并接入 Nexent 使用，参考文档 MCP 工具开发。
⚙️ 自定义工具
您可参考以下指导文档，开发自己的工具，并接入 Nexent 使用，丰富智能体能力。
🧪 工具测试
无论是什么类型的工具（内置工具、外部接入的 MCP 工具，还是自定义开发工具），Nexent 都提供了"工具测试"能力。如果您在创建智能体时不确定某个工具的效果，可以使用测试功能来验证工具是否按预期工作。
- 点击工具的小齿轮按钮 ⚙️，进入工具的详细配置弹窗
- 首先确保已经配置了工具的必备参数（带红色星号的参数）
- 在弹窗的左下角点击"工具测试"按钮
- 右侧会新弹出一个测试框
- 在测试框中输入测试工具的入参，例如：
- 测试本地知识库检索工具
knowledge_base_search时，需要输入：- 测试的
query，例如"维生素C的功效" - 检索的模式
search_mode（默认为hybrid） - 目标检索的知识库列表
index_names，如["医疗", "维生素知识大全"] - 若不输入
index_names，则默认检索知识库页面所选中的全部知识库
- 测试的
- 测试本地知识库检索工具
- 输入完成后点击"执行测试"开始测试，并在下方查看测试结果
📝 描述业务逻辑
✍️ 描述智能体应该如何工作
根据选择的协作智能体和工具，您现在可以用简洁的语言来描述，您希望这个智能体应该如何工作。Nexent 会根据您的描述，自动为您生成智能体配置以及提示词等信息。
- 在"描述智能体应该如何工作"下的编辑框中，输入简洁描述，如"你是一个专业的知识问答小助手，具备本地知识检索和联网检索能力，综合信息以回答用户问题"
- 选择模型（生成提示词时选择更聪明的模型以优化回复逻辑），点击"生成智能体"按钮，Nexent 会为您生成智能体详细内容，包括基础信息以及提示词（角色、使用要求、示例）
- 您可在下方智能体详细内容中，针对自动生成的内容（包括基础信息和提示词）进行编辑微调
📋 智能体基础信息配置
在基础信息区域，若您对自动生成的内容不满意，您可以手工修改以下各项：
| 配置项 | 说明 |
|---|---|
| 智能体名称 | 智能体的展示名称，用于界面显示和用户识别。 |
| 智能体变量名 | 智能体的内部标识名称，用于代码中引用该智能体。只能包含字母、数字和下划线，且必须以字母或下划线开头。 |
| 作者 | 智能体的创建者名称，默认值为当前登录用户的邮箱。 |
| 用户组 | 智能体所属的用户组，用于权限管理和组织管理。若为空，则表示无所属用户组。 |
| 组内权限 | 控制同组用户对该智能体的访问权限： - 同组可编辑：同组用户可以查看和编辑该智能体 - 同组只读：同组用户只能查看，不能编辑 - 私有：只有创建者和管理员可以访问 |
| 大语言模型 | 智能体运行时使用的大语言模型，用于处理推理和生成回复。 |
| 智能体运行最大步骤数 | 智能体在单次对话中最多可以执行的思考-行动循环次数。步数越多，智能体可以处理更复杂的任务，但也会消耗更多资源。 |
| 提供运行摘要 | 控制智能体在被用作子智能体时，是否向主智能体提供运行细节： - 开启（默认）：当此智能体被用作子智能体时，会向主智能体提供详细的运行过程摘要 - 关闭：当此智能体被用作子智能体时，只返回最终结果，不提供详细的运行过程 |
| 智能体描述 | 智能体的功能描述，用于说明智能体的用途和能力。 |
💡 使用建议：
- 智能体变量名应使用有意义的英文命名，如
code_assistant、data_analyst等- 智能体运行最大步骤数建议根据任务复杂度设置，简单的问答任务可设为 3-5 步，复杂的推理任务可设为 10-20 步
- 如果子智能体的运行过程对主智能体的决策有参考价值，建议开启"提供运行摘要"选项。如果只需要子智能体的最终结果以减少上下文消耗，建议关闭此选项
🐛 调试与保存
在完成初步智能体配置后，您可以对智能体进行调试，根据调试结果微调提示词，持续提升智能体表现。
- 在页面右下角点击"调试"按钮，弹出智能体调试页面
- 与智能体进行测试对话，观察智能体的响应和行为
- 查看对话表现和错误信息，根据测试结果优化智能体提示词
调试成功后，可点击右下角"保存"按钮，此智能体将会被保存并出现在智能体列表中。
🐛 版本管理
Nexent 支持智能体的版本管理，您可以在调试过程中，保存不同版本的智能体配置。
确认智能体配置无误后，您可发布智能体。发布后智能体将在智能体空间、开始问答中可见。
若需回滚到其他版本，可在版本管理页面点击"回滚"按钮。
🔧 管理智能体
在左侧智能体列表中，您可对已有的智能体进行以下操作：
🔗 查看调用关系
查看智能体所使用的协作智能体/工具，以树状图形式明晰查看智能体调用关系。
📤 导出
可将调试成功的智能体导出为 JSON 配置文件，在创建智能体时可以使用此 JSON 文件以导入的方式创建副本。
📋 复制
复制 Agent，便于智能体的实验、多版本调试与并行开发。
🗑️ 删除
删除智能体（不可撤销，请谨慎操作）。
🚀 下一步
完成智能体开发后，您可以：
如果您在使用程中遇到任何问题，请参考我们的 常见问题 或在 GitHub Discussions 中进行提问获取支持。