> For the complete documentation index, see [llms.txt](https://docs.athenachat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.athenachat.ai/funkcional/baza-znanii.md). # База знаний Вопросы и ответы, из которых агент берёт информацию для клиентов База знаний — это инструмент, который позволяет Афина использовать предоставленную вами информацию для ответов на вопросы. Она представляет собой организованный набор данных, к которому бот обращается при поиске необходимых ответов. Эффективное сочетание база знаний и настроек бота обеспечивает достижение требуемых результатов в работе системы. {% hint style="warning" %} **Важно!** Инструкции поведения всегда имеют первоочередное значение, тогда как база знаний служит вспомогательным инструментом. {% endhint %} База знаний представляет собой аналог раздела FAQ — это место, где собраны ответы на возможные вопросы. Если клиент задаёт вопрос, схожий с теми, что уже есть в базе знаний, ИИ-агент использует накопленную информацию и предоставляет наиболее точный и релевантный ответ. {% hint style="warning" %} **Важно!** База знаний работает по совпадению смысла в конкретном сообщении клиента с содержимым в колонке “вопрос”. {% endhint %} ## Колонка вопрос: ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FZRUGQSozMW2oQbvkxuOw%2Fkb-01.webp?alt=media) ## Колонка ответ: ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2F21vcRK3Dh8Lz8A7gtDf6%2Fkb-02.webp?alt=media) ## Ответ по совпадению: ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FPRHXUDVamCjDEUNbYIFr%2Fkb-03.webp?alt=media) Для создания база знаний откройте соответствующий раздел в главном меню и нажмите кнопку «Новая база знаний». После этого вы сможете приступить к ее наполнению необходимой информацией. ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FfAbxcIMBOc5Qv8m3ecOP%2Fkb-04.webp?alt=media) Добавить в базу вопросы-ответы, на которые будет ориентироваться ИИ агент можно несколькими способами: ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FvGP7xHsEG3R7rgnTXJPG%2Fkb-05.webp?alt=media) **Добавление URL.** Укажите URL-адреса тех сайтов, информацию с которых необходимо предоставить ИИ-агенту для дальнейшего использования. {% hint style="warning" %} **Важно!** Советуем загружать файлы и URL-адреса по одному для более удобного отслеживания получившихся результатов. После загрузки перейдите во вкладку «Ответы», чтобы ознакомиться с автоматически созданными вопросами и ответами. При необходимости вы можете отредактировать их для повышения точности и соответствия вашим требованиям. {% endhint %} 1. **Загрузка файлов.** Вы можете загружать файлы в форматах TXT, DOC, DOCX и PDF. На основании этих файлов Афина сформирует вопросы и ответы, которые затем будут использоваться ИИ-агентом. 2. **Импорт ответов.** Вы можете составить Google-таблицу или Excel-файл с двумя колонками: в первой колонке указываются вопросы, а во второй — соответствующие им ответы. Загрузить таблицу можете через кнопку “Импорт ответов”. 3. **Свои вопросы-ответы.** Вы можете вручную добавить нужные вопросы и ответы в базу знаний, воспользовавшись опцией «Свой вопрос-ответ». ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FdFEPzWJs74c0Ll2NaN2Q%2Fkb-06.webp?alt=media) В любой момент возможно отредактировать или удалить созданные вопросы и ответы. При необходимости к каждому ответу можно прикрепить изображение, видео или файл. ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FyBm1E9ql7Ak6mXmaHzit%2Fkb-07.webp?alt=media) Если смысл сообщения клиента совпадает с информацией из колонки «вопрос», Афина подберёт соответствующий ответ. По умолчанию текст ответа может быть автоматически переформулирован ИИ. Если необходимо, чтобы ответ воспроизводился в точности так, как указан в колонке «ответ», активируйте настройку «Не использовать ИИ в ответе». Для удобной работы с вопросами и ответами используйте поиск и фильтрацию по источнику информации. В любое время вы можете выгрузить вашу базу знаний, воспользовавшись кнопкой «Экспорт ответов». После того как база знаний заполнена, её можно подключить к необходимым каналам. Для этого доступны два способа: через вкладку «Каналы» в разделе база знаний или через настройки конкретного канала. После подключения база знаний можно приступать к тестированию. Учтите, что база знаний, в отличие от инструкций бота, реагирует на конкретные сообщения — она используется только тогда, когда смысл сообщения собеседника совпадает с вопросом, содержащимся в базе. Понять, была ли использована база знаний и какой именно вопрос-ответ был выбран для формирования ответа, можно с помощью кнопки «Инфо» под сообщением бота в разделе “Сообщения”. Если эта кнопка отсутствует, значит, при формировании ответа база знаний не была задействована. Если полученный ответ ИИ-агента вас не устраивает, нажмите на кнопку «Не верно» и вручную скорректируйте ответ. В этом случае новая пара вопрос-ответ автоматически добавится в базу знаний. ![](https://4126380821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwirYrs8odJMFan3KqfzY%2Fuploads%2FGDbMn8cOtuiVypWG6UUF%2Fkb-08.webp?alt=media) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.athenachat.ai/funkcional/baza-znanii.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.