SuperAPI AI 工具集

understanding-architecture

设计与创作

查看项目

更新于 10-16 00:30

技能介绍

用途:该技能用于理解 foundry-agent-webapp 的系统设计、调试状态转换、追踪 SSE 事件,以及更新架构文档。

主要能力:给出系统分层速查(前端 React 19 + Vite,端口 5173,入口 frontend/src/App.tsx;后端 ASP.NET Core 9,端口 8080,入口 backend/WebApp.Api/Program.cs;认证 MSAL.js → JWT Bearer;AI SDK 为 Azure.AI.Projects (GA) + Azure.AI.Extensions.OpenAI)。梳理数据流:用户 → ChatInput → CHAT_SEND_MESSAGE → ChatService.sendMessage() → POST /api/chat/stream (JWT) → AgentFrameworkService.StreamMessageAsync() → AI Foundry → SSE chunks → parseSseLine() → Reducer actions → UI 更新。

状态机:聊天状态含 idle、sending、streaming、error,并说明各状态下输入是否可用及 streamingMessageId 取值;认证状态含 initializing、authenticated、unauthenticated。

SSE 事件流:列出 conversationId、chunk、annotations、mcpApprovalRequest、usage、done、error 与后端 Write*Event 方法及前端 Reducer 动作的映射,并给出事件顺序(conversationId 始终第一,done 始终最后)。

使用方式:按领域查阅关键文件,包括状态管理(appState.ts、appReducer.ts、AppContext.tsx)、SSE 流(Program.cs、chatService.ts、sseParser.ts)、AI 集成(AgentFrameworkService.cs、StreamChunk.cs、ChatRequest.cs)。完整图示见 ARCHITECTURE-FLOW.md。文档维护时可依据变更类型更新对应章节,并用校验清单核对 Mermaid 图、表格、代码片段与文件链接。同步命令如 Select-String -Path "backend/WebApp.Api/Program.cs" -Pattern "type.*=" 保持原样。

限制:资料未提供收费、价格、平台支持范围等细节,相关内容暂未提供。