| 12345678910111213141516171819202122232425262728293031323334 |
- # 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="事件详情数据")
|