Создание чанков с помощью Public API

Перед началом работы

1. Создайте бакет и папку внутри него.

2. Создайте сервисный аккаунт с ролью managed-rag.admin.

3. Сгенерируйте ключи доступа для сервисного аккаунта.

   Сохраните Key ID (логин) и Key Secret (пароль).

4. Получите токен для доступа к Public API с помощью curl-запроса:

   curl --location 'https://iam.api.cloud.ru/api/v1/auth/token' \
       --header 'Content-Type: application/json' \
       --data '{
       "keyId": "<key_id>",
       "secret": "<secret>"
       }'
   
   

   Где:

   • keyId — Key ID (логин) ключа доступа;

   • secret — Key Secret (пароль) ключа доступа.

   Токен понадобится для запроса на создание чанка.

1. Создайте базу знаний

1. Перейдите в AI Factory → Managed RAG.

2. Нажмите Создать базу знаний.

3. В поле Название введите api-chunks-kb.

4. Активируйте опцию Создать первую версию.

5. В поле Название версии введите api-chunks-version.

6. В блоке Источники из S3 нажмите Выбрать и выберите ранее созданную папку.

7. В поле Расширения документов выберите расширение txt.

8. Нажмите Создать.

2. Создайте чанк с помощью API

1. Отправьте запрос Create для создания чанка:

   curl -X GET 'https://managed-rag.api.cloud.ru/v2/chunks \
   -H "Content-Type: application/json" \
   -H 'Authorization: Bearer <access_token> \
   -d '{
         "knowledgebase_id": "<knowledgebase_id>",
         "knowledgebase_version_id": "<knowledgebase_version_id>",
         "project_id": "<project_id>",
         "chunks": [
            {
               "chunk_id": "<chunk_id>",
               "type": "CONTENT_TYPE_TEXT",
               "content": "my first chunk."
            }
         ]
      }'
   
   

   Где:

   • <access_token> — токен доступа, полученный перед началом работы;

   • <knowledgebase_id> — идентификатор базы знаний;

   • <knowledgebase_version> — идентификатор версии базы знаний;

   • <project_id> — идентификатор проекта;

   • <chunk_id>— идентификатор чанка. Введите желаемый идентификатор или оставьте поле пустым для автоматической генерации.

2. Посмотрите получившийся чанк:

   1. Перейдите в AI Factory → Managed RAG.

   2. Нажмите на карточку базы знаний api-chunks-kb.

   3. Перейдите на вкладку Чанки.

   4. В строке Контент нажмите на содержимое чанка.

   Откроется информация о чанке.

Результат

Вы научились создавать чанки в базе знаний с помощью Public API.