# 2.8-Robot Conversation Knowledge Auto Reference

## 1. Overview

* **Interface Name**: Chat and Dialog Knowledge Reference Interface
* **Version number**: v1.0.0

## 2. Information

* **Request method**: POST
* **Request URL**: https\://*DOMAIN*/openapi/v1/conversation/knowledge/
* **Domain**: *Refer to "Service address description"*

## 3. Request parameters

Request header http header field:

| Parameter name        | Type   | Required | Description             |
| --------------------- | ------ | -------- | ----------------------- |
| Content-Type          | string | Yes      | Fixed`application/json` |
| cybertron-robot-key   | string | Yes      | Robot key               |
| cybertron-robot-token | string | Yes      | Robot token             |

Request body field:

| Parameter name | Type   | Required | Description                     |
| -------------- | ------ | -------- | ------------------------------- |
| username       | string | Yes      | User account                    |
| dialog\_id     | string | Yes      | dialog returned`dialog_id`Field |

## 4. Response field description

HTTP status code: 200 OK

Response field description:

| Field Name            | Type   | Description                          |
| --------------------- | ------ | ------------------------------------ |
| code                  | string | "000000" is normal, other exceptions |
| message               | string | Status description                   |
| data                  | array  | message body                         |
| knowledge\_base\_id   | int    | Knowledge Base id                    |
| knowledge\_base\_name | string | knowledge base name                  |

## 5. Example

Request Example:

```bash
curl 'https://_DOMAIN_/openapi/v1/conversation/knowledge/' \
-H 'Content-Type: application/json' \
-H 'cybertron-robot-key: l8ia2IOc************Z724%2BU%3D' \
-H 'cybertron-robot-token: MTc0Mzk5************************************************cGRCUTg9' \
-X POST -d '{
    "username": "me@host.com",
    "dialog_id": "1805856544967491584"
}'
```

Response example:

```json
{
    "code": "000000",
    "message": "ok",
    "data": [
        {
            "id": "2070_183",
            "meta": [],
            "section": "question: I want to apply for\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. An exclusive loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, and enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. \n\n[Warm reminder]: 1 , If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you, and click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "prob": 0.883,
            "rerank_score": 0.883,
            "combine_query": "question: I want to apply for\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. An exclusive loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, and enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. \n\n[Warm reminder]: 1 , If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you, and click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "from": "milvus",
            "emb_type": "file",
            "knowledge_base_id": 654,
            "knowledge_base_name": "swq knowledge base",
            "high_light_content": "",
            "image_num": 0,
            "dataset_name": "banyan app_xlsx.csv",
            "dataset_id": "2070_183"
        },
        {
            "id": "2070_273",
            "meta": [],
            "section": "question: Requirements for applying for a loan\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. An exclusive loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money \" or a single loan product on the corresponding page, enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. [Warm reminder]: 1. If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you. Click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "prob": 0.8571,
            "rerank_score": 0.8571,
            "combine_query": "question: Requirements for applying for a loan\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. An exclusive loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. [Warm reminder]: 1. If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you. Click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "from": "milvus",
            "emb_type": "file",
            "knowledge_base_id": 654,
            "knowledge_base_name": "swq knowledge base",
            "high_light_content": "Answer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. An exclusive loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, and enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. [Warm reminder]: 1. If your homepage does not have \"You\" Select loan \", you can click on the loan product recommended for you, click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your own needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated.",
            "image_num": 0,
            "dataset_name": "banyan app_xlsx.csv",
            "dataset_id": "2070_273"
        },
        {
            "id": "2070_182",
            "meta": [],
            "section": "question: I want to borrow money\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. A dedicated loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, and enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. \n\n[Warm reminder]: 1 , If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you, and click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "prob": 0.8396,
            "rerank_score": 0.8396,
            "combine_query": "question: I want to borrow money\nanswer: Hello, the loan application operation is as follows: 1. You download the XXX app to perform identity information authentication; 2. A dedicated loan plan has been customized for you on the homepage. You can click on the application entrance \"Preferred Loan\" on the homepage and click \"Receive Money Now\" or a single loan product on the corresponding page, and enter the information filling page (need to fill in basic information, real-name authentication, emergency contact person, and supplementary information) to apply for a loan. \n\n[Warm reminder]: 1 , If there is no \"Preferred Loan\" on your homepage, you can click on the loan product recommended for you, and click on the product details page to introduce the detailed introduction, including the required materials, application conditions, product details, repayment amount calculation, etc. You can apply according to your needs. Whether the application can be successful, please refer to the display of the page. 2. Any behavior that contacts you in the name of improving the review amount, confirming repayment ability, etc., and asking you to make a payment or provide verification code is a loan fraud. Please be vigilant and beware of being cheated. ",
            "from": "milvus",
            "emb_type": "file",
            "knowledge_base_id": 654,
            "knowledge_base_name": "swq knowledge base",
            "high_light_content": "",
            "image_num": 0,
            "dataset_name": "banyan app_xlsx.csv",
            "dataset_id": "2070_182"
        }
    ]
}
```
