09dca9f772
✨ feat(agent): 通用分流接入随口问图编排，修复任务查询条数与重复输出问题 - ♻️ 将 Agent 路由升级为通用 `action` 分流机制，统一支持 `chat` / `quick_note_create` / `task_query` - 🧩 新增 `taskquery` 子模块并落地图编排链路：`plan -> quadrant -> time_anchor -> tool_query -> reflect` - 🔧 在图内接入 `query_tasks` 工具调用，支持自动放宽检索条件与反思重试，最多重试 2 次 - 🚪 保持 `/agent/chat` 作为多合一入口，不额外新增任务查询 HTTP 接口 - 🪄 修复“随口问”场景下的双重列表输出问题：LLM 仅保留简短前缀，任务列表统一由后端进行确定性渲染 - 🎯 修复显式数量约束失效问题：支持提取“来一个”“前 3 个”“top5”等数量表达，并将其锁定为 `limit` - 🛡️ 防止在重试或放宽检索阶段改写用户显式指定的数量约束 - ✅ 补充并更新测试，覆盖路由解析、数量提取、`limit` 生效及重复输出等关键场景 📝 docs: 更新随口问链路文档与决策记录 - 📚 更新 README 5.4，新增/修订随口问链路 Mermaid 图 - 🧭 新增随口问功能决策记录 FDR
89 lines
2.3 KiB
Go
89 lines
2.3 KiB
Go
package taskquery
|
||
|
||
import "time"
|
||
|
||
const (
|
||
// DefaultTaskQueryLimit 是任务查询默认返回条数。
|
||
DefaultTaskQueryLimit = 5
|
||
// MaxTaskQueryLimit 是任务查询最大返回条数。
|
||
MaxTaskQueryLimit = 20
|
||
// DefaultReflectRetryMax 是反思重试默认上限。
|
||
DefaultReflectRetryMax = 2
|
||
)
|
||
|
||
// TaskQueryState 是任务查询图在节点间传递的统一状态容器。
|
||
//
|
||
// 职责边界：
|
||
// 1. 保存“规划参数、查询结果、反思决策、最终回复”；
|
||
// 2. 控制“是否重试 + 已重试次数”状态机；
|
||
// 3. 不负责真正查库，查库由工具执行。
|
||
type TaskQueryState struct {
|
||
// 请求上下文
|
||
UserMessage string
|
||
RequestNowText string
|
||
|
||
// 规划结果
|
||
UserGoal string
|
||
Plan QueryPlan
|
||
// ExplicitLimit 表示“用户原话中明确指定的数量”。
|
||
//
|
||
// 语义说明：
|
||
// 1. 0 代表未显式指定；
|
||
// 2. >0 时应锁定该数量，不允许反思补丁或自动放宽改写。
|
||
ExplicitLimit int
|
||
|
||
// 上一轮查询结果
|
||
LastQueryItems []TaskQueryToolRecord
|
||
LastQueryTotal int
|
||
|
||
// 自动放宽状态
|
||
AutoBroadenApplied bool
|
||
|
||
// 反思状态
|
||
RetryCount int
|
||
MaxReflectRetry int
|
||
NeedRetry bool
|
||
ReflectReason string
|
||
|
||
// 最终输出
|
||
FinalReply string
|
||
}
|
||
|
||
// QueryPlan 是“任务查询计划”的统一结构。
|
||
//
|
||
// 语义说明：
|
||
// 1. Quadrants 为空表示“查全部象限”；非空表示“只查这些象限”；
|
||
// 2. DeadlineBefore/AfterText 保留原始文本，方便日志和反思 prompt；
|
||
// 3. DeadlineBefore/After 是解析后的时间对象，供工具调用使用。
|
||
type QueryPlan struct {
|
||
Quadrants []int
|
||
|
||
SortBy string
|
||
Order string
|
||
Limit int
|
||
|
||
IncludeCompleted bool
|
||
Keyword string
|
||
|
||
DeadlineBeforeText string
|
||
DeadlineAfterText string
|
||
DeadlineBefore *time.Time
|
||
DeadlineAfter *time.Time
|
||
}
|
||
|
||
// NewTaskQueryState 创建任务查询初始状态。
|
||
func NewTaskQueryState(userMessage, requestNowText string, maxReflectRetry int) *TaskQueryState {
|
||
if maxReflectRetry <= 0 {
|
||
maxReflectRetry = DefaultReflectRetryMax
|
||
}
|
||
return &TaskQueryState{
|
||
UserMessage: userMessage,
|
||
RequestNowText: requestNowText,
|
||
MaxReflectRetry: maxReflectRetry,
|
||
LastQueryItems: make([]TaskQueryToolRecord, 0),
|
||
NeedRetry: false,
|
||
ReflectReason: "",
|
||
AutoBroadenApplied: false,
|
||
}
|
||
}
|