摘要: Snail AI 的 Server ↔ Client 双向 gRPC 通信机制项目采用 Server-Client 双向 gRPC 通信 架构。Agent(Client)同时扮演两个角色:gRPC 客户端:主动回调 Server(如创建对话、保存消息、RAG 搜索)gRPC 服务端:被动接收 Ser 阅读全文
posted @ 2026-09-22 18:08 雨也飘柔 阅读(6) 评论(0) 推荐(0)
摘要: 当 Server 通过 gRPC Streaming 将 /chat/dispatch 请求推送到 Agent 的 1790 端口时,ClientGrpcServer 接收并交给 ClientRequestDispatcher.streamingHandler()。 整体理解:不是"推送",而是"S 阅读全文
posted @ 2026-09-22 16:34 雨也飘柔 阅读(5) 评论(0) 推荐(0)
摘要: 一、GrpcRequestDispatcher 在 Server 端的角色 SnailAiServerGrpcServer 是 Server 端的 gRPC 服务器(监听 1789 端口),它接收来自 Agent(Client)的回调请求,而非用户的聊天请求。核心逻辑在 handleUnaryReq 阅读全文
posted @ 2026-09-22 16:15 雨也飘柔 阅读(2) 评论(0) 推荐(0)
摘要: 架构: snail-ai-server和 snail-ai-agent-example 的核心关系:Server-Client 架构,两个独立进程通过 gRPC 通信 整个系统分为 两个独立部署的服务: 完整调用链路: 用户请求 │ ▼┌─────────────────────────────── 阅读全文
posted @ 2026-09-21 15:54 雨也飘柔 阅读(10) 评论(0) 推荐(0)
摘要: 整体架构流程 各子包职责详解 核心能力总结文档解析:支持 PDF/Word/Excel/HTML/Markdown/纯文本,可选 Docling 外部服务增强解析(提取表格、图片、结构化元数据)图片 OCR:集成 PaddleOCR 对文档中的图片进行 OCR 识别,支持配额限制和质量评估智能分块: 阅读全文
posted @ 2026-09-21 09:29 雨也飘柔 阅读(5) 评论(0) 推荐(0)
摘要: 两大功能区域1. store/ — 短期记忆存储(策略模式)核心接口: 两种实现(通过配置切换): snail-ai: memory: short-term: store-type: db # 或 memory 滑动窗口机制 对话历史: [msg1, msg2, msg3, msg4, msg5, 阅读全文
posted @ 2026-09-20 18:01 雨也飘柔 阅读(5) 评论(0) 推荐(0)
摘要: 这是 Server 端智能体对话的核心功能模块,实现了聊天请求的责任链处理、gRPC 分发、回调处理和结果持久化。 四大功能区域1. chain/ — 聊天责任链(15 个 Handler)按 @Order 顺序执行的对话处理链: 辅助组件: | 类 | 作用 | | | | | AgentChat 阅读全文
posted @ 2026-09-20 17:57 雨也飘柔 阅读(6) 评论(0) 推荐(0)
摘要: 什么是 Rerank? 用户提问 → 向量检索(召回 Top-K 文档)→ Rerank 重排序 → 返回最相关的 Top-N 文档 → LLM 生成回答 向量检索速度快但精度有限,Rerank 通过更精细的模型对召回结果重新打分排序,显著提升最终检索质量。 三个子模块1. snail-ai-mod 阅读全文
posted @ 2026-09-20 17:27 雨也飘柔 阅读(13) 评论(0) 推荐(0)
摘要: snail-ai-agent-executor 三个子模块的职责这是 Agent Client 端的核心模块,负责接收 Server 分发来的聊天请求并实际调用 LLM 执行。三个子模块按依赖关系从底到顶: 1. snail-ai-agent-executor-model — 模型层职责:封装 Ch 阅读全文
posted @ 2026-09-20 14:57 雨也飘柔 阅读(9) 评论(0) 推荐(0)
摘要: Bean的生命周期 BeanPostProcessor接口的作用 InitializingBean与DisposableBean接口的作用 Spring | 深入理解Bean的生命周期 依赖注入和bean的初始化 Bean初始化时可以做的哪些事 Spring Bean的生命周期,实际应用场景 实际应 阅读全文
posted @ 2023-08-30 16:12 雨也飘柔 阅读(23) 评论(0) 推荐(0)