Get recommended questions

POST 
/v1/aibot/bots/:botId/recommend-questions

Get recommended questions

Request

Path Parameters

botId stringrequired
Agent ID
Example: bot-xxx

application/json

Body

required

name string

Agent name

introduction string

Agent introduction

agentSetting string

Agent persona

msg string

User message content

history object[]
Conversation history
Array [
role stringrequired
Role in the conversation history
content stringrequired
Content of the conversation history
]

Responses

200

Returned when recommended questions are retrieved successfully (SSE format)

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

created number

Conversation timestamp

record_id string

Conversation record ID

model string

Large model type

version string

Large model version

type string

Response type: text for the main answer, thinking for reasoning process, search for search results, knowledge for knowledge base

role string

Conversation role, fixed as assistant in responses

content string

Conversation content

finish_reason string

Conversation termination flag; continue means not finished, stop means finished

reasoning_content string

Deep reasoning content (only non-empty for deepseek-r1)

usage object

Token usage

promptTokens number

Number of prompt tokens; remains constant across multiple responses

completionTokens number

Total completion tokens. In streaming responses, this accumulates across chunks.

totalTokens number

Sum of promptTokens and completionTokens

knowledge_base string[]

Knowledge bases used in the conversation

search_info object
Search results (requires web search to be enabled)
search_results undefined[]
Search citation information
Array [
index string
Citation index
title string
Citation title
url string
Citation URL
]

Example (from schema)

{
  "created": "1726030224",
  "record_id": "record-427d3652",
  "model": "hunyuan",
  "version": "202407241700",
  "type": "assistant",
  "role": "assistant",
  "content": "Hello",
  "finish_reason": "continue",
  "reasoning_content": "",
  "usage": {
    "promptTokens": 10,
    "completionTokens": 20,
    "totalTokens": 30
  },
  "knowledge_base": [
    ""
  ],
  "search_info": {
    "search_results": [
      {
        "index": "[1]",
        "title": "Title",
        "url": "Link"
      }
    ]
  }
}

default

Returned when fetching recommended questions fails

application/json

Schema

Schema

code string

Error code

message string

Error message

requestId string

Request ID

Example (from schema)

{
  "code": "INVALID_CREDENTIALS",
  "message": "Credentials are invalid",
  "requestId": "6360ba4b-f672-434b-9dee-35686a5589a4"
}

Loading...