# Создание подключения Amazon Bedrock - Converse API

Чтобы обеспечить обмен данными с Amazon Bedrock, создайте подключение к источнику аналитики Amazon Bedrock - Converse API. Создайте подключение на странице «Создать страницу» в центре активности Аналитика, Редактор загрузки данных или Скрипт.

## Настраиваемые параметры

Подробную информацию о параметрах, управляемых из внешних приложений, см:

* [Использование API Converse](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html): узнайте о конфигурационных параметрах Converse API.

* [Параметры запроса на получение выходных данных и поля ответа для базовых моделей](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html): больше о конфигурационных параметрах конкретной модели.

Настраиваемые параметры в диалоговом окне подключения

| Поле | Описание и опции |
| --- | --- |
| Model ID or ARN | Введите ID или ARN используемой модели. Эту информацию можно найти на странице карты модели в консоли Amazon Bedrock.<br><br>Поддерживаются модели, размещенные на Amazon Bedrock Marketplace. Если модель уже развернута, ARN модели можно получить в консоли Amazon Bedrock.<br><br>Используемая модель поддерживает технологию межрегионального вывода (Cross-region inference, CRIS).<br><br>Некоторые модели доступны только в определенных регионах. |
| AWS Region | Выберите соответствующий географический регион, где размещаются ресурсы AWS. |
| Use FIPS Endpoint (US Regions Only) | Выберите, следует ли для обмена данными между подключением и AWS использовать шифрование с той или иной версией FIPS (Федеральный стандарт обработки информации). |
| Authentication Method | Выберите тип аутентификации в подключении. Доступно: AWS Auth v4 Signature (по умолчанию) или Bedrock API Key. |
| AWS Access Key | Применяется, если в параметре Authentication Method выбрано AWS Auth v4 Signature (по умолчанию).<br><br>Введите идентификатор ключа доступа AWS, представляющий собой одну часть пары ключа доступа (вторая часть — это секретный ключ), которую необходимо вводить в качестве учетных данных для аутентификации учетной записи AWS. |
| AWS Secret Key | Применяется, если в параметре Authentication Method выбрано AWS Auth v4 Signature (по умолчанию).<br><br>Введите секретный ключ AWS (первую часть пары ключа доступа; вторая часть — это идентификатор секретного ключа). Эти данные нужны для аутентификации учетной записи AWS. |
| Bedrock API Key | Применимо, если в Authentication Method выбрано Bedrock API Key.<br><br>Введите ключ API из Amazon Bedrock. |
| System Prompt | Дополнительный параметр. Это текстовое поле, куда можно вставить контекстную информацию и дополнительные рекомендации, которые требуется дать модели перед передачей запроса. Для получения дополнительной информации ознакомьтесь с [официальной документацией Converse API](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html). |
| Maximum Token Count | Задайте длину ответа, сгенерированного моделью. |
| Temperature | Управление случайностью ответа модели. Как правило, чем меньше значение, тем ниже степень случайности.<br><br>Настройки, которые следует использовать, зависят от того, как этот параметр настроен для конкретной модели. Для получения дополнительной информации см. [документацию Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). |
| Top P | Управление вероятностью использования токена. Как правило, чем ниже значение, тем выше степень исключения наименее вероятных токенов.<br><br>Настройки, которые следует использовать, зависят от того, как этот параметр настроен для конкретной модели. Для получения дополнительной информации см. [документацию Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). |
| Configuration - Guardrails | Коннектор Amazon Bedrock - Converse API поддерживает ограничения, заданные в консоли Amazon Bedrock. Ограничения применяются к запросам.<br><br>Ограничения необходимы, чтобы защитить пользователей модели от вредоносного и неприемлемого содержимого. Доступны следующие параметры:<br><br><ul> <li> <p> <span>Guardrail Identifier (ARN)</span>: идентификатор используемого ограничения.</p> </li> <li> <p> <span>Guardrail Version</span>: версия используемого ограничения.</p> </li> <li> <p> <span>Guardrail Trace</span>: специальный механизм, который может отслеживать процессы просмотра модели и блокировать нежелательный контент.</p> </li> </ul><br><br>Ограничения недоступны в некоторых моделях Amazon Bedrock. |
| Association Field | Задайте поле связи, это поле из таблицы входных данных, содержащее уникальный идентификатор.<br><br>Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным ИД, из исходных данных или из процесса загрузки таблицы. |
| Name | Имя подключения. Если поле оставлено пустым, используется имя по умолчанию. |

## Создание нового подключения

Можно создать подключение к аналитическому коннектору в центре активности Аналитика, из Редактор загрузки данных в существующем приложении или из Скрипт в существующем скрипте. Выполните перечисленные ниже действия, чтобы создать подключение.

Выполните следующие действия.

1. Вызовите коннектор через редактор загрузки данных или Скрипт.

2. Щелкните команду Создать новое подключение.

3. В поле Пространство выберите пространство, где будет находиться подключение.

4. Выберите Amazon Bedrock - Converse API из списка коннекторов данных.

5. Заполните поля диалогового окна подключения.

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

Теперь подключение отображается в списке Подключения к данным в Редактор загрузки данных или Скрипт.

Созданное подключение можно использовать для загрузки данных вместе с запросами и с ответами платформы на них. Кроме того, его можно использовать в выражениях диаграммы. Для получения дополнительной информации см.:

* [Выбор и загрузка данных из подключения Amazon Bedrock - Converse API](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [Использование подключений Amazon Bedrock - Converse API в выражениях визуализации](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)