SuperAPI AI 工具集

asset-manager-authoring

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:本指南说明如何驱动 Asset Manager MCP(Asset_Manager_MCP),在 Unity Cloud 中发布与组织资产。Asset Transformer 技能在产出本地文件(如 GLB、FBX)后,即通过此处创建资产并上传,实现“衔接一个 Asset Manager 动作”。

身份与作用域:多数工具以 asset_name 为主句柄,而非原始资产 ID。作用域解析顺序为显式 org_id/project_id → project_name → 会话默认值。会话开始时用 list_organizations 询问用户并 set_default_organization,再用 list_projects 与 set_default_project(或 set_default_project_by_name),之后调用可省略作用域。可用 list_organizations、list_projects、list_assets 发现作用域。

认证:与 Pipeline Automation 相同。先运行 unity_login 完成浏览器 PKCE 登录,令牌会缓存并自动刷新;用 unity_auth_status 检查状态。调用出现认证错误时先核验此项,不要盲目重试。

核心流程:create_asset 创建资产或新版本,tags 必须是列表,asset_type 使用控制台带空格的值(如 “3D Model”“Prefab”“Scene”“Shader”),新资产默认 “3D Model”,重新版本时留空则保持当前类型;upload_files_to_asset 将本地文件上传到未冻结版本,model_files 为本地路径列表,freeze_after_upload=True 可一步冻结;upload_preview_image_to_asset 可选上传缩略图,需资产已存在且有未冻结版本;freeze_asset 冻结当前版本,冻结后才能创建新版本;change_asset_status 推进状态(如 Published),不可直达时会报告可达状态,get_asset_status 只读查看;最后用 get_asset_url 获取控制台链接并提供给用户。

新版本:create_new_draft_version(或以同名再调用 create_asset)→ 上传 → 冻结;创建新草稿前必须冻结上一版本。批量可用 batch_upload_assets,下载用 download_files_from_asset。

元数据与标签:update_asset_metadata 以合并方式写入自定义字段。自定义字段须先在组织级定义,用 list_field_definitions、create_field_definition、delete_field_definition 管理;未定义字段的元数据不会生效。标签方面,list_asset_labels 显示版本标签(Latest/Pending 为系统分配),用户标签可创建、分配、解除与列出。

查找、删除与引用:search_assets_across_projects 可跨全组织搜索,list_asset_versions 查看完整版本历史。delete_asset 默认软删除进回收站,可用 list_trashed_assets 与 restore_asset 恢复,trash=False 才是永久删除。add_asset_reference 支持 dependency_type、target_label、relative_path(如纹理相对模型的路径)及引用自身元数据,目标版本默认固定为当前版本;list_asset_references 的 context 可取 source/target/both,remove_asset_reference 删除链接。集合用 list_collections、create_collection、delete_collection、link_asset_to_collection、unlink_asset_from_collection,上传时也可传 collection_path。

最佳实践:先冻结再建新版本,不能向已冻结版本上传;tags 等列表参数须为数组;先定义元数据字段再赋值;优先按名称与会话默认项目解析;发布前与用户确认目标项目,发布后返回 get_asset_url。

范围之外:Pipeline 的 Create asset/Add file 动作见 pipeline-authoring;使用 pxz 编写或优化 3D 场景见 at-scripting(进程内)与 at-upa-scripting(管线自定义脚本),二者均不同于本 MCP。