From 43f3ad48e5269639d2691e8aaa19226a9dc0650f Mon Sep 17 00:00:00 2001 From: yumoqing Date: Thu, 10 Sep 2026 17:43:33 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E8=A1=A5=20agent=20=E9=80=9A?= =?UTF-8?q?=E7=94=A8=E8=83=BD=E5=8A=9B=E5=AF=B9=E9=BD=90=E7=AB=A0=E8=8A=82?= =?UTF-8?q?(memory/manage=5Fskill/process/subagent=20+=20=E8=AE=B0?= =?UTF-8?q?=E5=BF=86=E5=A4=9A=E7=A7=9F=E6=88=B7=20+=20required=E5=AD=97?= =?UTF-8?q?=E6=AE=B5)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index f7eaf08..0e3fd7f 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ | sd_projects | 软件项目定义（2026-09-10 自 pipeline-sdlc 迁入，跨产线共享） | | sd_project_role_models | 项目角色模型配置（同上迁入；下拉 codes 指 sd_role 字典 + llm_model(status=active)） | | pipeline_deliverables | 产线交付物（同上迁入；主要写入方 pipeline-bidding） | +| pipeline_user_memory | 跨会话持久记忆（2026-09-10 多租户：加 org_id/user_id 归属列，key 掺租户维度，迁移 m0023） | ## 跨产线共享资源（wwwroot/api/） @@ -59,3 +60,29 @@ wwwroot/pipeline_core -> ../pkgs/pipeline_core/wwwroot `_general/{uid}` 专属目录，与 AgentExecutor 的文件根一致 （_resolve_ws_path 越界保护只认该目录） - `wwwroot/api/agent_chat_generic.dspy`：纯通用会话入口（generic=True） + +## agent 通用能力对齐 Hermes（2026-09-10） + +把 Hermes Agent 的「写入侧/运行时侧」能力补齐给产线会话 agent，GENERAL_TOOLS +从 25 个扩到 29 个，新增四工具（定义在本模块 `agent_config.py`，handler 在 +pipeline-service `agent_loop_v2.py`）： + +| 工具 | 能力 | 隔离/门禁 | +|---|---|---| +| `memory` | add/list/remove 持久记忆（对齐 Hermes memory） | 多租户写入门禁在 handler：只能写 user/project/pipeline 域（global/org 种子域禁写），org_id/user_id 强制注入会话真实身份（忽略 LLM 传值），无身份拒写，remove 仅本人条目 | +| `manage_skill` | create/patch/write_file/remove_file/delete 技能（对齐 skill_manage） | 只落本租户 orgs/{org} 或 org 0 降级 users/{uid}；改 global 原版走 fork-on-write 继承副本；产线层拒改；子文件限 references/scripts/templates/assets | +| `process` | poll/log/wait/kill 后台任务（配套 run_command background） | 状态文件化在 workspace/.bg/，跨 worker 可见；只解析发起者 workspace | +| `subagent` | list/steer/stop/result 后台子 agent（配套 delegate_subtask background） | 同 workspace 并行上限 3、深度限制 1、子会话历史隔离 | + +`run_command` 加 `background`/`timeout` 参数；`delegate_subtask` 加 `background`。 + +**记忆多租户（memory_store.py）**：每条记忆带 org_id/user_id 归属列； +`visible_to()` 是唯一可见性权威（平台种子 org_id='' 全员只读 + org 归属本机构共享 + +user 归属仅本人 + pipeline/project 域带机构匹配）；`memory_key` = hash(content+org+ +user+scope+scope_id)，同内容跨租户 key 不同、唯一索引永不碰撞；`_evict_partition` +按 org+user 分区淘汰，agent 写入绝不删种子或他租户记忆；写后失效缓存保多 worker +一致。`get()` 是无过滤底层查询（管理用），agent 读取一律走 `get_visible()`。 + +**ToolDefinition.required 字段（2026-09-10）**：None=旧行为（全参数必填），含可选 +参数的工具须显式声明 required 列表，否则 `to_openai_schema()` 把可选参数标成 +required、LLM 被迫为每个参数编值。GENERAL_TOOLS 全部带可选参数的工具已补 required。