openapi: 3.0.1
info:
  title: ''
  version: 1.0.0
paths:
  /agent/chat:
    post:
      summary: AI Agent&聊天
      deprecated: false
      description: >-
        本接口既支持带着消息新建对话，也支持通过旧对话继续聊天。
        在 JSON 中传入 conversation_id，后端查库：存在则延续，不存在则创建新对话后再聊天。

        流式响应采用 OpenAI/DeepSeek 兼容格式：
        - 思考流：choices[0].delta.reasoning_content
        - 正文流：choices[0].delta.content
        - 结束标记：data: [DONE]
      tags:
        - Agent模块
      parameters:
        - name: Authorization
          in: header
          description: token
          required: false
          example: ''
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: false
          example:
            - application/json
          schema:
            type: array
            items:
              type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                conversation_id:
                  type: string
                  description: 可选。不传时后端自动生成，并通过 X-Conversation-ID 响应头返回。
                  x-apifox-mock: '{{$string.uuid}}'
                message:
                  type: string
                  description: 用户输入内容
                model:
                  type: string
                  description: 可选，worker 或 strategist（默认 worker）
                thinking:
                  type: boolean
                  description: 是否开启深度思考
              required:
                - message
                - thinking
              x-apifox-orders:
                - conversation_id
                - message
                - model
                - thinking
            example:
              conversation_id: 0b6eac35-ccaa-46d1-aa58-d33bc2cd48aa
              message: 提醒我有空的时候给自己挑一件新衣服
              model: worker
              thinking: true
      responses:
        '200':
          description: ''
          content:
            text/event-stream:
              schema:
                type: string
                description: >-
                  每条 SSE 事件都是 `data: {JSON}`，最终以 `data: [DONE]` 结束。
                  Apifox 可按 OpenAI 兼容格式自动合并，并区分 reasoning_content 与 content。
              example: |-
                data: {"id":"chatcmpl-3f3ee5d6-8c4f-4b5b-a2a8-7f5b9bde8b9d","object":"chat.completion.chunk","created":1740637581,"model":"worker","choices":[{"index":0,"delta":{"role":"assistant","reasoning_content":"先分析一下你的需求。"},"finish_reason":null}]}

                data: {"id":"chatcmpl-3f3ee5d6-8c4f-4b5b-a2a8-7f5b9bde8b9d","object":"chat.completion.chunk","created":1740637581,"model":"worker","choices":[{"index":0,"delta":{"reasoning_content":"你提到的是空闲时提醒。"},"finish_reason":null}]}

                data: {"id":"chatcmpl-3f3ee5d6-8c4f-4b5b-a2a8-7f5b9bde8b9d","object":"chat.completion.chunk","created":1740637581,"model":"worker","choices":[{"index":0,"delta":{"content":"可以，我会在你有空时提醒你。"},"finish_reason":null}]}

                data: {"id":"chatcmpl-3f3ee5d6-8c4f-4b5b-a2a8-7f5b9bde8b9d","object":"chat.completion.chunk","created":1740637581,"model":"worker","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

                data: [DONE]
          headers:
            X-Conversation-ID:
              example: 0b6eac35-ccaa-46d1-aa58-d33bc2cd48aa
              required: false
              description: 生效的会话 ID，用于后续续聊
              schema:
                type: string
          x-apifox-name: 成功
          x-apifox-ordering: 0
      security: []
      x-apifox-folder: Agent模块
      x-apifox-status: developing
components:
  schemas: {}
  responses: {}
  securitySchemes: {}
servers:
  - url: http://127.0.0.1:8080/api/v1
    description: 开发环境
security: []