SuperAPI AI 工具集

picsart-add-media

设计与创作

查看项目

更新于 10-16 03:41

技能介绍

用途:当用户想使用自己的素材(照片、视频片段、音频或聊天附件),而后续步骤需要的是 URL 而非本地路径时,用此技能把文件带入 Picsart。Picsart 的 MCP 工具只接受 URL,多数智能体宿主也无法直接读取用户磁盘文件,因此通过浏览器上传组件完成中转,文件字节不经过工具调用。

主要能力:调用上传工具后,在用户浏览器中打开拖拽上传面板,浏览器把文件直接上传到 Picsart CDN,再把生成的 URL 回传给智能体。支持可选参数 purpose(拖放区标签,如“product photo”)、accept(限制为 image、video 或 audio)、detected_files(会话中可见但无法获取的文件名,仅作提示)、known_urls(会话中已有的 URL,作为可选项展示,避免重复上传)。

使用方式:先确认当前工具列表中存在 Picsart MCP 连接器。若连接的是 Picsart MCP(工具前缀 picsart_),使用 picsart_upload_widget,它额外提供“Save to Drive”和 Drive 浏览标签;若连接的是 Picsart media-tools(前缀 mp_),使用 mp_upload,其第二个标签是“Use existing”,从传入的 known_urls 中选择,无 Drive 集成。两者都连接时任选其一,优先当前工具列表先出现的;都未连接则如实说明,不要猜测工具名。调用时按需传入上述参数,全部可选。随后提示用户拖入文件并等待其下一条消息,URL 通常只在用户下一轮消息中返回,这是两轮握手,不能在同一轮内轮询。拿到 URL 后,把它传给用户原始请求所需的 URL 型参数(如 image_url、video_url、startFrame 等)。

限制与注意:detected_files 只是显示提示,不是过滤器,用户仍可拖入任意文件,不要据此拒绝文件;若会话中已有 URL,先通过 known_urls 复用,不要重复要求上传;不要因为同一轮没有收到 URL 就声称上传失败或看不到文件。验证标准是:打开组件的调用无错误、后续用户消息返回真实托管链接、下游使用该 URL 的调用未因 URL 本身失败。相关技能为 picsart-api。