Version: 0.6.8.dev.260317
- 🧹 删除 `docs/apifox` 目录,接口契约统一迁移并维护于 Apifox 云端 - ✨ 新增“取消任务完成状态”接口
This commit is contained in:
@@ -1,110 +0,0 @@
|
||||
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: []
|
||||
Reference in New Issue
Block a user