需绕过前端搜索直接操作底层文件系统,进入$HOME/aospace/projects/下目标项目UID目录,用rg按内容搜索;system-agent CLI支持工具列表、节点类型及prompt引用三类精准检索;Workspace Preview需地域匹配且CMS等资源就绪后验证实时渲染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Agent Space中精准定位项目文件,需绕过前端模糊搜索框的干扰,直接操作底层文件系统或调用专用CLI命令,否则可能返回空结果或仅匹配文件名而忽略内容语义。
通过宿主机终端定位并搜索项目文件
进入项目实际存储路径,避免在Web界面中徒劳点击搜索图标。
执行 cd $HOME/aospace/projects/ → 列出所有项目目录:ls -1,找到目标项目UID(如prj_5c8d2e0a)→ 进入该项目:cd prj_5c8d2e0a。
这一步必须做,因为Agent Space Web控制台不暴露真实文件路径,所有“项目文件”都映射在此处;若跳过,后续grep/find均无目标可查。
使用rg(ripgrep)按内容搜索:rg "合同签署方" prompts/contract.jinja,它比原生grep快且默认递归、忽略.git目录。
【注意:workflow.yaml和agent.json不支持中文正则匹配,搜索中文字段前需先确认文件编码为UTF-8,否则返回空】
用system-agent CLI快速搜索工具与节点
方法一:搜索已注册工具名
执行 system-agent tool list --project=prj_5c8d2e0a,输出所有tool.name字段,适用于确认某工具是否已接入项目。
方法二:搜索workflow中特定节点类型
执行 system-agent workflow grep --project=prj_5c8d2e0a --node-type=human-approval,只返回含人工确认点的YAML片段,不显示无关分支逻辑。
方法三:反向查找被引用的prompt模板
执行 system-agent workflow grep --project=prj_5c8d2e0a --pattern="prompt_id:.*q3_review",能准确定位到调用季度评审提示词的工作流位置,避免手动全文扫描。
在Workspace Preview中验证搜索结果是否生效
第一步:确保Preview功能已就绪
检查CMS 2.0、MSE、SLS三项资源状态均为「已就绪」,且所在地域为cn-hangzhou、cn-shanghai或cn-hongkong之一;【地域一旦选定不可更换,Preview在此之外地域完全不可见】。
第二步:打开Preview并加载AGENTS.md
进入目标Workspace → 点击顶部右侧「Preview Mode」开关 → 等待右上角出现绿色「Live」徽标且时间戳持续更新。
第三步:观察实时渲染是否包含新文件
若刚在prompts/下新增了policy_v2.jinja,Preview左侧文件树中应立刻出现该文件名;若未出现,说明文件未保存在项目根目录下,或文件名拼写错误(如多了一个空格)。


















