Skip to content

AI Chat 插件

AI Chat 是内置插件,为 Discord 机器人提供 @提及自动回复能力,支持联网搜索、长期记忆、频道历史总结等。

启用

config.yaml 中配置:

yaml
plugins:
  - name: ai-chat
    enabled: true
    options:
      enabled: true
      apiUrl: https://api.openai.com/v1
      apiKey: sk-xxx
      model: gpt-4
      systemPrompt: "你是一个有帮助的助手。"

配置项

字段类型默认说明
enabledbooleanfalse是否启用
apiUrlstringhttps://api.openai.com/v1API 地址
apiKeystring""API Key
modelstringgpt-3.5-turbo模型名称
systemPromptstring默认提示词系统提示词
maxTokensnumber1024最大 Token 数
temperaturenumber0.7温度参数
allowedGuildIdsstring[][]允许的 Discord 服务器 ID(空=全部)
maxToolIterationsnumber8工具调用最大迭代次数
reactionsbooleantrue是否启用表情反应
ignoreEveryoneMentionbooleanfalse忽略 @everyone 提及
maxImageBytesnumber6291456单张图片字节上限
maxTotalImageBytesnumber12582912单次请求图片总字节上限

webSearch - 联网搜索

yaml
webSearch:
  enabled: true
  provider: duckduckgo     # duckduckgo | tavily | serper | brave | searxng
  apiKey: ""               # tavily / serper / brave 需要
  baseUrl: ""              # searxng 实例地址
  maxResults: 5

memory - 长期记忆

yaml
memory:
  enabled: true
  maxProfileItems: 12       # 每轮注入的画象条数
  maxProfileChars: 800      # 画像字符上限
  recentTurns: 6            # 最近对话轮次
  recallLimit: 8            # 按需检索条数
  logConversations: true    # 记录对话历史
  maxConversationsPerUser: 500

summary - 频道历史总结

yaml
summary:
  enabled: true
  maxMessagesPerChannel: 500
  defaultCount: 100

Discord 命令

  • @机器人 你的问题 — @提及发起对话
  • /memory — 查看 AI 对你的记忆
  • /delete-memory <key> — 删除指定记忆

工具

AI 聊天启用后,模型可以调用以下工具:

工具说明
web_search联网搜索实时信息
open_url读取网页正文
read_image查看图片
recall_memory检索历史对话
save_memory保存长期记忆
update_memory更新记忆
forget_memory删除记忆
read_channel_history读取频道聊天记录