Skip to content

命令执行

此工具可以让模型调用当前 Koishi 实例上的 命令

我们会智能转换 Koishi 命令的参数,提供给模型调用。

配置

  • 参考 介绍 中的配置方法,启用 plugin-common 插件。
  • 按照下图配置在 plugin-common 插件中启用 command 功能。

alt text

目前 command 功能支持两种配置方式:

默认

自动转换所有可用指令为模型工具,无需手动配置。但存在以下缺点:

  • 太多的命令可能导致模型不支持。
  • 无法设置模型工具的触发词。

当你的 Koishi 实例上命令不多时,可以使用此方式。否则请使用手动添加指令的方式。

手动添加指令

plugin-common 插件中开启 command 功能后,下滑就可以找到手动配置的选项数组。

alt text

可以往数组里添加你指定的指令。每个指令都需要配置三个选项,让我们来逐一介绍。

  • command: 触发的指令全名,必填参数。填写的指令不需要包含前缀参数,支持多级指令。
  • description: 指令的描述。描述这个指令的具体作用。不填写时,则会使用指令默认的描述。
  • selector: 模型工具的触发词。当你的聊天内容含有这些词语时,这个指令对应的模型工具将会被激活。(可选项)

测试

可以参考如下配置,添加一个 status 指令到命令列表中。

alt text

询问模型调用工具,当模型回复相关信息时,说明命令执行工具配置成功。

聊天记录
U
User
chatluna.chat.text 调用工具获取当前状态信息
B
Bot
{
    tool: 'status',
    arg: '{}'
}
B
Bot
模型请求执行指令 status,如需同意,请输入以下字符:FOWFwPTG
U
User
FOWFwPTG
B
Bot
[onebot] xxx
===================
CPU 使用率:0% / 12%
内存使用率:0% / 49%
B
Bot
当前系统状态信息如下:
- CPU 使用率:0% / 12%
- 内存使用率:0% / 49%

页面历史

在 CC-BY-SA-4.0 许可下发布