Перейти к основному содержимому

Вопрос-ответ

Когда мы загрузили и обработали документы из базы знаний, мы можем задать вопрос конкретному ассистенту и получить точный ответ с указанием источника.​

Облачный URL сервера console.insightstream.ru:8000 Если вы используете локальную версию платформы Compressa, замените на ваш URL сервера InsightStream RAG

Для использования облачной версии на наших серверах вам необходимо запросить токен у команды. Важно! Токен InsightStream не совпадает с вашим токеном от платформы Compressа.

Отправка вопроса для получения ответа​

GET /assistants/{assistant_id}/queries?q={вопрос}

После отправки запроса ассистент выполнит поиск в проиндексированных документах и вернет ответ с указанием источников.

import requests

# Замените на ваш assistant_id и токен InsightStream
assistant_id = "1234"
token = "ваш_токен_InsightStream" #при локальном запуске вы можете не требовать ключ или создать свой

# Замените на ваш вопрос
search_query = "Ваш вопрос к боту"

# Определение URL
url = f"http://bot.insightstream.ru:8081/{assistant_id}/api_v1/answers" #при локальном запуске замените на ваш url, например http://localhost:8081/{assistant_id}/api_v1/answers

headers = {
    "Authorization": f"Bearer {token}"
}

params = {
    "search_query": search_query,
    "sync": 1
}

# Выполнение GET-запроса
response = requests.get(url, headers=headers, params=params)

# Печать ответа
print(response.status_code, response.text)

Ответ на запрос:​

  • 200 OK: Возвращает ответ и ссылку на соответствующие документы.
  • 400 Bad Request: Некорректные входные данные.
  • 404 Not Found: ИИ-ассистент не найден или индексация не завершена.
  • 429 Too Many Requests: Превышен лимит запросов.

Пример ответа​

200

{
  "summary": "Суточные выплачиваются в течение установленного срока после проверки документов через 5 дней.",
  "documents": [
    {
      "title": "example_1.pdf",
      "uri": "https://bot.insightstream.ru/documents/tmp/example_1.pdf",
      "passage_md": "Контроль за соблюдением данных правил возлагается на HR-отдел и бухгалтерию.",
      "doc_type": "application/pdf",
      "loc": {
        "from": 0,
        "to": 1
      }
    }
  ],
  "relevant_questions": [
    "Что делать, если обнаружены ошибки в отчете о командировке?",
    "Каков срок подачи отчета о командировке для получения суточных?",
    "Какие документы необходимо предоставить для получения суточных?"
  ]
}

Объяснение параметров ответа​

summary: Это сам ответ на заданный вопрос.

documents: Список документов, которые нашел ассистент для ответа на вопрос.

title Название документа.

uri Ссылка на документ.

passage_md Начало конкретного отрывка из документа, который использовался для ответа на вопрос.

doc_type: Тип документа (например, PDF).

relevant_questions: Список похожих вопросов.