# Tworzenie połączenia Amazon Bedrock - Converse API

Aby komunikować się z Amazon Bedrock, utwórz połączenie ze źródłem analityki Amazon Bedrock - Converse API. Utwórz połączenie na stronie Utwórz w centrum aktywności Analytics, Edytor ładowania danych lub Skrypt.

## Konfigurowalne ustawienia

Aby uzyskać szczegółowe informacje na temat konfigurowania parametrów sterowanych zewnętrznie, zobacz:

* [Using the Converse API](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html): zapoznaj się z parametrami konfiguracji specyficznymi dla interfejsu API Converse.

* [Inference request parameters and response fields for foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html): poznaj parametry konfiguracyjne specyficzne dla używanego modelu.

Konfigurowalne ustawienia w oknie dialogowym połączeń

| Pole | Opis i opcje |
| --- | --- |
| Model ID or ARN | Wprowadź ID lub ARN modelu, którego chcesz użyć. Informacje te można znaleźć na stronie karty modelu w konsoli Amazon Bedrock.<br><br>Obsługiwane są modele hostowane w Amazon Bedrock Marketplace. Po wdrożeniu modelu jego numer ARN można uzyskać z konsoli Amazon Bedrock.<br><br>Wnioskowanie między regionami (CRIS) jest obsługiwane dla używanego modelu.<br><br>Nie wszystkie modele są dostępne w każdym regionie. |
| AWS Region | Wybierz odpowiedni region geograficzny, w którym hostowane są zasoby AWS. |
| Use FIPS Endpoint (US Regions Only) | Wybierz, czy komunikacja pomiędzy połączeniem a AWS ma używać szyfrowania zgodnego z którąś wersją normy Federal Information Processing Standard (FIPS). |
| Authentication Method | Wybierz sposób uwierzytelnienia połączenia. Można wybrać AWS Auth v4 Signature (domyślnie) lub Bedrock API Key. |
| AWS Access Key | Ma zastosowanie, gdy strona Authentication Method jest ustawiona na AWS Auth v4 Signature (domyślnie).<br><br>Wprowadź identyfikator klucza dostępu AWS stanowiący jedną z części pary kluczy dostępu (druga to klucz tajny), który należy podać jako poświadczenia w celu uwierzytelnienia na koncie AWS. |
| AWS Secret Key | Ma zastosowanie, gdy strona Authentication Method jest ustawiona na AWS Auth v4 Signature (domyślnie).<br><br>Wprowadź klucz tajny AWS stanowiący jedną z części pary kluczy dostępu (druga to identyfikator klucza dostępu), który należy podać jako poświadczenia w celu uwierzytelnienia na koncie AWS. |
| Bedrock API Key | Ma zastosowanie, gdy Authentication Method ustawiono na Bedrock API Key.<br><br>Wprowadź klucz API z Amazon Bedrock. |
| System Prompt | Parametr opcjonalny. Jest to pole tekstowe, w którym możesz wstawić informacje kontekstowe i dodatkowe wytyczne, które chcesz przekazać modelowi przed udostępnieniem mu promptu. Więcej informacji zawiera [oficjalna dokumentacja Converse API](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html). |
| Maximum Token Count | Ustaw długość odpowiedzi generowanej przez model. |
| Temperature | Kontroluj losowość odpowiedzi z modelu. Zasadniczo im mniejsza wartość, tym mniejsza losowość.<br><br>Ustawienia, których należy użyć, zależą od konfiguracji tego parametru dla używanego modelu. Więcej informacji można znaleźć w [dokumentacji Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). |
| Top P | Kontroluj prawdopodobieństwo użycia tokenów. Mniejsza wartość prowadzi zasadniczo do większego wykluczenia mniej prawdopodobnych tokenów.<br><br>Ustawienia, których należy użyć, zależą od konfiguracji tego parametru dla używanego modelu. Więcej informacji można znaleźć w [dokumentacji Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). |
| Configuration - Guardrails | Łącznik Amazon Bedrock - Converse API obsługuje ograniczenia skonfigurowane w konsoli Amazon Bedrock. Do żądań stosowane są ograniczenia.<br><br>Ograniczenia pomagają chronić użytkowników modelu przed złośliwą i nieodpowiednią zawartością. Można skonfigurować następujące ustawienia:<br><br><ul> <li> <p> <span>Guardrail Identifier (ARN)</span>: identyfikator używanego ograniczenia.</p> </li> <li> <p> <span>Guardrail Version</span>: wersja używanego ograniczenia.</p> </li> <li> <p> <span>Guardrail Trace</span>: ślad umożliwiający śledzenie w celu przeglądania procesów modelu z jednoczesnym blokowaniem niechcianej zawartości.</p> </li> </ul><br><br>Ograniczenia nie są dostępne dla wszystkich modeli Amazon Bedrock. |
| Association Field | Określ pole powiązania, pole z tabeli danych wejściowych zawierające unikatowy identyfikator.<br><br>Pole to należy uwzględnić w danych źródłowych podczas tworzenia żądania punktu końcowego, aby zwrócona tabela wyników była powiązana z tabelą pól źródłowych przy użyciu klucza. Wyznaczone pole zostanie zwrócone jako pole w odpowiedzi i umożliwi powiązanie odpowiedzi z danymi źródłowymi w modelu danych. Może to być dowolne pole z unikatowym identyfikatorem, pochodzące z danych źródłowych lub używane w ramach procesu ładowania tabeli. |
| Name | Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna. |

## Tworzenie nowego połączenia

Połączenie z łącznikiem analitycznym można utworzyć z centrum aktywności Analytics, z Edytor ładowania danych w istniejącej aplikacji lub z Skrypt w istniejącym skrypcie. Aby utworzyć połączenie, wykonaj poniższe czynności.

Wykonaj następujące czynności:

1. Uzyskaj dostęp do łącznika za pomocą narzędzia Edytor ładowania danych lub Skrypt.

2. Kliknij polecenie Utwórz nowe połączenie.

3. W obszarze Przestrzeń wybierz przestrzeń, w której będzie się znajdować połączenie.

4. Wybierz Amazon Bedrock - Converse API z listy łączników danych.

5. Wypełnij pola okna dialogowego połączenia.

6. Kliknij Utwórz.

Twoje połączenie jest teraz wyświetlane w obszarze Połączenia danych w narzędziu Edytor ładowania danych lub Skrypt.

Po utworzeniu połączenia można go użyć do ładowania danych z żądaniami i odpowiedziami platformy na nie. Ponadto można go używać w wyrażeniach wykresów. Więcej informacji zawiera temat:

* [Wybieranie i ładowanie danych z połączenia Amazon Bedrock - Converse API](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [Używanie połączeń Amazon Bedrock - Converse API w wyrażeniach wizualizacji](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)