hermes agent模型集成需按五类维度分类处理：一、协议类型（acp/mcp）；二、数据流向（输入/输出/元数据隔离）；三、安全等级（明文/脱敏/加密）；四、模型能力（基础llm/多模态/工具增强）；五、地域合规（境内/境外/混合部署）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在配置Hermes Agent时发现模型无法调用、响应为空或返回格式异常，则可能是由于Model集成过程中数据分类不明确、协议适配错误或端点参数未按语义层级对齐所致。以下是针对Model集成中数据分类维度的实操处理步骤：
一、按协议类型分类：区分ACP与MCP接入路径
Hermes Agent支持两种主流模型交互协议：ACP（Agent Communication Protocol）为本地CLI直连协议，适用于内置模型或轻量API；MCP（Model Control Protocol）为标准化外部服务协议，用于对接百炼、Ollama、vLLM等第三方模型服务。分类错误将导致会话初始化失败或工具调用中断。
1、确认当前部署模式是否启用ACP子进程：执行hermes doctor命令，检查输出中ACP transport status是否为active。
2、若需使用MCP服务，确保已安装mcp-server-ollama或mcp-server-bailian并运行于本地端口3000，默认启用session/prompt与tool/execute方法。
3、在hermes setup流程中，当提示“Select LLM provider”时，输入mcp而非openai或anthropic，以触发MCP专用配置分支。
二、按数据流向分类：输入/输出/元数据三域隔离
Model集成要求严格划分数据语义域：用户输入（Input）需经tokenizer预处理后注入prompt模板；模型原始输出（Output）必须经response parser清洗，剥离控制字符与冗余标记；元数据（Metadata）如model_name、max_tokens、temperature须独立挂载至session context，不可混入prompt正文。混用将导致token溢出或解析崩溃。
1、编辑~/.hermes/config.yaml，在model节点下显式声明三个子字段：input_template、output_parser、metadata。
2、为input_template设置Jinja2格式字符串，例如"{{ system_prompt }}\n{{ user_message }}\nAssistant:"，禁止直接拼接变量。
3、为output_parser指定内置解析器名称：json_only（强制提取JSON块）、assistant_first（截取首个Assistant:后内容）或自定义正则表达式，例如^Assistant:(.*)$。
三、按安全等级分类：明文/脱敏/加密三级管控
涉及API-Key、BaseURL、用户隐私字段的数据必须按安全等级实施差异化处理：明文仅限localhost回环地址调用；脱敏适用于内网HTTP服务，隐藏域名与路径；加密强制用于公网HTTPS端点，密钥由Hermes内置KMS模块动态生成。未分级将触发hermes doctor安全告警并阻断会话。
1、运行hermes model --configure-security启动交互式安全策略向导。
2、当提示“Enter model endpoint”时，若输入以https://开头的公网地址，系统自动启用AES-256-GCM加密封装，且拒绝保存明文api_key字段。
3、若输入http://192.168.1.100:11434类内网地址，选择“Obfuscate path only”，系统将把/v1/chat/completions替换为/x/xxxxx并记录映射关系至~/.hermes/security.obf。
四、按模型能力分类：基础LLM/多模态/工具增强三类注册
Hermes Agent依据模型实际能力注册对应功能集：仅支持text-in/text-out的基础LLM不可启用image_generate或voice_speak工具；具备MCP扩展能力的模型必须在capabilities数组中显式声明multimodal或function_calling；工具增强型模型还需提供tools_schema描述文件路径。能力声明缺失将导致工具调用被静默忽略。
1、执行hermes model --list-capabilities查看当前模型已注册能力列表。
2、若需手动注册多模态能力，在config.yaml的model节中添加capabilities: ["multimodal", "vision"]，并确保vision_model字段指向本地clip-vit-base-patch32权重路径。
3、为工具增强模型生成Schema文件：运行hermes tool schema --output ~/.hermes/tools.json，再于config.yaml中设置tools_schema: "~/.hermes/tools.json"。
五、按地域合规分类：境内/境外/混合部署资源路由
根据中国《生成式人工智能服务管理暂行办法》，面向境内用户提供服务的模型必须完成备案且数据不出境。Hermes Agent通过region_policy字段实现流量路由：设为cn时，所有请求强制走阿里云百炼杭州节点；设为global时，优先调用就近区域MCP服务器；设为hybrid时，文本类请求走境内，图像/语音类请求可路由至境外加速节点。违规路由将被hermes guard进程拦截。
1、在hermes setup最后一步，当显示“Select region policy”时，输入cn、global或hybrid之一。
2、若已部署完成，编辑~/.hermes/config.yaml，在根节点添加region_policy: cn，并确保bai_lian_region字段值为cn-hangzhou。
3、执行hermes guard --validate-policy验证当前策略与所选模型服务地域是否匹配，输出✅ Policy compliant表示通过。
