PaLM API: Java ile yerleştirme hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzu, PaLM API'nin yerleştirme hizmetini kullanmaya başlamanızı sağlar. Çeşitli doğal dil uygulamalarında kullanabileceğiniz metin yerleştirmeleri oluşturmak için yerleştirme hizmetini kullanırsınız.

API Anahtarı Alma

Başlamak için bir API anahtarı edinmeniz gerekir.

Gömme nedir?

Yerleştirme, bir dizideki kayan nokta sayıları listesi olarak metinleri (kelimeler, cümleler veya paragrafların tamamı gibi) temsil etmek için kullanılan bir tekniktir. Buradaki temel fikir, benzer anlamlara sahip metinlerin benzer yerleştirmelere sahip olmasıdır. Aralarındaki ilişkiyi birçok önemli görev için kullanabilirsiniz.

API istemcisini yükleme

Bu talimatlarla, PaLM Java SDK yerel Maven deponuza yüklenir. Böylece bu SDK'yı, Gradle projenize bağımlılık olarak ekleyebilirsiniz.

1. google-cloud-ai-generativelanguage-v1-java.tar.gz dosyasını indirin.

2. Dosyaları çıkarıp mavenLocal konumuna yükleyin:

   # 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. Gradle yapılandırma dosyanızı açın ve mavenLocal() öğesinin repositories altında listelendiğinden emin olun:

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

4. Ayrıca, Gradle yapılandırma dosyanıza, gerekli kitaplıkları dependencies bloğuna ekleyin:

   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")
   }
   

Metin hizmeti istemcisini başlatma

Java programınızda API Anahtarınızı TextServiceSettings tarafından kullanılacak TransportChannelProvider öğesine başlık olarak ileterek bir TextServiceClient başlatın:

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);

Yerleştirme oluşturma

Bu bölümde, embedText yöntemini kullanarak bir metin parçası için yerleştirmelerin nasıl oluşturulacağını görebilirsiniz.

embedText yöntemini kullanmak için modelin adını ve yerleştirilecek metni iletin. Kayan nokta değerlerinin listesi görüntülenir.

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);