用途:当用户要求创建、渲染、绘制、设计、生成或编辑图片时,使用 generate_image 工具。若当前工具列表中没有该工具,应告知用户此 nanobot 实例未启用图像生成。
主要能力:支持文生图,传入具体提示词即可;支持图像编辑,在 reference_images 中传入已保存的产物路径或用户图片路径;支持同一对话内的迭代修改,用户说“调亮一点”“换背景”“再试一版”时优先使用最近生成的图片产物;若多张近期图片都可能为目标,先简短追问确认。生成后调用 message 工具,在 media 参数中传入产物路径以交付给用户。
提示词规则:应包含足够细节,如主体与场景、构图与镜头或版式、风格氛围光照与配色、需要出现在图中的文字(精确引用),以及“保持同一角色”“保留 logo”“不要改背景”等约束。
产物规则:工具把生成的图片作为持久产物存放在 nanobot 的媒体目录下,并返回结构化元数据,包括 id(如 img_ab12cd34ef56)、path(供后续编辑使用的本地路径)、mime、prompt、model 和 source_images。面向用户的正常回复中不要暴露本地文件系统路径,保持自然表达,例如“Done, I generated it.”;可在有助于用户指代某张图时给出短 id,原始路径保持内部使用,除非用户明确要求调试细节或本地产物引用。切勿粘贴 base64。后续编辑时把先前产物路径传给 reference_images;若用户上传了新图片,则改用该路径作为参考。用户可见回复中不要包含 [Message Time: ...]、[image: /local/path]、generate_image(...) 或 message(...) 等内部回放标记。
示例:生成新图可调用 generate_image(prompt="A minimal app icon for nanobot: friendly robot head, rounded square, soft blue and white palette, clean vector style, no text", aspect_ratio="1:1", image_size="1K");编辑最近产物可调用 generate_image(prompt="Use the reference image. Keep the same robot and composition, but change the palette to warm orange and add a subtle sunrise background.", reference_images=["/home/user/.nanobot/media/generated/2026-05-08/img_ab12cd34ef56.png"], aspect_ratio="1:1", image_size="1K")。
限制:资料未提供支持的模型、分辨率上限、计费方式、平台范围或生成效果保证等信息。