PPAgent 文档

Appearance

CogView ​

CogView是智谱AI开发的一款AI绘图模型，可以根据文本描述生成图像。平台集成了智谱AI的CogView绘图能力，使用户可以通过简单的文本指令生成图像。

特点 ​

  • 支持中英文绘图提示词
  • 提供多种绘图尺寸选项（对plus模型生效）
  • 支持使用大模型优化提示词，提升绘图质量
  • 可自定义触发词和回复格式
  • 支持cogview-3和cogview-3-plus两种模型

代码配置 ​

使用CogView绘图技能需要进行如下配置：

typescript
const ppagent = new PPAgent({
    // ...
    skills: [
        {
            name: "cogview-skill",
            options: {
                instanceName: "cogview-draw", // 实例名称，需要全局唯一
                apiKey: "your-zhipuai-api-key", // 必填，智谱AI的API密钥
                apiBase: "https://open.bigmodel.cn", // 智谱AI的API地址，默认为官方地址
                model: "cogview-3-plus", // 必填，绘图模型，可选择"cogview-3-plus"或"cogview-3"
                size: "1024x1024", // 绘图尺寸，仅对plus模型生效
                triggerWords: "画图 画个图 画画 画张图 绘图 画个画 画 draw", // 触发词，以空格分隔
                replyFormat: "TEXT", // 回复格式，可选"TEXT"或"IMAGE"
                useLLM: false, // 是否使用大模型优化提示词
                optimizer: "" // 用于优化提示词的大模型实例名称
            }
        }
    ],
    // source和bot等配置可以用省略号代替
});

服务器运行请参考 install_code.md 文件。

配置说明： ​

必填配置 ​

  • apiKey: 智谱AI的API密钥，用于访问CogView绘图服务
  • model: 绘图模型，支持"cogview-3-plus"或"cogview-3"

可选配置 ​

  • apiBase: API地址，默认为智谱AI官方地址"https://open.bigmodel.cn"
  • size: 绘图尺寸，仅对plus模型生效，支持的尺寸包括：
    • "1024x1024"（默认）
    • "768x1344"
    • "864x1152"
    • "1344x768"
    • "1152x864"
    • "1440x720"
    • "720x1440"
  • triggerWords: 触发词，以空格分隔，默认为"画图 画个图 画画 画张图 绘图 画个画 画 draw"
  • replyFormat: 回复格式，可选"TEXT"（MarkDown格式，默认）或"IMAGE"（直接发送图片）
  • useLLM: 是否使用大模型优化提示词，默认为false
  • optimizer: 用于优化提示词的大模型实例名称

注意事项 ​

  1. 使用大模型优化提示词时，需要确保已配置相应的大模型实例，并在optimizer中指定该实例名称
  2. 对于支持Markdown的消息源，建议使用TEXT回复格式
  3. CogView-3-plus模型支持多种尺寸设置，而CogView-3模型则不支持尺寸设置
  4. 智谱AI的API调用需要计费，请确保您的账户有足够的余额