# Создание подключения Cohere (Amazon Bedrock)

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

Примечание к информации

Коннектор Amazon Bedrock - Converse API позволяет подключиться к универсальному Amazon Bedrock API для генеративных текстовых моделей, в том числе к моделям, доступными через этот коннектор. Для получения более широкой функциональности рекомендуется заменить подключения, использующие конфигурацию Cohere - Generate, на подключения Amazon Bedrock - Converse API.

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

Данные, полученные из этих подключений, можно использовать в скрипте загрузки и выражениях диаграммы, чтобы расширить возможности аналитических приложений Qlik Sense.

## Конфигурации и настраиваемые параметры

Настройте подключение к аналитике Cohere (Amazon Bedrock) с использованием одной из следующих конфигураций. Каждое подключение может содержать одну конфигурацию.

Дополнительная информация о типах моделей и их предусмотренном назначении приводится в официальной документации Cohere:[Models](https://docs.cohere.com/docs/models)

### Cohere - Generate

Используйте эту конфигурацию для доступа к стандартным моделям Command через Cohere.

Для получения дополнительной информации об этих параметрах см. документацию Amazon Bedrock и Cohere:

* [Cohere Command модели](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere.html#model-parameters-cohere-command)

* [Co.Generate](https://docs.cohere.com/reference/generate)

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

| Поле | Описание |
| --- | --- |
| Cohere Model | Выберите модель, которая будет использоваться для генерирования ответов. |
| AWS Region | Выберите соответствующий географический регион ресурсов AWS. |
| Use FIPS Endpoint (US Regions Only) | Выберите, следует ли для обмена данными между подключением и AWS использовать шифрование с той или иной версией FIPS (Федеральный стандарт обработки информации). |
| AWS Access Key | Введите идентификатор ключа доступа AWS, представляющий собой одну часть пары ключа доступа (вторая часть — это секретный ключ), которую необходимо вводить в качестве учетных данных для аутентификации учетной записи AWS. |
| AWS Secret Key | Введите секретный ключ AWS (первую часть пары ключа доступа; вторая часть — это идентификатор секретного ключа). Эти данные нужны для аутентификации учетной записи AWS. |
| Maximum Token Count | Задайте длину ответа, генерируемого моделью. |
| Temperature | Управление случайностью ответа модели. Чем меньше значение, тем ниже степень случайности. |
| p | Также называется Top P. Управление вероятностью использования токена. Чем ниже значение, тем выше степень исключения наименее вероятных токенов.<br><br>Значение 0 или 1.0 указывает на то, что параметр выключен. См. [документацию из внешних источников](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere.html) для получения информации о том, как эта настройка взаимодействует с параметром K. |
| K | Также называется Top K. Настройте, сколько вариантов токенов рассматривается при создании следующего токена в ответе. См. [документацию из внешних источников](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere.html) для получения информации о том, как эта настройка взаимодействует с параметром p. |
| Association Field | Задайте поле связи, это поле из таблицы входных данных, содержащее уникальный идентификатор.<br><br>Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным идентификатором, из исходных данных или из процесса загрузки таблицы. |
| Name | Имя подключения. Если поле оставлено пустым, используется имя по умолчанию. |

### Cohere - Embed

Используйте эту конфигурацию для доступа к моделям Embed в Cohere. Их также иногда называют моделями Representation. Эти модели создают встраивания и позволяют выполнять задачи классификации текста.

Для получения дополнительной информации об этих параметрах см. документацию Amazon Bedrock и Cohere:

* [Cohere Embed модели](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere.html#model-parameters-embed)

* [Co.Embed](https://docs.cohere.com/reference/embed)

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

| Поле | Описание |
| --- | --- |
| Cohere Embed Model | Выберите модель, которая будет использоваться для генерирования ответов. |
| AWS Region | Выберите соответствующий географический регион ресурсов AWS. |
| Use FIPS Endpoint (US Regions Only) | Выберите, следует ли для обмена данными между подключением и AWS использовать шифрование с той или иной версией FIPS (Федеральный стандарт обработки информации). |
| AWS Access Key | Введите идентификатор ключа доступа AWS, представляющий собой одну часть пары ключа доступа (вторая часть — это секретный ключ), которую необходимо вводить в качестве учетных данных для аутентификации учетной записи AWS. |
| AWS Secret Key | Введите секретный ключ AWS (первую часть пары ключа доступа; вторая часть — это идентификатор секретного ключа). Эти данные нужны для аутентификации учетной записи AWS. |
| Input Type | Выберите тип входных данных из списка доступных вариантов. Это техническая конфигурация, она зависит от конкретного случая применения встраиваний. Для получения дополнительных сведений см. [документацию внешних поставщиков](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere.html#model-parameters-embed).<br><br>Доступны следующие параметры.<br><br><ul> <li> <p><span>Search Document</span> </p> </li> <li> <p><span>Search Query</span> </p> </li> <li> <p><span>Classification</span> </p> </li> <li> <p><span>Clustering</span> </p> </li> </ul> |
| Association Field | задайте значение параметра Association Field (Поле связи), это поле из таблицы входных данных, содержащее уникальный идентификатор.<br><br>Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным идентификатором, из исходных данных или из процесса загрузки таблицы. |
| Name | Имя подключения. Если поле оставлено пустым, используется имя по умолчанию. |

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

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

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

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

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

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

4. Выберите Cohere (Amazon Bedrock) из списка коннекторов данных.

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

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

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

Созданное подключение можно использовать для загрузки данных вместе с запросами и с ответами платформы на них. Кроме того, его можно использовать в выражениях диаграммы. Для получения дополнительной информации см. разделы [Выбор и загрузка данных из подключения Cohere (Amazon Bedrock)](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-cohere-load.htm) и [Использование подключений AI21 Labs (Amazon Bedrock) в выражениях визуализации](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-ai21-use.htm).