智能体开发

在智能体开发页面中，您可以创建、配置和管理智能体。智能体是 Nexent 的核心功能，它们能够理解您的需求并执行相应的任务。

🔧 创建智能体

在 Agent 管理页签下，点击"创建 Agent"即可创建一个空白智能体，点击"退出创建"即可退出创建模式。如果您有现成的智能体配置，也可以导入使用：

点击"导入 Agent"
在弹出的文件选择对话框中选择智能体配置文件（JSON 格式）
点击"打开"按钮，系统会验证配置文件的格式和内容，并显示导入的智能体信息

⚠️ 提示：如果导入了重名的智能体，系统会弹出提示弹窗。您可以选择：
直接导入：保留重复名称，导入后的智能体会处于不可用状态，需手动修改 Agent 名称和变量名后才能使用
重新生成并导入：系统将调用 LLM 对 Agent 进行重命名，会消耗一定的模型 token 数，可能耗时较长

📌 重要说明：通过导入创建的智能体，如果其工具中包含 knowledge_base_search 等知识库检索工具，这些工具只会检索当前登录用户在本环境中有权限访问的知识库。导入文件中原有的知识库配置不会自动继承，因此实际检索结果和回答效果，可能与智能体原作者环境下的表现存在差异。

👥 配置协作智能体/工具

您可以为创建的智能体配置其他协作智能体，也可以为它配置可使用的工具，以赋予智能体能力完成复杂任务。

🤝 协作 Agent

点击"协作 Agent"页签下的加号，弹出可选择的智能体列表
在下拉列表中选择要添加的智能体
允许选择多个协作智能体
可点击 × 取消选择此智能体

🛠️ 选择 Agent 的工具

智能体可以使用各种工具来完成任务，如知识库检索、文件解析、图片解析、收发邮件、文件管理等本地工具，也可接入第三方 MCP 工具，或自定义工具。

在"选择 Agent 的工具"页签右侧，点击"刷新工具"来刷新可用工具列表
选择想要添加工具所在的分组
查看分组下可选用的所有工具，可点击 ⚙️ 查看工具描述，进行工具参数配置
点击工具名即可选中该工具，再次点击可取消选择
- 如果工具有必备参数没有配置，选择时会弹出弹窗引导进行参数配置
- 如果所有必备参数已配置完成，选择则会直接选中

💡 小贴士：
请选择 knowledge_base_search 工具，启用知识库的检索功能。
请选择 analyze_text_file 工具，启用文档类、文本类文件的解析功能。
请选择 analyze_image 工具，启用图片类文件的解析功能。
📚 想了解系统已经内置的所有本地工具能力？请参阅本地工具概览。

🔌 添加 MCP 工具

在"选择 Agent 的工具"页签右侧，点击"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 使用，丰富 Agent 能力。

🧪 工具测试

无论是什么类型的工具（内置工具、外部接入的 MCP 工具，还是自定义开发工具），Nexent 都提供了"工具测试"能力。如果您在创建 Agent 时不确定某个工具的效果，可以使用测试功能来验证工具是否按预期工作。

点击工具的小齿轮按钮 ⚙️，进入工具的详细配置弹窗
首先确保已经配置了工具的必备参数（带红色星号的参数）
在弹窗的左下角点击"工具测试"按钮
右侧会新弹出一个测试框
在测试框中输入测试工具的入参，例如：
- 测试本地知识库检索工具 knowledge_base_search 时，需要输入：
  - 测试的 query，例如"维生素C的功效"
  - 检索的模式 search_mode（默认为 hybrid）
  - 目标检索的知识库列表 index_names，如 ["医疗", "维生素知识大全"]
  - 若不输入 index_names，则默认检索知识库页面所选中的全部知识库
输入完成后点击"执行测试"开始测试，并在下方查看测试结果

📝 描述业务逻辑

✍️ 描述 Agent 应该如何工作

根据选择的协作 Agent 和工具，您现在可以用简洁的语言来描述，您希望这个 Agent 应该如何工作。Nexent 会根据您的配置和描述，自动为您生成 Agent 名称、描述以及提示词等信息。

在"描述 Agent 应该如何工作"下的编辑框中，输入简洁描述，如"你是一个专业的知识问答小助手，具备本地知识检索和联网检索能力，综合信息以回答用户问题"
选择模型（生成提示词时选择更聪明的模型以优化回复逻辑），点击"生成智能体"按钮，Nexent 会为您生成 Agent 详细内容，包括基础信息以及提示词（角色、使用要求、示例）
您可在下方 Agent 详细内容中，针对自动生成的内容（特别是提示词）进行编辑微调

🐛 调试与保存

在完成初步 Agent 配置后，您可以对 Agent 进行调试，根据调试结果微调提示词，持续提升 Agent 表现。

在页面右下角点击"调试"按钮，弹出智能体调试页面
与智能体进行测试对话，观察智能体的响应和行为
查看对话表现和错误信息，根据测试结果优化智能体提示词

调试成功后，可点击右下角"保存"按钮，此智能体将会被保存并出现在智能体列表中。

🔧 管理智能体

在左侧智能体列表中，您可对已有的智能体进行以下操作：

🔗 查看调用关系

查看智能体所使用的协作智能体/工具，以树状图形式明晰查看智能体调用关系。

📤 导出

可将调试成功的智能体导出为 JSON 配置文件，在创建 Agent 时可以使用此 JSON 文件以导入的方式创建副本。

📋 复制

复制 Agent，便于智能体的实验、多版本调试与并行开发。

🗑️ 删除

删除智能体（不可撤销，请谨慎操作）。

🚀 下一步

完成智能体开发后，您可以：

在 智能体空间 中查看和管理所有智能体
在 开始问答 中与智能体进行交互
在 记忆管理 配置记忆以提升智能体的个性化能力

如果您在使用程中遇到任何问题，请参考我们的 常见问题 或在 GitHub Discussions 中进行提问获取支持。

智能体开发 ​

🔧 创建智能体 ​

👥 配置协作智能体/工具 ​

🤝 协作 Agent ​

🛠️ 选择 Agent 的工具 ​

🔌 添加 MCP 工具 ​

⚙️ 自定义工具 ​

🧪 工具测试 ​

📝 描述业务逻辑 ​

✍️ 描述 Agent 应该如何工作 ​

🐛 调试与保存 ​

🔧 管理智能体 ​

🔗 查看调用关系 ​

📤 导出 ​

📋 复制 ​

🗑️ 删除 ​

🚀 下一步 ​