agent.py 1.7 KB

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