Files
Agent-Workbench/src/client/ModelRequestLedger.tsx
T

88 lines
12 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { useEffect, useState } from 'react';
import { api, downloadArtifact, downloadBlob, downloadModelLedger } from './api';
import { ModelUsageDetails } from './ModelUsageDetails';
import { ModelRoutingDetails, type RoutingDecision } from './ModelRoutingDetails';
import { ModelIdentityDetails } from './ModelIdentityDetails';
import { ModelErrorDetails } from './ModelErrorDetails';
import { protocolLabel } from '../shared/contracts/model-endpoint.mjs';
import type { ModelIdentity } from '../shared/contracts/model-identity.mjs';
import type { TokenUsage } from '../shared/contracts/model-usage.mjs';
import type { RuntimeFailure } from './types';
import './ModelRequestLedger.css';
import { ModelRequestDetails } from './ModelRequestDetails';
import { ModelProviderStateDetails, type ProviderStateAuditView } from './ModelProviderStateDetails';
import type { PreparedRequestMetadata } from './types';
export type ModelAttempt = { routingDecision?: RoutingDecision; modelIdentity?: ModelIdentity; diagnostic?: RuntimeFailure; requestUrl?: string; requestMetadata?: PreparedRequestMetadata;
nativeStateAudit?: ProviderStateAuditView; affinityPersistence?: { status: string; reason?: string };
upstreamResponse?: { requestId?: string | null; responseUrl?: string | null; headers?: Record<string, string> }; id: string; connectionId?: string; model?: string; protocol?: string; streaming?: boolean;
rejections?: { connectionName: string; capability: string; reason: string }[]; status: string; startedAt: string; ordinal?: number; usageStatus: string; reason?: string;
taskId?: string; sessionId?: string; runId?: string; requestArtifactId?: string; responseArtifactId?: string; responseSha256?: string; responseRedacted?: boolean;
stream?: { bytes: number; capturedBytes?: number; frames: number; sha256: string; terminal: boolean }; usage?: TokenUsage | null };
type ReceiptReference = { sequence: number; payloadSha256: string; initialSha256: string; origin: string; legacyIndex?: number };
type LedgerPage = { items: ModelAttempt[]; references: ReceiptReference[]; total: number; retainedTotal: number; nextCursor: string | null; hasMore: boolean; snapshotSequence: number; connectionIds: string[] };
const states: Record<string, string> = { completed: '收到响应', failed: '请求失败', unknown: '结果未知', interrupted: '已中断', running: '请求中', rejected: '未派发' };
const address = (filters: Record<string, string>, cursor: string | null = null) => {
const params = new URLSearchParams({ ...filters, limit: '50', ...(cursor ? { cursor } : {}) }); return '/model-center/attempts?' + params.toString();
};
export function ModelRequestLedger({ connections, refreshVersion }: { connections: { id: string; name: string }[]; refreshVersion: unknown }) {
const [page, setPage] = useState<LedgerPage | null>(null), [cursor, setCursor] = useState<string | null>(null), [previous, setPrevious] = useState<(string | null)[]>([]);
const [filters, setFilters] = useState<Record<string, string>>({}), [query, setQuery] = useState(''), [status, setStatus] = useState(''), [connection, setConnection] = useState('');
const [historyConnections, setHistoryConnections] = useState<string[]>([]);
const [loading, setLoading] = useState(false), [working, setWorking] = useState(false), [error, setError] = useState(''), [revision, setRevision] = useState(0);
useEffect(() => {
let alive = true; setLoading(true); setError(''); setPage(null);
api<LedgerPage>(address(filters, cursor)).then(value => { if (alive) { setPage(value); setHistoryConnections(value.connectionIds); } }).catch(cause => { if (alive) setError(cause.message); }).finally(() => { if (alive) setLoading(false); });
return () => { alive = false; };
}, [filters, cursor, revision, refreshVersion]);
async function act(action: () => Promise<void>) { setWorking(true); setError(''); try { await action(); } catch (cause) { setError(cause instanceof Error ? cause.message : '记录未能读取,请刷新核对。'); } finally { setWorking(false); } }
const disabled = working || loading;
function reset() { setCursor(null); setPrevious([]); setRevision(value => value + 1); }
const ledgerConnections = [...connections, ...historyConnections.filter(id => !connections.some(value => value.id === id)).map(id => ({ id, name: id + '(历史连接)' }))];
function pager(location: string) { return page && <nav className="mc-ledger-pages" aria-label={'请求账本分页 · ' + location}><span>本页 {page.items.length} 条 · 当前范围 {page.total.toLocaleString('zh-CN')} 条</span>
<button className="button secondary" disabled={disabled || previous.length === 0} onClick={() => { setCursor(previous.at(-1) ?? null); setPrevious(value => value.slice(0, -1)); }}>上一页</button>
<button className="button secondary" disabled={disabled || !page.hasMore} onClick={() => { setPrevious(value => [...value, cursor]); setCursor(page.nextCursor); }}>下一页</button></nav>; }
return <section className="mc-ledger" aria-label="完整请求账本" aria-busy={loading || working}>
<div className="mc-section-title"><div><h3>请求账本</h3><p>完整保存历史请求;每页展示 50 条,可筛选和导出全部记录。未知用量保持未知。</p></div>
<span>{page ? page.retainedTotal.toLocaleString('zh-CN') + ' 条已保存' : loading ? '正在读取' : '尚未取得记录'}</span></div>
<form className="mc-ledger-filter" aria-label="筛选请求账本" onSubmit={event => { event.preventDefault(); setFilters({ ...(query ? { query } : {}), ...(status ? { status } : {}), ...(connection ? { connectionId: connection } : {}) }); reset(); }}>
<label>搜索原记录<input aria-label="搜索请求账本" value={query} onChange={event => setQuery(event.target.value)} placeholder="型号、请求 ID、Run 或错误原文" /></label>
<label>连接<select aria-label="筛选账本连接" value={connection} onChange={event => setConnection(event.target.value)}><option value="">全部连接</option>{ledgerConnections.map(value => <option key={value.id} value={value.id}>{value.name}</option>)}</select></label>
<label>结果<select aria-label="筛选账本结果" value={status} onChange={event => setStatus(event.target.value)}><option value="">全部结果</option>{Object.entries(states).map(([value, name]) => <option key={value} value={value}>{name}</option>)}</select></label>
<button className="button secondary" disabled={disabled}>筛选记录</button>
</form>
<div className="mc-ledger-actions"><button className="button secondary" disabled={disabled} onClick={reset}>刷新记录</button>
<button className="button secondary" disabled={disabled || !page} onClick={() => void act(() => downloadModelLedger(filters))}>导出当前范围全部记录</button>
{page && <span>{Object.keys(filters).length ? '本次筛选 ' : '当前范围 '}{page.total.toLocaleString('zh-CN')} 条 · 记录按序号分页,进行中的字段仍会更新</span>}</div>
{error && <p className="mc-card-warning" role="alert">{error}</p>}
{!loading && page?.items.length === 0 && <p className="mc-empty">当前范围没有请求记录。调整筛选不会发送模型请求。</p>}
{pager('列表上方')}
<div className="mc-attempts">{page?.items.map((value, index) => {
const source = page.references[index];
return <article key={source.sequence} data-ledger-sequence={source.sequence}>
<div><span className={'mc-state mc-state-' + value.status}>{states[value.status] ?? value.status}</span><strong>{value.model ?? '未派发'}</strong><time>{value.startedAt ? new Date(value.startedAt).toLocaleString() : '原记录未保存时间'}</time></div>
<p>{connections.find(connection => connection.id === value.connectionId)?.name || value.connectionId || '未派发'} · {value.protocol ? protocolLabel(value.protocol) : '原记录未保存协议'}{value.streaming ? ' · 流式' : ''} · {value.ordinal ? '尝试 ' + value.ordinal : '未发送'} · {value.usageStatus === 'reported' ? `${value.usage?.prompt_tokens ?? '?'} 输入 / ${value.usage?.completion_tokens ?? '?'} 输出 tokens` : value.usageStatus === 'not_dispatched' ? '未产生请求用量' : '用量未知'}</p>
<ModelUsageDetails usage={value.usage} /><code>Run {value.runId ?? '原记录未保存'}</code>
<details className="mc-ledger-source"><summary>记录来源与 SHA256</summary><p>序号 {source.sequence} · {source.origin === 'legacy-metadata' ? '原账本完整迁移,原 metadata 保留' : '本次尝试独立保存'}</p>
<dl><dt>本条记录</dt><dd><code>{source.payloadSha256}</code></dd><dt>初始记录</dt><dd><code>{source.initialSha256}</code></dd></dl>
<button className="button secondary" disabled={disabled} onClick={() => void act(async () => { const record = await api('/model-center/attempts/' + source.sequence); downloadBlob(new Blob([JSON.stringify(record, null, 2)], { type: 'application/json' }), 'orven-model-request-' + source.sequence + '.json'); })}>下载本条与初始记录</button>
</details>
{value.stream && <div className="mc-stream-receipt"><p>{value.stream.terminal ? '响应完整终结' : '响应未完整,片段保留待核对'} · 已接收 {value.stream.bytes.toLocaleString()} bytes · {value.stream.frames} 个事件{value.stream.capturedBytes !== undefined && value.stream.capturedBytes < value.stream.bytes ? ' · 仅保存上限内片段' : ''}</p><code>原流 SHA256 {value.stream.sha256}</code></div>}
{value.responseSha256 && <code>工件 SHA256 {value.responseSha256}{value.responseRedacted ? '(已脱敏)' : ''}</code>}
{value.sessionId && value.responseArtifactId && <button className="button secondary" disabled={disabled} onClick={() => void act(() => downloadArtifact(value.sessionId!, value.responseArtifactId!, 'model-response-' + value.id + (value.streaming ? '.sse' : '.json')))}>下载已保存的响应</button>}
{value.requestUrl && <p className="mc-request-url">请求地址:{value.requestUrl}{value.upstreamResponse?.responseUrl && <><br />响应地址:{value.upstreamResponse.responseUrl}</>}</p>}
{value.requestMetadata && <ModelRequestDetails request={value.requestMetadata} responseHeaders={value.upstreamResponse?.headers} />}
{value.reason && <p className="mc-card-warning">{value.reason}</p>}
<ModelRoutingDetails decision={value.routingDecision} /><ModelIdentityDetails identity={value.modelIdentity} requestedModel={value.model ?? '原记录未保存'} />
<ModelProviderStateDetails audit={value.nativeStateAudit} />
{value.affinityPersistence && ['unknown', 'retained-unknown'].includes(value.affinityPersistence.status) && <p className="mc-card-warning">连接保持记录{value.affinityPersistence.status === 'unknown' ? '保存结果未知' : '暂不能解释,原件保留'};本次模型响应仍按原结果处理。{value.affinityPersistence.reason}</p>}
{value.diagnostic && <ModelErrorDetails failure={value.diagnostic} />}{!value.diagnostic && value.upstreamResponse?.requestId && <p className="mc-help">上游请求 ID:{value.upstreamResponse.requestId}</p>}
{value.requestArtifactId && value.sessionId && <button className="button secondary" disabled={disabled} onClick={() => void act(() => downloadArtifact(value.sessionId!, value.requestArtifactId!, 'model-request-' + value.id + '.json'))}>下载实际请求</button>}
{!!value.rejections?.length && <p className="mc-route-rejections">{value.rejections.map(item => item.connectionName + ':' + item.capability + ' · ' + item.reason).join(';')}</p>}
</article>;
})}</div>
{pager('列表下方')}
</section>;
}