org.noear.solon.ai.skills.generation

类 ImageGenerationSkill

java.lang.Object

org.noear.solon.ai.chat.skill.AbsSkill

org.noear.solon.ai.skills.generation.ImageGenerationSkill

所有已实现的接口:

Skill

@Preview(value="3.9.1")
public class ImageGenerationSkill
extends AbsSkill

绘图生成技能：为 AI 提供多模态视觉创作能力。

该技能集成了多种绘图驱动（如 DALL-E, Midjourney 等），允许 Agent 根据自然语言描述生成图像并持久化到本地。 核心特性：

• 智能命名：支持 AI 建议文件名，并自动处理物理文件名冲突。
• 安全沙箱：强制生成物存储在指定的 WorkDir，防止路径逃逸。
• 链式友好：显式返回保存后的物理路径，方便后续技能（如文件打包、邮件发送）直接引用。

从以下版本开始:

3.9.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	ImageGenerationSkill.ImageDriver

字段概要

字段

限定符和类型	字段和说明
static ImageGenerationSkill.ImageDriver	DALL_E DALL-E 驱动模拟

从类继承的字段 org.noear.solon.ai.chat.skill.AbsSkill

tools

构造器概要

构造器

构造器和说明
ImageGenerationSkill(ImageGenerationSkill.ImageDriver driver, java.lang.String apiKey, java.lang.String workDir)

方法概要

限定符和类型	方法和说明
java.lang.String	description() 获取技能描述
static void	downloadImage(java.lang.String imageUrl, java.nio.file.Path savePath) 驱动可直接使用的通用下载方法
java.lang.String	generate(java.lang.String prompt, java.lang.String size, java.lang.String fileName) 执行图片生成
boolean	isSupported(Prompt prompt) 准入检查：决定该技能在当前对话上下文中是否被激活
java.lang.String	name() 获取技能名称（默认类名）

从类继承的方法 org.noear.solon.ai.chat.skill.AbsSkill

getTools, metadata

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.skill.Skill

getInstruction, onAttach

字段详细资料

DALL_E

public static final ImageGenerationSkill.ImageDriver DALL_E

DALL-E 驱动模拟

构造器详细资料

ImageGenerationSkill

public ImageGenerationSkill(ImageGenerationSkill.ImageDriver driver,
                            java.lang.String apiKey,
                            java.lang.String workDir)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

isSupported

public boolean isSupported(Prompt prompt)

从接口复制的说明: Skill

准入检查：决定该技能在当前对话上下文中是否被激活

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

generate

@ToolMapping(name="generate_image",
             description="\u6839\u636e\u63d0\u793a\u8bcd\u751f\u6210\u56fe\u7247\u5e76\u4fdd\u5b58\u5230\u672c\u5730\u3002\u4f60\u53ef\u4ee5\u6307\u5b9a\u56fe\u7247\u5c3a\u5bf8\uff0c\u5b8c\u6210\u540e\u8bf7\u544a\u77e5\u7528\u6237\u6587\u4ef6\u540d\u3002")
public java.lang.String generate(@Param(value="prompt")
                                                                                                                                                                                                                                                                                                                                      java.lang.String prompt,
                                                                                                                                                                                                                                                                                                                                      @Param(value="size")
                                                                                                                                                                                                                                                                                                                                      java.lang.String size,
                                                                                                                                                                                                                                                                                                                                      @Param(value="fileName")
                                                                                                                                                                                                                                                                                                                                      java.lang.String fileName)

执行图片生成

参数:

prompt - 提示词（描述图片内容）

size - 尺寸（如 1024x1024）

fileName - 建议的文件名（可选，如 design.png）

downloadImage

public static void downloadImage(java.lang.String imageUrl,
                                 java.nio.file.Path savePath)
                          throws java.lang.Exception

驱动可直接使用的通用下载方法

抛出:

java.lang.Exception