union-app-chat-stream 1.0.3

package/knowledge/000034-scenario-offline-3a13d49a3a-v1.md

@@ -0,0 +1,138 @@
+---
+kb_id: scenario-offline-3a13d49a3a-v1
+title: 自由格式报文-场景七
+doc_type: scenario
+domain: 联合运维
+category: Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+category_description: 本分类来源于《Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3》，主要覆盖：网络支付清算平台
+  联合运维互联互通技术规范；1 范围；2 规范性引用文件；3 术语和定义；3.1 网络支付清算平台 electronics payment clearing of
+  China；3.2 联合运维成员单位；3.3 报文 message；4 通讯规范。
+category_keywords:
+- NUC
+- '601'
+- '2023'
+- 网络支付清算平台
+- 联合运维互联互通技术规范V1.3
+- Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+- 联合运维互联互通技术规范
+- 网络支付清算平台 联合运维互联互通技术规范
+- 范围
+- 1 范围
+- 规范性引用文件
+- 2 规范性引用文件
+- 术语和定义
+- 3 术语和定义
+- '3.1'
+- electronics
+business_modules:
+- 网络支付清算平台
+- 联合运维互联互通技术规范V1.3
+source_doc: 互联互通机制规范.md
+source_version: V1.3
+source_section: B.11 自由格式报文-场景七
+source_order: 34
+source_pages: []
+source_trace: section=B.11 自由格式报文-场景七
+effective_date: ''
+owner: 联合运维知识库
+confidentiality: 内部
+risk_level: low
+applicable_roles: []
+tags:
+- 自由格式报文
+- 场景七
+- 报文结构
+- 请求报文
+- 应答报文
+- sysId
+- msgId
+- sendDate
+- senderInstId
+- receiverInstId
+- direction
+- sceneId
+- title
+- content
+- priority
+- signature
+- rspCd
+- rspMsg
+status: active
+---
+
+# 自由格式报文-场景七
+
+知识大类说明：
+大类：Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+说明：本分类来源于《Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3》，主要覆盖：网络支付清算平台 联合运维互联互通技术规范；1 范围；2 规范性引用文件；3 术语和定义；3.1 网络支付清算平台 electronics payment clearing of China；3.2 联合运维成员单位；3.3 报文 message；4 通讯规范。
+关键词：NUC、601、2023、网络支付清算平台、联合运维互联互通技术规范V1.3、Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3、联合运维互联互通技术规范、网络支付清算平台 联合运维互联互通技术规范、范围、1 范围、规范性引用文件、2 规范性引用文件、术语和定义、3 术语和定义、3.1、electronics
+
+## 1. 核心内容
+
+场景七为自由格式报文的一种应用场景，用于传输工单相关信息。请求报文包含工单标题、工单内容和优先级。应答报文包含应答消息。报文结构包含报文头、报文体和签名域。
+
+### 请求报文结构
+
+{
+  "request": {
+    "head": {
+      "sysId": "uops",
+      "msgId": "uops051.000.01",
+      "sendDate": "YYYY-MM-DD HH:mm:ss",
+      "senderInstId": "发起方机构标识",
+      "receiverInstId": "接收方机构标识",
+      "direction": "01"
+    },
+    "body": {
+      "sceneId": "07",
+      "content": {
+        "title": "工单标题",
+        "content": "工单内容",
+        "priority": "优先级"
+      }
+    },
+    "signature": "签名内容"
+  }
+}
+
+### 应答报文结构
+
+{
+  "response": {
+    "head": {
+      "sysId": "uops",
+      "msgId": "uops051.000.01",
+      "sendDate": "YYYY-MM-DD HH:mm:ss",
+      "senderInstId": "发起方机构标识",
+      "receiverInstId": "接收方机构标识",
+      "direction": "01",
+      "rspCd": "0000",
+      "rspMsg": "应答消息"
+    },
+    "body": {},
+    "signature": "签名内容"
+  }
+}
+
+## 2. 适用边界
+
+本场景适用于自由格式报文的第七种应用场景，用于工单信息的传输。适用于网络支付清算平台联合运维互联互通技术规范V1.3中定义的通讯规范。
+
+## 3. 使用要求
+
+1. 请求报文必须包含报文头、报文体和签名域。
+2. 报文体中必须包含sceneId为"07"，以及工单标题、工单内容和优先级。
+3. 应答报文必须包含报文头、报文体和签名域。
+4. 报文头中必须包含sysId、msgId、sendDate、senderInstId、receiverInstId、direction、rspCd和rspMsg。
+5. 报文体中应答报文为空对象。
+6. 签名域必须包含签名内容。
+
+## 4. 关联能力
+
+暂无。
+
+## 5. 来源依据
+
+- 来源文档：互联互通机制规范.md
+- 来源章节：B.11 自由格式报文-场景七
+- 来源说明：基于来源章节归纳，需人工复核原文一致性。

package/knowledge/000035-scenario-offline-fd5560211f-v1.md

@@ -0,0 +1,147 @@
+---
+kb_id: scenario-offline-fd5560211f-v1
+title: 自由格式报文-场景八
+doc_type: scenario
+domain: 联合运维
+category: Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+category_description: 本分类来源于《Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3》，主要覆盖：网络支付清算平台
+  联合运维互联互通技术规范；1 范围；2 规范性引用文件；3 术语和定义；3.1 网络支付清算平台 electronics payment clearing of
+  China；3.2 联合运维成员单位；3.3 报文 message；4 通讯规范。
+category_keywords:
+- NUC
+- '601'
+- '2023'
+- 网络支付清算平台
+- 联合运维互联互通技术规范V1.3
+- Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+- 联合运维互联互通技术规范
+- 网络支付清算平台 联合运维互联互通技术规范
+- 范围
+- 1 范围
+- 规范性引用文件
+- 2 规范性引用文件
+- 术语和定义
+- 3 术语和定义
+- '3.1'
+- electronics
+business_modules:
+- 网络支付清算平台
+- 联合运维互联互通技术规范V1.3
+source_doc: 互联互通机制规范.md
+source_version: V1.3
+source_section: B.12 自由格式报文-场景八
+source_order: 35
+source_pages: []
+source_trace: section=B.12 自由格式报文-场景八
+effective_date: ''
+owner: 联合运维知识库
+confidentiality: 内部
+risk_level: low
+applicable_roles: []
+tags:
+- 自由格式报文
+- 场景八
+- 报文结构
+- 请求报文
+- 应答报文
+- sysId
+- msgId
+- sendDate
+- senderInstId
+- receiverInstId
+- direction
+- sceneId
+- instName
+- instId
+- reinstName
+- reinstId
+- infoNo
+- startTime
+- rspCd
+- rspMsg
+- 签名内容
+status: active
+---
+
+# 自由格式报文-场景八
+
+知识大类说明：
+大类：Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3
+说明：本分类来源于《Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3》，主要覆盖：网络支付清算平台 联合运维互联互通技术规范；1 范围；2 规范性引用文件；3 术语和定义；3.1 网络支付清算平台 electronics payment clearing of China；3.2 联合运维成员单位；3.3 报文 message；4 通讯规范。
+关键词：NUC、601、2023、网络支付清算平台、联合运维互联互通技术规范V1.3、Q/NUC 601-2023 网络支付清算平台 联合运维互联互通技术规范V1.3、联合运维互联互通技术规范、网络支付清算平台 联合运维互联互通技术规范、范围、1 范围、规范性引用文件、2 规范性引用文件、术语和定义、3 术语和定义、3.1、electronics
+
+## 1. 核心内容
+
+场景八为自由格式报文的一种应用场景，用于传输发起方与接收方之间的特定信息。请求报文包含报文头、报文体和签名域，应答报文包含报文头、报文体和签名域。
+
+### 请求报文结构
+
+请求报文结构如下：
+
+{
+  "request": {
+    "head": {
+      "sysId": "uops",
+      "msgId": "uops051.000.01",
+      "sendDate": "YYYY-MM-DD HH:mm:ss",
+      "senderInstId": "发起方机构标识",
+      "receiverInstId": "接收方机构标识",
+      "direction": "01"
+    },
+    "body": {
+      "sceneId": "08",
+      "content": {
+        "instName": "发起方单位名称",
+        "instId": "发起方金融编码",
+        "reinstName": "接收方单位名称",
+        "reinstId": "接收方金融编码",
+        "infoNo": "信息编号",
+        "startTime": "开始时间"
+      }
+    },
+    "signature": "签名内容"
+  }
+}
+
+### 应答报文结构
+
+应答报文结构如下：
+
+{
+  "response": {
+    "head": {
+      "sysId": "uops",
+      "msgId": "uops051.000.01",
+      "sendDate": "YYYY-MM-DD HH:mm:ss",
+      "senderInstId": "发起方机构标识",
+      "receiverInstId": "接收方机构标识",
+      "direction": "01",
+      "rspCd": "0000",
+      "rspMsg": "应答消息"
+    },
+    "body": {},
+    "signature": "签名内容"
+  }
+}
+
+## 2. 适用边界
+
+本场景适用于网络支付清算平台联合运维互联互通技术规范V1.3中定义的自由格式报文场景八，用于传输发起方与接收方之间的特定信息。具体包括发起方单位名称、发起方金融编码、接收方单位名称、接收方金融编码、信息编号和开始时间等信息的交互。
+
+## 3. 使用要求
+
+1. 请求报文必须包含完整的报文头、报文体和签名域。
+2. 报文体中的sceneId必须为"08"。
+3. 报文体中的content字段必须包含instName、instId、reinstName、reinstId、infoNo和startTime。
+4. 应答报文必须包含报文头、报文体和签名域。
+5. 应答报文头中的rspCd和rspMsg字段用于返回应答结果。
+
+## 4. 关联能力
+
+暂无。
+
+## 5. 来源依据
+
+- 来源文档：互联互通机制规范.md
+- 来源章节：B.12 自由格式报文-场景八
+- 来源说明：基于来源章节归纳，需人工复核原文一致性。

package/knowledge/000036-scenario-offline-function-call-mock-v1.md

@@ -0,0 +1,134 @@
+---
+kb_id: scenario-offline-function-call-mock-v1
+title: 成员机构运行质量分析场景指南
+doc_type: scenario
+domain: 联合运维
+category: 运行质量分析
+category_description: 指导模型在联合运维场景中围绕成员机构运行质量调用工具、组织证据并形成分析结论。
+category_keywords:
+  - 运行质量
+  - 成员机构
+  - 系统成功率
+  - 平均耗时
+  - 交易量
+  - 失败率
+  - 变更报备
+  - Jira故障
+  - 根因辅助分析
+status: active
+---
+
+# 成员机构运行质量分析场景指南
+
+当用户询问某家成员机构“近期运行质量如何”“过去一段时间运行表现怎样”“有没有影响运行质量的因素”时，应把问题识别为成员机构运行质量分析场景。
+
+运行质量不是单一系统成功率指标。系统成功率是核心指标，但平均耗时、交易量、失败笔数、失败率、同期变更、同期故障都会影响对运行质量的判断。
+
+## 默认时间范围
+
+用户没有明确时间范围时，使用近 30 天作为默认分析窗口，并在回答中说明“按近 30 天分析”。
+
+常见时间表达处理规则：
+
+- “近期”“最近”“过去一段时间”：近 30 天。
+- “本月”：当前自然月开始日至当前日期。
+- “上月”：上一自然月。
+- “过去 N 天”：按用户给出的 N 天。
+- “过去 N 个月”：按用户给出的 N 个月。
+- 如果用户给出明确日期，以用户日期为准。
+
+工具入参中的日期优先使用 `yyyyMMdd` 格式，例如 `20260513`。
+
+## 推荐工具调用顺序
+
+分析某家机构时，优先按以下顺序调用工具：
+
+1. `resolve_member_org`
+
+   根据用户输入的机构名称、简称或别名识别标准机构和 `orgCode`。例如用户说“中国银行”“中行”“BOC”，不要直接猜测机构编码。
+
+2. `query_member_runtime_metrics`
+
+   使用 `orgCode + startDate + endDate` 查询该机构每日运行指标。重点关注系统成功率、平均耗时、交易笔数、失败笔数、失败率。
+
+3. `query_member_change_announcements`
+
+   使用同一机构和同一时间窗口查询变更报备。重点关注计划开始时间、计划结束时间、变更状态、执行评价、影响范围。
+
+4. `query_member_jira_faults`
+
+   使用同一机构和同一时间窗口查询 Jira 故障工单。重点关注故障时间、恢复时间、故障等级、影响范围、影响描述、故障原因。
+
+5. `query_full_link_runtime_metrics`
+
+   当需要判断某机构异常是否具有全局背景时，可查询同一时间窗口的全链路指标作为对照。如果全链路整体稳定而单机构异常，更偏向机构侧因素；如果全链路同时波动，更偏向平台或公共链路因素。
+
+## 运行指标分析方法
+
+应综合判断以下指标：
+
+- 系统成功率：核心稳定性指标。下降代表交易成功能力变弱。
+- 失败率和失败笔数：用于判断成功率变化背后的实际影响。低交易量下成功率波动可能被放大，高交易量下少量成功率下降也可能代表大量失败交易。
+- 平均耗时：核心性能指标。成功率稳定但耗时明显上升，说明用户体验和处理性能可能劣化。
+- 交易笔数：核心业务流量指标。成功率稳定但交易量异常下降，可能代表业务流量、接入、路由或前置系统存在问题。
+- 连续性：单日尖峰和连续多日劣化含义不同。连续多日成功率下降、耗时上升或失败率升高，风险更高。
+
+分析时不要只看单个日期，也要观察趋势：
+
+- 成功率是否低于近期均值。
+- 平均耗时是否持续升高。
+- 失败笔数是否集中在某几天。
+- 交易笔数是否突然下降或突然放大。
+- 成员机构指标是否明显偏离全链路指标。
+
+## 变更关联分析方法
+
+变更可能影响运行质量，但不能仅凭时间接近就断言变更导致异常。应做相关性判断：
+
+- 如果运行指标劣化时间与变更计划开始时间、执行时间高度重合，标记为“变更相关性较高”。
+- 如果变更执行评价为异常、失败、回退、部分成功，且同日或次日运行指标劣化，标记为重点关注。
+- 如果变更影响范围包含核心支付链路、前置系统、网络策略、清算链路、接入链路，相关性高于普通配置或低风险变更。
+- 如果变更时间远离指标波动时间，或变更执行评价正常且影响范围较小，应降低变更相关性。
+
+回答时使用“可能相关”“相关性较高”“需要进一步核实”，不要直接说“由该变更导致”。
+
+## 故障关联分析方法
+
+Jira 故障是解释运行质量波动的重要证据：
+
+- 如果故障发生时间与成功率下降、失败率升高、耗时上升时间重合，故障相关性较高。
+- 高等级故障、影响范围涉及该成员机构核心交易链路时，应提高风险判断。
+- 故障恢复时间之后指标恢复，说明故障与运行质量波动可能存在较强关联。
+- 故障原因如果指向网络、前置系统、核心支付链路、数据库、中间件、限流、超时，与耗时和失败率变化更相关。
+- 多个低等级故障集中发生，也可能形成累计影响。
+
+同样不能直接断言因果。应说明证据链：故障时间、故障等级、影响范围、指标变化之间是否吻合。
+
+## 总体运行质量判断
+
+可以使用以下分层：
+
+- 良好：成功率稳定，耗时稳定，交易量无异常，失败笔数和失败率低，未发现相关变更或故障影响。
+- 基本稳定但需关注：核心指标总体正常，但存在单日波动、耗时上升、交易量异常、轻微故障或近期变更。
+- 有波动：成功率或失败率出现明显波动，或耗时/交易量有异常，同时存在同期变更或故障。
+- 明显异常：成功率下降、失败率上升、耗时明显恶化或交易量异常，并且故障或异常变更与波动时间高度重合。
+
+## 输出建议结构
+
+回答运行质量分析问题时，建议使用以下结构：
+
+1. 总体判断：一句话说明运行质量是良好、基本稳定、有波动还是明显异常。
+2. 运行指标表现：说明成功率、平均耗时、交易量、失败笔数、失败率的主要变化。
+3. 变更关联分析：列出同期变更及其计划时间、状态、执行评价、影响范围，并判断相关性。
+4. 故障关联分析：列出同期故障及故障时间、等级、影响范围、原因、恢复情况，并判断相关性。
+5. 可能影响因素排序：按证据强弱排序，例如故障影响、变更影响、交易量变化、全链路背景等。
+6. 不确定性：说明哪些结论只是相关性判断，哪些需要进一步查看日志、监控或工单详情。
+7. 建议动作：例如关注后续指标、复核变更执行记录、跟进未关闭故障、对异常日期做链路排查。
+
+## 重要约束
+
+- 不要编造机构编码。缺少 `orgCode` 时先调用 `resolve_member_org`。
+- 不要只基于系统成功率下结论。
+- 不要把变更或故障直接断定为根因，除非工具返回中已有明确结论。
+- 如果工具数据为空，应明确说明“未查询到相关数据”，不要补造。
+- 如果运行指标、变更、故障之间结论冲突，应分别说明证据，并给出保守判断。

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "union-app-chat-stream",
+  "version": "1.0.3",
+  "description": "Union operations chat stream Flask application package.",
+  "license": "UNLICENSED",
+  "files": [
+    "app",
+    "deploy",
+    "!deploy/offline-packages",
+    "!deploy/offline-packages/**",
+    "knowledge",
+    "tools",
+    "PROJECT_OVERVIEW.md",
+    "requirements.txt",
+    "ci.yml",
+    ".gitignore"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,53 @@
+annotated-types==0.7.0
+anyio==4.6.2
+blinker==1.8.2
+certifi==2025.8.3
+charset-normalizer==3.4.4
+click==8.1.8
+concurrent-log-handler==0.9.28
+curlify==3.0.0
+distro==1.9.0
+dnspython==2.6.1
+exceptiongroup==1.3.0
+Flask==3.0.3
+Flask-Cors==5.0.0
+h11==0.16.0
+h2==4.1.0
+hpack==4.0.0
+httpcore==1.0.9
+httpx==0.28.1
+Hypercorn==0.17.3
+hyperframe==6.0.1
+idna==3.10
+itsdangerous==2.2.0
+Jinja2==3.1.6
+jiter==0.9.1
+loguru==0.7.3
+lxml==6.0.1
+MarkupSafe==2.1.5
+numpy>=2.0.0,<2.5.0
+opencv-python>=4.13.0.90
+openai==1.107.3
+packaging==25.0
+portalocker==3.0.0
+priority==2.0.0
+PyJWT==2.9.0
+python-dateutil==2.9.0.post0
+python-dotenv==1.0.1
+pytz==2025.2
+requests==2.32.5
+six==1.17.0
+sniffio==1.3.1
+tqdm==4.67.3
+typing_extensions==4.15.0
+tzdata==2025.2
+urllib3==1.26.20
+Werkzeug==3.0.6
+wsproto==1.2.0
+zipp==3.20.2
+pydantic==2.13.4
+pyyaml==6.0.3
+zai-sdk==0.2.2
+chromadb==1.5.9
+pysqlite3-binary==0.5.4
+typer==0.15.1

package/tools/prompts.yaml

@@ -0,0 +1,10 @@
+tool_routing_prompt: |
+  你正在处理网络支付清算平台联合运维智能助手问题。先结合对话历史理解用户真实意图，再选择工具，并遵守：
+  1. 可执行工具以本次请求传入的 tools 列表为准；不要调用未出现在 tools 列表中的函数。
+  2. `tools/tool_definitions.yaml` 是工具名称、用途、入参和返回结构的权威来源。知识库中的“关联函数/关联能力”只作为路由提示，不是可执行调用配置；如二者不一致，以当前 tools 列表为准。
+  3. 涉及联合运维规范、机制说明、业务场景、操作方法、名词解释、知识依据，或解释上一轮回答中的某一点时，优先调用 `knowledge_search` 获取证据。
+  4. 多轮追问中出现“第几项”“第几点”“刚才那个”“继续解释”“展开说说”等省略表达时，调用 `knowledge_search` 前必须结合历史上下文把 query 改写为完整、独立的问题。
+  5. 涉及成员机构名称但缺少 orgCode 时，先调用 `resolve_member_org`；涉及运行指标、变更、故障时，再按场景调用对应业务工具。
+  6. 用户未提供必要参数时不要编造；可以根据知识库明确规则补全默认时间范围，无法确定时说明缺少的信息。
+  7. 工具返回结果是业务证据。最终回答应综合用户原问题、对话历史、工具结果和知识库来源，说明结论、依据和下一步建议。
+  8. 对联合运维业务、规范、运行质量、变更、故障、机构问题，不要脱离对话历史或工具证据直接编造答案。