Skip to main content
POST
/
v1
/
agent
/
conversations
/
{conversation_id}
/
messages
/
{assistant_message_id}
/
cancel
Cancel Agent Execution
curl --request POST \
  --url https://api.reportify.cn/v1/agent/conversations/{conversation_id}/messages/{assistant_message_id}/cancel \
  --header 'Authorization: Bearer <token>'
{
  "response_id": "019b24ef238cc97730971a9a0080c99c",
  "status": "cancelled"
}

​
取消智能体执行

URL: /v1/agent/conversations/{conversation_id}/messages/{assistant_message_id}/cancel
方法: POST
描述: 取消正在执行的智能体任务。

​
使用场景

  • 中止长时间运行的任务：当智能体执行时间过长时，可以主动取消
  • 用户取消操作：用户不再需要当前任务的结果

​
路径参数

参数名类型必填描述
conversation_idinteger是对话 ID
assistant_message_idstring是助手消息 ID（从 chat 接口响应头 X-REPORTIFY-ASSISTANT-MESSAGE-ID 获取）

​
响应参数

参数名类型描述
response_idstring响应 ID
statusstring取消状态

​
示例代码

​
cURL 示例

curl -X POST "https://api.example.com/v1/agent/conversations/683242877840089/messages/019b24ef238cc97730971a9a0080c99c/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Python 示例

import requests

url = "https://api.example.com/v1/agent/conversations/683242877840089/messages/019b24ef238cc97730971a9a0080c99c/cancel"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers)
data = response.json()

print(f"响应 ID: {data['response_id']}")
print(f"取消状态: {data['status']}")

​
Python 示例（完整流程）

import requests
import time

# 1. 发起对话
chat_url = "https://api.example.com/v1/agent/conversations/683242877840089/chat"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
chat_data = {
    "message": "生成一份详细的市场分析报告",
    "stream": True
}

response = requests.post(chat_url, headers=headers, json=chat_data, stream=True)
assistant_message_id = response.headers.get('X-REPORTIFY-ASSISTANT-MESSAGE-ID')

# 2. 等待一段时间后决定取消
time.sleep(5)

# 3. 取消执行
cancel_url = f"https://api.example.com/v1/agent/conversations/683242877840089/messages/{assistant_message_id}/cancel"
cancel_response = requests.post(cancel_url, headers=headers)
print(cancel_response.json())

​
响应示例

{
  "response_id": "019b24ef238cc97730971a9a0080c99c",
  "status": "cancelled"
}

​
注意事项

  • 只能取消正在执行中的任务，已完成或已失败的任务无法取消
  • 取消操作是异步的，可能需要几秒钟才能完全停止执行
  • 取消后，可以通过获取消息事件接口查看取消前已生成的事件
  • assistant_message_id 可从对话聊天接口（stream=true）的 HTTP 响应头 X-REPORTIFY-ASSISTANT-MESSAGE-ID 中获取

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
conversation_id
integer
required

对话 ID

​
assistant_message_id
string
required

助手消息 ID（从 chat 接口响应头 X-REPORTIFY-ASSISTANT-MESSAGE-ID 获取）

Response

Successful Response

取消 agent 执行响应

​
response_id
string
required

响应 ID

Example:

"019b24ef238cc97730971a9a0080c99c"

​
status
string
required

取消状态

Example:

"cancelled"