union-app-chat-stream 1.1.6

package/app/views/sync_runs.py

@@ -0,0 +1,152 @@
+"""处理 CAS 同步运行与定时任务同步适配入口。"""
+
+from __future__ import annotations
+
+import json
+import logging
+from datetime import datetime
+from typing import Any
+from zoneinfo import ZoneInfo
+
+from pydantic import BaseModel
+from pydantic_ai.exceptions import ModelHTTPError
+from starlette.requests import Request
+from starlette.responses import JSONResponse
+
+from app.agent.runtime.model_errors import model_http_error_details
+from app.utils.control_auth import ControlAuth
+from app.views.auth import (
+    authenticate_scheduled_run,
+    authenticate_user,
+    reject_scheduled_on_cas_endpoint,
+    scheduled_token,
+    strict_scheduled_body,
+)
+from app.views.errors import RouteError
+from app.views.run_context import build_run_deps, build_state_client
+
+logger = logging.getLogger(__name__)
+
+
+async def sync_run(request: Request):
+    runtime = request.app.state.runtime
+    reject_scheduled_on_cas_endpoint(request)
+    user = await authenticate_user(request, runtime)
+    try:
+        payload = await request.json()
+        question = str(payload["question"]).strip()
+        input_data = payload["input"]
+    except (KeyError, TypeError, ValueError, json.JSONDecodeError):
+        return JSONResponse({"error": "invalid sync request"}, status_code=422)
+    if not question or not isinstance(input_data, dict):
+        return JSONResponse({"error": "invalid sync request"}, status_code=422)
+    return await _sync_response(
+        runtime,
+        user,
+        question,
+        input_data,
+        effective_context=_effective_time_context(request),
+    )
+
+
+async def scheduled_run(request: Request):
+    runtime = request.app.state.runtime
+    token = scheduled_token(request)
+    await strict_scheduled_body(request)
+    identity = await authenticate_scheduled_run(runtime, token)
+    input_data = {
+        "scheduledTaskId": identity.task_id,
+        "scheduledRunId": identity.run_id,
+        "scheduledAt": identity.scheduled_at.isoformat().replace("+00:00", "Z"),
+        "timezone": identity.timezone,
+    }
+    return await _sync_response(
+        runtime,
+        {
+            "authentication_type": "SCHEDULED",
+            "user_id": identity.user_id,
+            "org_code": identity.org_code,
+            "scheduled_run_id": identity.run_id,
+            "control_auth": ControlAuth.scheduled(token),
+        },
+        identity.prompt,
+        input_data,
+        effective_context=(input_data["scheduledAt"], identity.timezone),
+    )
+
+
+async def _sync_response(
+    runtime,
+    user: dict[str, Any],
+    question: str,
+    input_data: dict[str, Any],
+    *,
+    effective_context: tuple[str, str] | None = None,
+) -> JSONResponse:
+    try:
+        content = await _run_sync(
+            runtime,
+            user,
+            question,
+            input_data,
+            effective_context=effective_context,
+        )
+    except ModelHTTPError as exc:
+        status, code, message, model_name = model_http_error_details(exc)
+        logger.error(
+            "Sync model request failed status=%s model=%s code=%s message=%s",
+            status,
+            model_name,
+            code,
+            message,
+        )
+        return JSONResponse(
+            {"error": message, "code": code, "model": model_name},
+            status_code=status,
+        )
+    return JSONResponse({"content": content})
+
+
+async def _run_sync(
+    runtime,
+    user: dict[str, Any],
+    question: str,
+    input_data: Any,
+    *,
+    effective_context: tuple[str, str] | None = None,
+):
+    state_client = build_state_client(runtime, user)
+    deps = build_run_deps(runtime, user, state_client)
+    if effective_context is not None:
+        deps.effective_at, deps.effective_timezone = effective_context
+    prompt = f"{question}\n\n输入数据：{json.dumps(input_data, ensure_ascii=False)}"
+    decision = await runtime.graph.router.run(
+        prompt,
+        deps=deps,
+        usage_limits=runtime.graph.usage_limits,
+    )
+    agent = runtime.graph.resolve_root(decision.output)
+    result = await agent.run(
+        prompt,
+        deps=deps,
+        usage_limits=runtime.graph.usage_limits,
+    )
+    output = result.output
+    return output.model_dump(by_alias=True) if isinstance(output, BaseModel) else output
+
+
+def _effective_time_context(request: Request) -> tuple[str, str] | None:
+    effective_at = request.headers.get("x-agent-effective-at")
+    timezone = request.headers.get("x-agent-effective-timezone")
+    if effective_at is None and timezone is None:
+        return None
+    if not effective_at or not timezone:
+        raise RouteError(422, "invalid effective time context")
+    try:
+        parsed = datetime.fromisoformat(effective_at.replace("Z", "+00:00"))
+        if parsed.tzinfo is None:
+            raise ValueError
+        ZoneInfo(timezone)
+    except (KeyError, ValueError):
+        raise RouteError(422, "invalid effective time context")
+    return effective_at, timezone

package/deploy/autoconf/templates/env.j2

@@ -0,0 +1,23 @@
+APP_ENV={{APP_ENV}}
+CONSOLE_STDOUT={{CONSOLE_STDOUT}}
+LOG_LEVEL={{LOG_LEVEL}}
+LOG_DIR={{LOG_DIR}}
+# 联合运维服务
+UNION_BASE_URL={{UNION_BASE_URL}}
+PERMISSIONS={{PERMISSIONS}}
+
+# 大模型地址
+LLM_URL={{LLM_URL}}
+LLM_KEY={{LLM_KEY}}
+LLM_MODEL={{LLM_MODEL}}
+LLM_CONTEXT_WINDOW={{LLM_CONTEXT_WINDOW}}
+AGENT_MAX_RUN_SECONDS={{AGENT_MAX_RUN_SECONDS | default('900')}}
+SUBAGENT_TIMEOUT_SECONDS={{SUBAGENT_TIMEOUT_SECONDS | default('900')}}
+
+# 向量模型地址（OpenAI-compatible embeddings API）
+RAG_ENABLED=true
+RAG_KNOWLEDGE_DIR=knowledge
+RAG_COLLECTION=ops_knowledge
+RAG_EMBEDDING_MODEL={{RAG_EMBEDDING_MODEL}}
+RAG_TOP_K=5
+RAG_CHUNK_SIZE=1200

package/deploy/autoconf.yml

@@ -0,0 +1,15 @@
+union-py-app:
+  test:
+    test:
+      - template: deploy/autoconf/templates/env.j2
+        dest: app/config/env/.env.test.bj12
+  prod:
+    bj11:
+      - template: deploy/autoconf/templates/env.j2
+        dest: app/config/env/.env.prod.bj11
+    sh20:
+      - template: deploy/autoconf/templates/env.j2
+        dest: app/config/env/.env.prod.sh20
+    sz31:
+      - template: deploy/autoconf/templates/env.j2
+        dest: app/config/env/.env.prod.sz31

package/deploy/scripts/healthcheck.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+set -u
+
+TIMEOUT_SECONDS="${HEALTHCHECK_TIMEOUT_SECONDS:-5}"
+
+probe_http() {
+  local url="$1"
+  curl --fail --silent --show-error --max-time "$TIMEOUT_SECONDS" "$url" >/dev/null
+}
+
+probe_http "${APP_HEALTHCHECK_URL:-http://127.0.0.1:${APP_PORT:-8080}/healthcheck.html}" || exit 1

package/deploy/scripts/start.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# 脚本：启动 ASGI 应用
+# 功能：
+# 1.删除旧的union-py虚拟环境
+# 2.创建新venv环境并安装依赖
+# 3.启动ASGI服务
+ASGI_APP="app.asgi:app"
+PYTHON="python"
+LOG_ACCESS_FILE="/data/dataLogs/hypercorn_$(date '+%Y-%m-%d_%H_%M_%S').log"
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+VENV_DIR="$ROOT_DIR/union_py"
+REQUIREMENTS="$ROOT_DIR/requirements.txt"
+OFFLINK_PKGS="$ROOT_DIR/deploy/offline-packages"
+PID_FILE="$ROOT_DIR/deploy/scripts/pid"
+STARTUP_TIMEOUT_SECONDS="${APP_STARTUP_TIMEOUT_SECONDS:-300}"
+export PYTHONUNBUFFERED=1
+export APP_ENV="${APP_ENV:-dev}"
+mkdir -p "$(dirname "$LOG_ACCESS_FILE")"
+echo "切换到项目目录$ROOT_DIR 并设置APP_ENV环境变量：$APP_ENV" >> "$LOG_ACCESS_FILE"
+BIND_HOST="127.0.0.1"
+if [[ "$APP_ENV" == *test* ]]; then
+  BIND_HOST="0.0.0.0"
+fi
+echo "开始启动,当前目录：$(pwd)...."  >> "$LOG_ACCESS_FILE"
+if [ -d "$VENV_DIR" ]; then
+  echo "删除现有环境：$VENV_DIR"  >> "$LOG_ACCESS_FILE"
+  rm -rf "$VENV_DIR"
+else
+  echo "虚拟环境$VENV_DIR 不存在，跳过删除"  >> "$LOG_ACCESS_FILE"
+fi
+echo "开始创建虚拟环境$VENV_DIR "  >> "$LOG_ACCESS_FILE"
+$PYTHON -m venv "$VENV_DIR"
+if [ $? -ne 0 ]; then
+  echo "创建虚拟环境$VENV_DIR 失败，请检查python3 和venv命令是否可用"  >> "$LOG_ACCESS_FILE"
+  exit 1
+fi
+source "$VENV_DIR/bin/activate"
+echo "虚拟环境$VENV_DIR 创建成功.并已激活虚拟环境$VENV_DIR"  >> "$LOG_ACCESS_FILE"
+
+echo "安装依赖 from $REQUIREMENTS 文件"  >> "$LOG_ACCESS_FILE"
+if [ ! -f "$REQUIREMENTS" ]; then
+  echo "$REQUIREMENTS 文件不存在，退出"  >> "$LOG_ACCESS_FILE"
+  exit 1
+fi
+pip install \
+   --no-index \
+   --find-links "$OFFLINK_PKGS" \
+   --no-cache-dir \
+   -r "$REQUIREMENTS" || { echo "依赖安装失败，请检查离线包是否完整"  >> "$LOG_ACCESS_FILE"; exit 1 ;}
+
+echo "安装依赖完成。启动ASGI应用:$ASGI_APP"  >> "$LOG_ACCESS_FILE"
+cd "$ROOT_DIR"
+hypercorn \
+    --workers 1 \
+    --bind "$BIND_HOST":8080 \
+    --keep-alive 2 \
+    --pid "$PID_FILE" \
+    "$ASGI_APP" \
+    >> "$LOG_ACCESS_FILE" 2>&1 &
+echo $! >> "$LOG_ACCESS_FILE"
+
+for i in $(seq 1 "$STARTUP_TIMEOUT_SECONDS");do
+	if [ -f "$PID_FILE" ] ;then
+	  PID=$(cat "$PID_FILE" 2>/dev/null)
+		if [ -n "$PID" ] && kill -0 "$PID" 2>/dev/null ; then
+			if HEALTHCHECK_TIMEOUT_SECONDS=1 bash "$ROOT_DIR/deploy/scripts/healthcheck.sh"; then
+				echo "hypercorn 已就绪（PID：$PID）"
+				exit 0
+			fi
+		else
+			break
+		fi
+	fi
+  sleep 1
+done
+
+echo "hypercorn 未在 ${STARTUP_TIMEOUT_SECONDS}s 内就绪" >> "$LOG_ACCESS_FILE"
+bash "$ROOT_DIR/deploy/scripts/stop.sh"
+exit 1

package/deploy/scripts/stop.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+PID_FILE="$ROOT_DIR/deploy/scripts/pid"
+
+quiet_stop(){
+  local pid_file="$1"
+  local name="$2"
+  if [ ! -f "$pid_file" ];then
+    return 0
+  fi
+  PID=$(cat "$pid_file" 2>/dev/null)
+  if [ -z "$PID" ];then
+    rm -f "$pid_file"
+    return 0
+  fi
+  if kill -0 "$PID" 2>/dev/null; then
+    echo "正在停止 $name(PID:$PID)..."
+    kill "$PID" >/dev/null 2>&1
+    for i in {1..5}; do
+      if ! kill -0 "$PID" 2>/dev/null; then
+        echo "$name(PID:$PID) 已停止"
+        rm -f "$pid_file"
+        return 0
+      fi
+      sleep 1
+    done
+    echo "兜底，强制停止"
+    kill -9 "$PID" 2>/dev/null
+  fi
+  rm -f "$pid_file"
+}
+
+quiet_stop "$PID_FILE" "hypercorn"

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

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "union-app-chat-stream",
+  "version": "1.1.6",
+  "description": "Union operations PydanticAI ASGI service package.",
+  "license": "UNLICENSED",
+  "files": [
+    "app",
+    "!app/config/env/.env",
+    "!app/config/env/.env.*",
+    "!app/**/__pycache__",
+    "!app/**/*.pyc",
+    "deploy",
+    "!deploy/**/__pycache__",
+    "!deploy/**/*.pyc",
+    "!deploy/offline-packages",
+    "!deploy/offline-packages/**",
+    "scripts",
+    "knowledge",
+    "requirements.txt"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,10 @@
+pydantic-ai-slim[ag-ui,logfire,openai,zai]==2.18.0
+pydantic-ai-harness[skills]==0.12.0
+openai==2.45.0
+ag-ui-protocol==0.1.19
+python-dotenv==1.2.3
+httpx==0.28.1
+Hypercorn==0.17.3
+chromadb==1.5.9
+numpy==2.2.6
+pyyaml==6.0.3

package/scripts/healthcheck.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec bash "$ROOT_DIR/deploy/scripts/healthcheck.sh" "$@"

package/scripts/start-BJ11.sh

@@ -0,0 +1 @@
+prod.bj11

package/scripts/start-BJ12.sh

@@ -0,0 +1 @@
+test.bj12

package/scripts/start-SH20.sh

@@ -0,0 +1 @@
+prod.sh20

package/scripts/start-SZ31.sh

@@ -0,0 +1 @@
+prod.sz31

package/scripts/stop.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec bash "$ROOT_DIR/deploy/scripts/stop.sh" "$@"