如何在 Agent Zero 中创建一个自定义 Agent Profile 来定制当前聊天的角色与语气【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero当你想让 Agent Zero 的当前聊天固定成某种工作方式——比如一个“谨慎的金融分析师”或者一个“严格的代码评审者”——而不是每次重新描述要求时创建自定义 Agent Profile 是文档给出的路径。Profile 会改变驱动当前聊天的角色、语气和工作流指令并且只在所选聊天内生效其他聊天可以保留各自的 Profile。适用前提是你已经有一个可以正常聊天的 Agent Zero Web UI 会话。先确认你要改的对象是 Profile 而不是别的控制项Agent Zero 里有几个容易混淆的控制项它们的分工不同引自 Agent Profiles 指南使用改变的是Agent Profile角色的职责、语气、工作流和 prompt 指令Skill一条需要随时可用的具体流程或能力Project文件、工作区、记忆、指令、密钥和长期上下文Model Preset当前聊天使用的模型如果你的目标只是换角色和语气用 Profile如果还想同时改变模型那是 Model Preset 的事不属于本文路径。通过聊天内的引导流程创建 Profile创建入口不在设置里而在聊天界面的 Profile 菜单中具体步骤打开一个聊天。点击聊天输入框附近的当前 Profile 名称打开 Profile 菜单。在菜单中点击Create new Agent Profile。点击后 Agent Zero 会在聊天输入框里放一条现成的待发送消息即下图所示的引导消息。发送这条消息就会启动引导式 Profile 创建流程。这个流程是刻意做成对话式的引自 Agent Profiles 指南它会先问这个新 Profile 应该擅长什么然后给出合理的默认值建议在创建任何文件之前它会先展示一份紧凑的摘要让你确认整个流程由专门的 profile-creation skill 驱动保持过程有序。回答越具体越好。文档给出的两个示例回答可直接作为你回答的参照格式This profile should help me plan YouTube scripts for technical demos. It should ask for the target audience, keep the tone simple, and suggest a visual outline.I want a cautious finance analyst profile. It should separate facts from assumptions, prefer spreadsheets, and never present estimates as certainty.如果想法比较宽泛创建流程会推断合理的默认值并把不确定项标记出来而不是停下来反复追问。在摘要确认通过之前不会写入文件。验证新 Profile 是否生效按 创建 Agent Profile 的 skill 说明Profile 会在下一次 agent 初始化时被拾取——不需要重启某个聊天但需要一次全新的 agent/subordinate 生成才能应用。验证清单新 Profile 的标题title正确出现在 UI 的 agent 选择器中角色/语气覆盖在新 agent 的系统 prompt 中实际生效。如果 Profile 没有出现在选择器里按文档给出的顺序检查目录名匹配^[a-z0-9_-]$且在 Profile 搜索路径中唯一agent.yaml能作为合法 YAML 解析目录位于被识别的搜索路径之一用户级 Profile 在/a0/usr/agents/profile_name/。验证通过后回到聊天输入框附近的 Profile 菜单选择新 Profile当前聊天立即切换到该角色该变更只作用于所选聊天。如果你想让它成为所有新聊天的默认走Settings - Agent Config里的Agent Profile选项见 安装文档的 Agent Configuration 一节。可选进阶直接编辑 Profile 文件文档明确建议大多数用户通过上面的菜单创建 Profile。需要直接编辑文件时注意位置约束用户 Profile 放在/a0/usr/agents/profile-name/不要建在/a0/agents/——那个目录保留给核心框架 Profiledefault、agent0、developer、hacker、researcher、_example。一个用户 Profile 的最小结构/a0/usr/agents/profile-name/ ├── agent.yaml # 必需 └── prompts/ # 可选——prompt 覆盖 └── agent.system.main.specifics.mdagent.yaml只有三个内容字段引自 SKILL.md示例内容取自其中的 Data Analyst 示例title: Data Analyst description: Agent specialized in data analysis, visualization, and statistical modeling. context: Use this agent for data analysis tasks, creating visualizations, statistical analysis, and working with datasets in Python.其中title是 UI 中显示的名称context是告诉上级 agent 何时应该委派给该 Profile 的说明。文档特别强调不要往agent.yaml里加模型、温度或allowed_tools字段——模型选择走配套的_model_config插件配置工具可用性由插件激活控制。角色和语气的具体行为通常写在prompts/agent.system.main.specifics.md里。这个文件在根级/a0/prompts/和/a0/agents/default/里都是空的就是留给 Profile 填写的扩展槽位放在它里面覆盖最安全。Profile 继承/a0/prompts/和/a0/agents/default/的全部 prompt要改某一部分行为就把同名文件放进profile/prompts/加载器会优先取 Profile 内的版本。只覆盖你真正要改的文件——原样复制未修改的 prompt 文件会在框架更新时造成静默漂移。只有当某个 Profile 需要固定使用某个已有的全局模型预设时才额外创建/a0/usr/agents/profile/plugins/_model_config/config.json且其中只存预设名{ model_preset: Research }添加前确认该全局预设已经存在新模型选项要先通过 Model Configuration 创建全局预设。这个文件里不存放 API 密钥或模型定义。边界与限制自 v0.9.7 起自定义 prompt 归属到具体 agent profile 内部而不是共享的/prompts目录见 安装文档。Profile 目录名必须唯一且只含小写字母、数字、连字符或下划线目录名也是后续通过call_subordinate委派时使用的名字不是 title。不要在 Profile 里存放密钥或 provider 凭据——这类内容由集中配置管理。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考