在agentspace平台需通过宿主机文件系统编辑项目文件，项目路径为$home/aospace/projects/下以uid命名的目录，核心可编辑文件为agent.json、workflow.yaml和prompts/下的模板文件；修改后需用system-agent命令停止、重载项目以生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 AgentSpace 平台中直接编辑项目文件，需绕过前端界面限制，通过其底层文件系统或开发模式介入，因为平台默认不开放在线文件编辑器。
确认项目本地化路径
AgentSpace 项目实际运行时会将配置与逻辑文件映射到宿主机指定目录。启动容器时若指定了 【AOSPACE_DATADIR=$HOME/aospace】，则所有项目文件均落在此路径下的 projects/ 子目录中。
进入该目录：cd $HOME/aospace/projects/，你会看到以项目 UID 命名的文件夹（如 prj_7f3a9b21），每个即为一个独立项目的工作区。
识别可编辑的核心文件
AgentSpace 项目不依赖 app.py 或 Gradio_UI.py 这类 Hugging Face Space 的结构，而是围绕以下三类文件组织：
• agent.json：定义工具列表、调用权限、输入输出 schema；
• workflow.yaml：声明节点连接、条件分支、人工确认点；
• prompts/ 目录下多个 .txt 或 .jinja 文件：承载各环节提示词模板。
这三类是唯一被 runtime 加载并生效的源文件，其余如 README.md 或 logo.png 修改后不会影响执行逻辑。
修改 agent.json 配置
方法一：手动编辑 JSON 字段
用 VS Code 或 vim 打开 agent.json，重点检查 "tools" 数组是否包含你新增工具的 name 和 description；
【必须确保每个 tool.name 全局唯一，且与 backend 工具注册名完全一致，否则启动时报错“tool not found”】。
方法二：用 CLI 工具注入
若已安装 system-agent CLI，可在项目根目录执行：system-agent tool add --name=git_commit --desc="Get last 5 commits"，自动更新 JSON 并校验格式。
热重载 workflow.yaml
第一步：停止当前项目服务
执行 system-agent project stop --uid=prj_7f3a9b21，避免文件被进程占用导致写入失败。
第二步：编辑 workflow.yaml
修改节点参数时注意缩进必须为两个空格，YAML 中 tab 字符会导致解析中断；
例如把 max_retries: 3 改为 max_retries: 1 后保存。
第三步：触发重载
执行 system-agent project reload --uid=prj_7f3a9b21，runtime 会重新加载 YAML 并重建执行图，无需重启整个容器。
