# app/schemas/agent.py from typing import Optional, List, Dict, Any from pydantic import BaseModel, Field class AgentChatRequest(BaseModel): """Agent 对话请求入参""" message: str = Field(..., description="用户输入的指令或问题", min_length=1) session_id: Optional[str] = Field(None, description="会话ID,若不传则自动生成并开启新会话") stream: bool = Field(False, description="是否启用 SSE 流式输出") max_steps: int = Field(8, description="单次交互最大工具调用步数限制,防死循环", ge=1, le=20) model: Optional[str] = Field(None, description="指定使用的 LLM 模型名称,不传则使用默认配置") class AgentToolCallStep(BaseModel): """单个工具调用的执行记录""" tool: str = Field(..., description="调用的工具名称") arguments: Dict[str, Any] = Field(default_factory=dict, description="传给工具的入参") result: Any = Field(None, description="工具执行结果") is_error: bool = Field(False, description="工具执行是否报错") class AgentChatResponse(BaseModel): """Agent 同步对话响应体""" session_id: str = Field(..., description="会话ID") answer: str = Field(..., description="Agent 最终返回给用户的回答") steps: List[AgentToolCallStep] = Field(default_factory=list, description="执行的工具调用轨迹") steps_count: int = Field(0, description="执行的工具步骤数") class AgentStreamEvent(BaseModel): """SSE 流式事件载荷""" event: str = Field(..., description="事件类型:think | tool_start | tool_end | message | finish | error") data: Dict[str, Any] = Field(default_factory=dict, description="事件详情数据")