PaLM API: krótkie wprowadzenie do umieszczania w Javie

Z tego krótkiego wprowadzenia dowiesz się, jak zacząć korzystać z usługi reprezentacji właściwościowej interfejsu PaLM API. Użyjesz usługi reprezentacji właściwościowych do generowania reprezentacji tekstowych, których możesz używać w różnych aplikacjach wykorzystujących język naturalny.

Uzyskiwanie klucza interfejsu API

Najpierw musisz uzyskać klucz interfejsu API.

Co to są wektory dystrybucyjne?

Osadzanie to technika stosowana do przedstawiania tekstu (np. słów, zdań lub całych akapitów) w postaci listy liczb zmiennoprzecinkowych w tablicy. Najważniejsze jest to, że tekst o podobnych znaczeniach znajdzie się w podobnych miejscach. Relacji między nimi możesz używać w wielu ważnych zadaniach.

Instalowanie klienta interfejsu API

Dzięki tym instrukcjom zainstalujesz pakiet SDK PaLM w języku Java w lokalnym repozytorium Maven, co pozwoli Ci dodać go jako zależność do projektu Gradle.

1. Pobierz plik google-cloud-ai-generativelanguage-v1-java.tar.gz.

2. Wyodrębnij pliki i zainstaluj je w folderze mavenLocal:

   # Extract the files
   tar -xzvf google-cloud-ai-generativelanguage-v1-java.tar.gz
   cd google-cloud-ai-generativelanguage-v1-java
   
   # Install to mavenLocal
   ./gradlew publishToMavenLocal
   

3. Otwórz plik konfiguracji Gradle i sprawdź, czy mavenLocal() znajduje się na liście w sekcji repositories:

   repositories {
       mavenCentral()
       // ...
   
       // Add the Maven Local repository
       mavenLocal()
   }
   

4. Dodatkowo w pliku konfiguracji Gradle dodaj niezbędne biblioteki do bloku dependencies:

   dependencies {
       // ...
   
       // Add these dependencies to use Generative AI
       implementation("com.google.cloud:gapic-google-cloud-ai-generativelanguage-v1-java:0.0.0-SNAPSHOT")
       implementation("io.grpc:grpc-okhttp:1.53.0")
   }
   

Inicjowanie klienta usługi tekstowej

W swoim programie w Javie zainicjuj TextServiceClient, przekazując klucz interfejsu API jako nagłówek do interfejsu TransportChannelProvider, który ma być używany przez TextServiceSettings:

HashMap<String, String> headers = new HashMap<>();
headers.put("x-goog-api-key", "API_KEY");

TransportChannelProvider provider = InstantiatingGrpcChannelProvider.newBuilder()
    .setHeaderProvider(FixedHeaderProvider.create(headers))
    .build();

TextServiceSettings settings = TextServiceSettings.newBuilder()
    .setTransportChannelProvider(provider)
    .setCredentialsProvider(FixedCredentialsProvider.create(null))
    .build();

TextServiceClient client = TextServiceClient.create(settings);

Generowanie wektorów dystrybucyjnych

W tej sekcji dowiesz się, jak generować wektory dystrybucyjne dla fragmentu tekstu przy użyciu metody embedText.

Aby użyć metody embedText, przekaż nazwę modelu wraz z tekstem do umieszczenia. Pojawi się lista wartości zmiennoprzecinkowych.

EmbedTextRequest request = EmbedTextRequest.newBuilder()
    .setModel("models/embedding-gecko-001") // Required, which model to use to generate the result
    .setText("What do squirrels eat?") // Required
    .build();

EmbedTextResponse response = client.embedText(request);

List<Float> embedding = response.getEmbedding().getValueList();

System.out.println(embedding);