Updated on 2025-08-13 GMT+08:00

Querying the Feedback List

Function

Query user feedbacks, including the user ID, question, feedback content, and correction.

URI

GET /v1/{project_id}/applications/{application_id}/uni-search/feedback-manage

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition:

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Constraints:

N/A

Value range:

The value can contain 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter.

Default value:

N/A

application_id

Yes

String

Definition:

Application ID. For details about how to obtain the application ID, see Obtaining an Application ID.

Constraints:

Character string

Value range:

The value can contain 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

page_num

No

Integer

Definition:

Page number of the current request, indicating the start page from data retrieval. The default value is 1, indicating to start from the first page.

Constraints:

N/A

Value range:

1-65535

Default value:

1

page_size

No

Integer

Definition:

Number of records displayed on each page, indicating the number of records returned per request. The default value is 10, indicating that 10 records are displayed on each page.

Constraints:

N/A

Value range:

1-65535

Default value:

10

user_name

No

String

Definition:

Username.

Constraints:

N/A

Value range:

A maximum of 128 characters are allowed.

Default value:

N/A

feedback_type

No

String

Definition:

Feedback type.

Constraints:

N/A

Value range:

  • like

  • unlike

Default value:

N/A

feedback_sencond_type

No

String

Definition:

Level-2 feedback type. Use commas (,) to separate multiple types.

Constraints:

N/A

Value range:

The value can contain a maximum of 1024 characters. It can only contain letters, underscores (_), commas (,), and spaces.

Default value:

N/A

repo_id

No

String

Definition:

Knowledge base ID.

Constraints:

N/A

Value range:

The value can contain 1 to 64 characters. It can only contain letters, digits, underscores (_), and hyphens (-).

Default value:

N/A

feedback_status

No

String

Definition:

Feedback status.

Constraints:

N/A

Value range:

  • 0: Not corrected

  • 1: Corrected

  • 2: Not an issue

Default value:

N/A

tag

No

String

Definition:

Tag information, which consists of key and value connected by colons (:), for example, key1:value1.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

name

No

String

Definition:

Feedback name.

Constraints:

N/A

Value range:

The value contains a maximum of 64 characters.

Default value:

N/A

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition:

Token used for API authentication. For details about how to obtain the token, see Obtaining an IAM User Token.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

feeback_list

Array of FeedbackInfo objects

Definition:

Feedback list.

Value range:

N/A

total

Integer

Definition:

Total number.

Value range:

N/A

Table 5 FeedbackInfo

Parameter

Type

Description

feedback_id

String

Definition:

Feedback ID.

Value range:

N/A

repo_id

String

Definition:

Knowledge base ID.

Value range:

N/A

repo_name

String

Definition:

Knowledge base name.

Value range:

N/A

question_id

String

Definition:

Q&A ID.

Value range:

N/A

chart_id

String

Definition:

Session ID.

Value range:

N/A

question

String

Definition:

Question.

Value range:

N/A

answer

String

Definition:

Answer.

Value range:

N/A

expect_answer

String

Definition:

Expected answer.

Value range:

N/A

feedback_detail

String

Definition:

Feedback details.

Value range:

N/A

user_name

String

Definition:

Username.

Value range:

N/A

feedback_type

String

Definition:

Feedback type.

Value range:

  • like

  • unlike

feedback_second_type

String

Definition:

Level-2 feedback type.

Value range:

N/A

feedback_date_time

String

Definition:

Feedback time.

Value range:

N/A

feedback_status

Integer

Definition:

Feedback type.

Value range:

  • 0: Not corrected

  • 1: Corrected

context_relation

String

Definition:

Context association type.

Value range:

N/A

revised_answer

String

Definition:

Revise questions.

Value range:

N/A

revised_reason

String

Definition:

Revise reasons.

Value range:

N/A

standard_answer

String

Definition:

Standard answer.

Value range:

N/A

project_id

String

Definition:

Project ID.

Value range:

N/A

question_model

QuestionModel object

Definition:

Model.

Value range:

N/A

question_reference_models

Array of QuestionReferenceModel objects

Definition:

Reference model.

Value range:

N/A

Table 6 QuestionModel

Parameter

Type

Description

question_id

String

Definition:

Question ID.

Value range:

N/A

chat_id

String

Definition:

Session ID.

Value range:

N/A

question

String

Definition:

Question.

Value range:

N/A

rewrited_question

String

Definition:

Rewritten question.

Value range:

N/A

answer

String

Definition:

Answer.

Value range:

N/A

pangu_answer

String

Definition:

Pangu answer.

Value range:

N/A

user_name

String

Definition:

Username.

Value range:

N/A

create_date_time

String

Definition:

Chat occurrent time.

Value range:

N/A

feedback_status

Integer

Definition:

Whether there is any feedback

Value range:

N/A

feedback_type

String

Definition:

Feedback type.

Value range:

N/A

pangu_question

String

Definition:

Pangu question.

Value range:

N/A

feedback_date_time

String

Definition:

Feedback time.

Value range:

N/A

feedback_detail

String

Definition:

Feedback details.

Value range:

N/A

context_relation

String

Definition:

Associated context.

Value range:

N/A

revised_answer

String

Definition:

Optimization result.

Value range:

N/A

revised_reason

String

Definition:

Optimized question.

Value range:

N/A

standard_answer

String

Definition:

Standard answer.

Value range:

N/A

project_id

String

Definition:

Project ID.

Value range:

N/A

search_plan

String

Definition:

Search planning content.

Value range:

N/A

web_reference

String

Definition:

Web reference.

Value range:

N/A

question_reference_models

Array of QuestionReferenceModel objects

Definition:

Reference file and segment details of the current answer.

Value range:

N/A

Table 7 QuestionReferenceModel

Parameter

Type

Description

id

Integer

Definition:

Reference chunk ID.

Value range:

N/A

file_id

String

Definition:

File ID.

Value range:

N/A

reference_id

String

Definition:

Reference file ID.

Value range:

N/A

question_id

String

Definition:

Question ID.

Value range:

N/A

doc_index

String

Definition:

Reference document index.

Value range:

N/A

doc_title

String

Definition:

Reference document name.

Value range:

N/A

subtitle

String

Definition:

Subheading of the reference segment.

Value range:

N/A

doc_content

String

Definition:

Reference segment content.

Value range:

N/A

score

Float

Definition:

Relevance score between the reference segment and the question.

Value range:

N/A

type

String

Definition:

Type.

Value range:

N/A

page_num

Integer

Definition:

Page number.

Value range:

N/A

component_num

Integer

Definition:

Number of components.

Value range:

N/A

extend

String

Definition:

JSON data used for document highlighting and locating. Example:

{

"element_id": "abc123",

"elements": [

"elem1",

"elem2",

"elem3"

],

"pdf_coordinate": [

[

202,

687

],

[

1031,

687

]

]

}

Constraints:

This parameter is supported only in clusters 25.7.T1 or later.

Value range:

N/A

Example Requests

Query the feedback list.

/v1/123123/applications/123123/uni-search/knowledge-repo?page_num=1&page_size=10&name= Knowledge &status=

Example Responses

Status code: 200

Feedback query result.

{
  "feeback_list" : [ {
    "question_id" : "12353",
    "question" : "How's the weather today?",
    "answer" : "The weather is good.",
    "feedback_detail" : "",
    "user_name" : "",
    "feedback_type" : "like",
    "feedback_date_time" : "123345675552",
    "feedback_status" : 0,
    "context_relation" : "",
    "revised_answer" : "",
    "revised_reason" : "",
    "standard_answer" : ""
  } ],
  "total" : 12
}

Status Codes

Status Code

Description

200

Feedback query result.

Error Codes

See Error Codes.