PaLM API: Panduan memulai penyematan dengan Java

Panduan memulai ini akan membantu Anda untuk mulai menggunakan layanan embeddings PaLM API. Anda akan menggunakan layanan embedding untuk membuat embedding teks yang dapat digunakan di berbagai aplikasi natural language.

Mendapatkan Kunci API

Untuk memulai, Anda harus mendapatkan kunci API.

Apa itu embedding?

Embeddings adalah teknik yang digunakan untuk mewakili teks (seperti kata, kalimat, atau seluruh paragraf) sebagai daftar angka floating point dalam array. Ide utamanya adalah teks dengan makna serupa akan memiliki embedding yang serupa. Anda dapat menggunakan hubungan di antara keduanya untuk banyak tugas penting.

Menginstal klien API

Petunjuk ini akan menginstal PaLM Java SDK di repositori Maven lokal sehingga Anda dapat menambahkannya sebagai dependensi ke project Gradle Anda.

1. Download file google-cloud-ai-generativelanguage-v1-java.tar.gz.

2. Ekstrak file dan instal di 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. Buka file konfigurasi Gradle dan pastikan mavenLocal() tercantum di repositories:

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

4. Selain itu, di file konfigurasi Gradle Anda, tambahkan library yang diperlukan ke blok 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")
   }
   

Menginisialisasi klien layanan teks

Dalam program Java, lakukan inisialisasi TextServiceClient dengan meneruskan Kunci API sebagai header ke TransportChannelProvider untuk digunakan oleh 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);

Membuat embedding

Di bagian ini, Anda akan mempelajari cara membuat embedding untuk sebuah teks menggunakan metode embedText.

Untuk menggunakan metode embedText, teruskan nama model serta beberapa teks untuk disematkan. Anda akan mendapatkan daftar nilai floating point.

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