Skip to content

我用页面

本文档介绍了如何通过页面来配置 PPAgent 应用,包括集成各种后端模型、消息源以及技能。

具体的每一个消息源等的详细配置,请参考配置部分。

注册配置平台账号,登录系统

TIP

由于网络原因,首次登录速度可能较慢,请耐心等待。

  1. 访问 https://ppagent.cn/,点击注册按钮进行注册
  2. 输入邮箱和密码
  3. 点击邮箱收到的激活链接
  4. 激活后登录

配置服务器信息

TIP

前端页面是用来对您自己运行的后端实例进行配置,因此首先需要确保已经成功运行了后端实例,具体可以参考 Docker安装或者代码安装

当注册成功后第一次登录,默认会跳转到服务器的配置页面,您也可以通过点击服务器菜单,选择右侧的编辑按钮进行编辑。 编辑服务器配置

其中显示名称您可以自定义,其余的信息可以从后端服务器启动后的控制台日志中获取,类似如下所示:

控制台输出

TIP

如果是通过代码启动,那么在app.ts中,能够看到实例名称,默认是default:

ts
const chat = new PPAgent({
    name: "default",
});

如果是通过docker启动,那么就是default。

配置填写完成后,点击测试连接,如果显示成功,则可以点击保存。如果提示失败,那么需要检查当前填入的地址是否可访问。

保存后,将会返回服务器信息页面,在正常配置状态下,点击服务器菜单按钮也会进入服务器信息查看页面。在这里可以查看当前连接状态、服务器运行的服务数量、以及查看服务器日志和同步和重启服务。

查看服务器日志

点击查看日志按钮,可以连接服务器查看日志输入,此时上方的日志过滤功能区的过滤按钮可用,您可以随时切换日志显示级别。

服务器日志

服务器状态变更

点击 同步配置重启服务按钮可以分别进行同步配置和重启服务操作。

配置一个消息源

TIP

在前端配置页面中,所有带小问号的配置项,都支持查看详细信息,鼠标移动上去即可: 提示

消息源是用来接收用户消息,如钉钉、飞书、企业微信等。点击菜单的消息接入按钮,即可开始消息源的接入,本系统内置了众多常用的消息源,也支持通过插件进行扩展。

  • 点击消息接入菜单
  • 点击右上角的新建按钮 创建消息源
  • 选择需要接入的消息源
  • 进行消息源的参数配置 配置消息源

各个消息源的详细配置,请参考配置部分针对每个消息源的描述。

配置一个后端模型

后端模型是用来根据用户消息生成响应的模型,如DeepSeek,Dify等。在菜单中点击模型接入按钮,随后点击右上角的创建按钮,最后选择一个模型类型,进行配置即可。

配置后端模型

当前后端模型支持多模态,但是暂不支持工具调用,后续将支持工具调用。

配置智能体

在本系统中,智能体是指连接消息源和后端模型的连接器,智能体当前支持通过技能对用户消息或者后端模型返回的消息进行拦截修改。

智能体的配置步骤类似,先点击菜单中的智能体按钮,再点击右上角的创建按钮,选择内置构建器,随后进行按需配置即可,详细可参考配置章节关于智能体的描述。

配置生效

配置是服务启动时进行读取的,因此配置通过页面修改后需要进行同步才能生效,有以下几种方式可以同步:

  • 如果是修改了消息源、后端模型或者智能体的配置,可以直接点击页面右上角的 同步按钮,进行配置同步。
  • 如果是增加了新的插件,或者同步配置后发现异常,可以直接点击页面右上角的重启按钮,进行服务实例的热重启。
  • 更彻底的重启,可以直接重启服务器端的Docker容器(对于Docker安装用户)或者关闭当前服务后重新pnpm start(对于代码安装用户)。