Skip to content

feat: 实现 Agent Query Sink - #111

Merged
xiaoland merged 8 commits into
mainfrom
feat/agent-query-sink
Sep 20, 2026
Merged

xiaoland merged 8 commits into
mainfrom
feat/agent-query-sink

Conversation

@xiaoland

@xiaoland xiaoland commented Sep 20, 2026

Copy link
Copy Markdown
Member

产品行为

新增 core.agent-query.v1:由 AI 组合 info-base retrieval、Resolver read 与 graph navigation,异步交付
answer + references。Sink 启用时挂载 /sinks/{id}/query,请求创建 core.sink.agent-query.v1 Job;禁用时
撤下该实例的 route。CLI 提供 Sink 管理与 query,继续作为独立 REST consumer。

架构与维护

  • 通用读取 Tool controller 从 Organization 迁回 info-base、Resolver 与 Graph Navigation owner;Agent registry
    只负责 binding/execution,不建立中央 agent_tools business package。
  • 显式 Core Tool bootstrap 包含 Sink-owned submit_query_result,独立入口无需借助 REST import chain 注册。
  • 同实例 Sink lifecycle 串行化,SinkBase hooks 默认为 no-op;动态路由按实际对象 ownership 撤下并刷新 OpenAPI。
  • Resolver 动态 schema 保留 provider 顶层字段与条件分支,代码解释 schema 投影和逐调用验证的不同职责。
  • CLI 对未发布的动态 schema 返回结构化错误;共享 JSON 投影使用领域中立的错误说明。
  • 文档 authority 修正依赖 Hub draft PR InKCre/docs#29。设计/预演文件
    标明历史基线,当前合同归 Unit TDD,执行证据归 unit packet。

复用现有 Sink/Job/Agent 表;无新依赖、schema migration 或发布编排变更。Core/CLI fragments 仅声明发行意图。

验证

  • pdm run check(14 passed、60 skipped)、pdm run -p cli checkpdm build -p cli、release contract 检查。
  • Preview 真实模型 A1–A4:事实查询、跨材料比较、证据不足、媒体文字子图、有界等待、abort、timeout、双 Sink
    lifecycle 与通用 Job admission;Organization 回归通过迁移后的读取工具及既有 graph 写入链路。
  • Review 修正:独立进程 bootstrap 与重复调用通过;公开 Resolver schema 与修改前相同;双实例 HTTP/ASGI
    smoke 覆盖独立撤下、重启和 OpenAPI 更新。手工检查命令保存在 implementation-evidence,未增加自动化测试。
  • 27b24e7 的全部 CI 与 Preview 部署通过;通过已安装 CLI 复核 Tool discovery、submit_query_result schema、
    Sink 1 动态 query schema,并确认 /readyz 正常。

交付状态与残余

本 PR 保持 draft,未获合并授权。合并依赖 Hub PR #29。真实模型可能在预算内未提交结果,当前按合同将 Job
标记为 failed;未增加 provider 特例。内存 Thread、超大材料与 best-effort 收尾的既有限制保持不变。
Job runtime schema 与 hermetic profile 已核对一致;其手工同步关系记录为既有架构观察项,本 PR 不扩展为
database-contract 生成机制重构。

@xiaoland
xiaoland marked this pull request as ready for review September 20, 2026 11:35
@xiaoland
xiaoland merged commit ee6e2cf into main Sep 20, 2026
7 checks passed

This branch was successfully deployed

1 active deployment
preview 0cde4c7d Deployed Sep 20, 2026 by xiaoland via Retire preview resources #327
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant