hermes agent核心api参数已结构化整理：/agents/{id}/tasks提交任务，/tools/{name}/execute调用工具，/trajectories/{id}/compress压缩轨迹，/generate为主推理入口，所有接口错误响应统一含error_code、message等字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您查阅Hermes Agent的API接口，但无法准确理解各参数含义或调用方式，则可能是由于接口参数说明分散在多个文件中且缺乏统一呈现。以下是整理并结构化呈现的Hermes Agent核心API接口参数说明：
一、/agents/{agent_id}/tasks 接口参数说明
该接口用于向指定Agent提交任务请求，遵循RESTful资源命名规范，采用POST方法创建新任务。其请求体为JSON格式，需严格匹配字段类型与约束条件。
1、task_id：字符串类型，必填项，用于唯一标识本次任务，建议使用UUIDv4格式。
2、parameters：对象类型，必填项，包含工具调用所需的具体参数，例如tool、command、file_path等，具体字段依所选tool动态变化。
3、timeout：整数类型，非必填，默认值为30，单位为秒，表示任务执行的最大等待时长，超时后系统将主动终止任务。
4、metadata：对象类型，非必填，允许携带任意键值对，用于记录上下文信息（如用户ID、会话ID），不参与执行逻辑。
二、/tools/{tool_name}/execute 接口参数说明
该接口用于直接调用注册工具，支持终端命令执行、文件读写、代码运行等能力。tool_name需与tools/registry.py中注册的名称完全一致，区分大小写。
1、tool_name：路径参数，必须为已注册工具名，例如terminal、file_tools、code_execution。
2、input：对象类型，必填项，内容结构由对应tool的函数签名决定；例如terminal.execute要求含command字段，file_tools.read要求含path字段。
3、context：字符串类型，非必填，用于传递前序步骤的输出结果，供当前工具解析使用，如上一步返回的临时文件路径。
4、stream：布尔类型，非必填，默认false；设为true时启用流式响应，适用于长时间运行命令的实时输出场景。
三、/trajectories/{traj_id}/compress 接口参数说明
该接口用于压缩轨迹数据以降低存储开销和传输延迟，适用于批量处理历史会话轨迹。压缩过程不可逆，原始轨迹将被归档保留于后台存储。
1、traj_id：路径参数，字符串类型，必填，对应environments/trajectory_store.py中存储的轨迹唯一标识。
2、method：字符串类型，非必填，默认值为"lossless"；可选值包括lossless（无损压缩）、lossy_summary（摘要式有损）、delta_only（仅保留差异）。
3、keep_original：布尔类型，非必填，默认true；若设为false，则压缩完成后自动删除原始轨迹数据。
4、max_size_mb：整数类型，非必填，仅当method为lossy_summary时生效，指定压缩后最大允许体积（单位MB）。
四、/generate 接口参数说明
该接口为Hermes Agent主推理入口，接收自然语言指令并触发完整代理工作流。其设计兼顾灵活性与安全性，所有输入均经redact.py过滤敏感字段。
1、prompt：字符串类型，必填，即用户输入的原始指令，长度限制为8192字符。
2、model：字符串类型，非必填，指定LLM后端模型名，例如minimax-m2.7、claude-3-5-sonnet-20241022，须与OPENROUTER_API_KEY权限匹配。
3、tools_enabled：数组类型，非必填，元素为字符串，列出本次调用允许使用的工具名，如["terminal", "file_tools"]；若为空则禁用全部工具。
4、max_steps：整数类型，非必填，默认值为15，限制代理自主规划的最大步骤数，防止无限循环。
五、错误响应通用参数说明
所有接口在发生异常时均返回标准JSON格式错误响应，便于客户端统一解析与重试。状态码遵循HTTP语义，响应体结构保持一致。
1、error_code：字符串类型，必填，为内部定义的错误码，例如TOOL_NOT_FOUND、INVALID_PARAMETER、AUTH_FAILED。
2、message：字符串类型，必填，面向开发者的简明错误描述，不含用户敏感信息。
3、details：对象类型，非必填，包含具体出错字段、期望类型、实际值等调试信息，仅在DEBUG模式下返回。
4、request_id：字符串类型，非必填，用于服务端日志追踪，每次请求唯一，便于排查问题链路。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
