149 lines
8.2 KiB
Go
149 lines
8.2 KiB
Go
package intent
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
// IntentType 核心意图类别定义
|
|
type IntentType string
|
|
|
|
const (
|
|
IntentQueryProgress IntentType = "QUERY_PROGRESS" // 查询进度、成熟度、风险研判或沟通话术
|
|
IntentSupplementInfo IntentType = "SUPPLEMENT_INFO" // 补充/修改材料、事实信息或参数
|
|
IntentAdvanceStage IntentType = "ADVANCE_STAGE" // 确认推进到下一成熟度阶段 (如 V0.1 -> V0.5)
|
|
IntentTriggerTask IntentType = "TRIGGER_TASK" // 显式生成或重新执行特定交付物任务 (如 intake, quote)
|
|
IntentCasualChat IntentType = "CASUAL_CHAT" // 问候、闲聊或通用帮助引导
|
|
IntentDeclineExpectation IntentType = "DECLINE_EXPECTATION" // 用户明确暂缓/不采纳上轮建议 (非阻塞放弃)
|
|
|
|
// 法定文档治理流转
|
|
IntentDocGovClaim IntentType = "DOCGOV_CLAIM"
|
|
IntentDocGovSubmitReview IntentType = "DOCGOV_SUBMIT_REVIEW"
|
|
IntentDocGovReviewApprove IntentType = "DOCGOV_REVIEW_APPROVE"
|
|
IntentDocGovReviewReject IntentType = "DOCGOV_REVIEW_REJECT"
|
|
IntentDocGovFinalApprove IntentType = "DOCGOV_FINAL_APPROVE"
|
|
IntentDocGovFinalReject IntentType = "DOCGOV_FINAL_REJECT"
|
|
IntentDocGovProposalDecide IntentType = "DOCGOV_PROPOSAL_DECIDE"
|
|
|
|
// 决策与合规查询
|
|
IntentQueryRegulations IntentType = "QUERY_REGULATIONS"
|
|
IntentQuerySimilarCases IntentType = "QUERY_SIMILAR_CASES"
|
|
IntentQueryUserRights IntentType = "QUERY_USER_RIGHTS"
|
|
|
|
// 安全与权限红线拦截
|
|
IntentSecurityForbidden IntentType = "SECURITY_FORBIDDEN"
|
|
)
|
|
|
|
// ResolutionBranch 三分支意图消解类别
|
|
type ResolutionBranch string
|
|
|
|
const (
|
|
BranchExpectationHit ResolutionBranch = "EXPECTATION_HIT" // 分支 1: 命中历史轮次挂起预期 (肯定/选择/带补丁/取消)
|
|
BranchNewIntentPreempt ResolutionBranch = "NEW_INTENT_PREEMPT" // 分支 2: 独立新意图抢占 (用户意图最高优先级)
|
|
BranchAmbiguousFallback ResolutionBranch = "AMBIGUOUS_FALLBACK" // 分支 3: 模糊/无实际意义兜底 (参谋主动分析引导)
|
|
)
|
|
|
|
// ExpectationOption 供用户挑选或单字快速兑现的具体选项
|
|
type ExpectationOption struct {
|
|
OptionID string `json:"option_id"` // 选项代号 (如 "1", "2", "advance_v05")
|
|
Title string `json:"title"` // 选项简述 (如 "推进到 V0.5 方案成型与法规对齐")
|
|
Description string `json:"description,omitempty"` // 参谋为用户做的工作说明与收益分析
|
|
Intent IntentType `json:"intent"` // 对应绑定的业务意图
|
|
Slots map[string]string `json:"slots,omitempty"` // 预设槽位键值对
|
|
}
|
|
|
|
// PendingExpectation 挂起预期草稿（非阻塞桌角备忘贴纸）
|
|
type PendingExpectation struct {
|
|
ExpectationID string `json:"expectation_id,omitempty"`
|
|
ExpectedIntent IntentType `json:"expected_intent,omitempty"`
|
|
TargetAction string `json:"target_action,omitempty"`
|
|
Prompt string `json:"prompt,omitempty"`
|
|
AffirmativeWord string `json:"affirmative_word,omitempty"`
|
|
DeclineWord string `json:"decline_word,omitempty"`
|
|
ExpiresAt time.Time `json:"expires_at,omitempty"`
|
|
Payload map[string]string `json:"payload,omitempty"`
|
|
ContextSnippet string `json:"context_snippet,omitempty"` // 上一轮建议的业务背景简述
|
|
DefaultOption *ExpectationOption `json:"default_option,omitempty"` // 参谋最推荐的基准选项（用户说“好/行”时默认执行）
|
|
Options []ExpectationOption `json:"options,omitempty"` // 供用户挑选的备选选项列表
|
|
AllowAffirmative bool `json:"allow_affirmative"` // 是否允许用单字肯定（好/行/可以）触发
|
|
CreatedAt time.Time `json:"created_at"` // 挂起时间
|
|
}
|
|
|
|
// CandidateIntent 候选意图提案（L1 对话层输出，由 L2 协调层终审）
|
|
type CandidateIntent struct {
|
|
Intent IntentType `json:"intent"`
|
|
Confidence float64 `json:"confidence"` // 置信度 0.0 - 1.0
|
|
Branch ResolutionBranch `json:"branch"` // 归属的三分支判定
|
|
FilledSlots map[string]string `json:"filled_slots"`
|
|
MissingSlots []string `json:"missing_slots,omitempty"`
|
|
Reasoning string `json:"reasoning"` // 判断依据与文本佐证
|
|
ClarificationQuestion string `json:"clarification_question,omitempty"` // 槽位缺失时的澄清追问
|
|
MatchedOption *ExpectationOption `json:"matched_option,omitempty"` // 分支 1 命中的具体选项
|
|
PatchSlots map[string]string `json:"patch_slots,omitempty"` // 分支 1 复合输入的增量槽位补丁
|
|
IsDecline bool `json:"is_decline,omitempty"` // 是否为明确暂缓/放弃
|
|
}
|
|
|
|
// IntentRecognitionResult 意图识别完整输出（多输出策略）
|
|
type IntentRecognitionResult struct {
|
|
RawInput string `json:"raw_input"`
|
|
TopIntent *CandidateIntent `json:"top_intent"`
|
|
Candidates []CandidateIntent `json:"candidates"`
|
|
ContextSnapshotID string `json:"context_snapshot_id,omitempty"`
|
|
RequiresClarifying bool `json:"requires_clarifying"`
|
|
Branch ResolutionBranch `json:"branch"` // 顶层分支标记
|
|
}
|
|
|
|
// 常见槽位 Key 常量定义
|
|
const (
|
|
SlotTargetStage = "target_stage" // 目标阶段 (如 V0.1_triage, V0.5_feasibility, V1.0_quoting)
|
|
SlotTargetTask = "target_task" // 目标任务 (如 intake, research, cdo_quote)
|
|
SlotFactKey = "fact_key" // 事实键 (如 target_market, device_type)
|
|
SlotFactValue = "fact_value" // 事实值
|
|
SlotSupplementDoc = "supplement_doc" // 补充内容文本
|
|
SlotQueryTopic = "query_topic" // 查询主题 (如 progress, risk, talk_script, quotation)
|
|
|
|
// 法定文档治理与权限槽位
|
|
SlotTargetDoc = "target_doc"
|
|
SlotRejectReason = "reject_reason"
|
|
SlotTargetSection = "target_section"
|
|
SlotProposalAction = "proposal_action"
|
|
SlotForbiddenTarget = "forbidden_target"
|
|
)
|
|
|
|
// CardAction 交互卡片按钮动作
|
|
type CardAction struct {
|
|
ActionID string `json:"action_id"`
|
|
Label string `json:"label"`
|
|
Style string `json:"style"` // primary, danger, subtle
|
|
Payload map[string]string `json:"payload,omitempty"`
|
|
IsAffirmativeDefault bool `json:"is_affirmative_default,omitempty"`
|
|
}
|
|
|
|
// InteractiveCardPayload 对话交互卡片载荷
|
|
type InteractiveCardPayload struct {
|
|
CardID string `json:"card_id"`
|
|
CardType string `json:"card_type"` // CONFIRMATION, SLOT_FILLING, DIFF_PROPOSAL, REMINDER_NOTICE
|
|
Title string `json:"title"`
|
|
TargetDocID string `json:"target_doc_id,omitempty"`
|
|
TargetDocTitle string `json:"target_doc_title,omitempty"`
|
|
TargetSectionID string `json:"target_section_id,omitempty"`
|
|
SectionTitle string `json:"section_title,omitempty"`
|
|
ProposedContent string `json:"proposed_content,omitempty"`
|
|
ImpactRisk string `json:"impact_risk,omitempty"`
|
|
CurrentStatus string `json:"current_status"` // active, executing, resolved, cancelled, outdated, expired
|
|
TTLTurns int `json:"ttl_turns"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
Actions []CardAction `json:"actions,omitempty"`
|
|
}
|
|
|
|
// ContextSnapshot 传递给 L1 意图识别器的轻量上下文快照
|
|
type ContextSnapshot struct {
|
|
SnapshotID string `json:"snapshot_id,omitempty"`
|
|
ProjectName string `json:"project_name,omitempty"`
|
|
CurrentStage string `json:"current_stage,omitempty"`
|
|
ActiveDocID string `json:"active_doc_id,omitempty"`
|
|
DocLifecycleState string `json:"doc_lifecycle_state,omitempty"`
|
|
UserDocRole string `json:"user_doc_role,omitempty"`
|
|
AvailableActions []string `json:"available_actions,omitempty"`
|
|
PendingExpectation *PendingExpectation `json:"pending_expectation,omitempty"`
|
|
}
|