PaLM API: การฝังการเริ่มต้นอย่างรวดเร็วด้วย Java

การเริ่มต้นอย่างรวดเร็วนี้จะช่วยให้คุณเริ่มต้นใช้งานบริการที่ฝังของ PaLM API คุณจะใช้บริการฝังเพื่อสร้างการฝังข้อความ ซึ่งคุณใช้ได้ในแอปพลิเคชันภาษาธรรมชาติต่างๆ

รับคีย์ API

คุณจะต้องรับคีย์ API เพื่อเริ่มต้นใช้งาน

การฝังคืออะไร

การฝังเป็นเทคนิคที่ใช้ในการแสดงข้อความ (เช่น คำ ประโยค หรือทั้งย่อหน้า) ในแบบรายการของจำนวนจุดลอยตัวในอาร์เรย์ แนวคิดหลักคือข้อความที่มีความหมายคล้ายกันจะมีการฝังที่คล้ายกัน คุณใช้ความสัมพันธ์ระหว่างชิ้นงานเหล่านั้นสำหรับงานสำคัญต่างๆ ได้

ติดตั้งไคลเอ็นต์ API

วิธีการเหล่านี้จะติดตั้ง PaLM Java SDK ในที่เก็บ Maven ในเครื่อง เพื่อให้คุณเพิ่มเป็นทรัพยากร Dependency ในโปรเจ็กต์ Gradle ได้

  1. ดาวน์โหลดไฟล์ google-cloud-ai-generativelanguage-v1-java.tar.gz
  2. แตกไฟล์และติดตั้งใน 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. เปิดไฟล์การกำหนดค่า Gradle แล้วตรวจสอบว่า mavenLocal() แสดงอยู่ในส่วน repositories

    repositories {
        mavenCentral()
        // ...
    
        // Add the Maven Local repository
        mavenLocal()
    }
    
  4. นอกจากนี้ในไฟล์การกำหนดค่า Gradle ให้เพิ่มไลบรารีที่จำเป็นลงในบล็อก 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")
    }
    

เริ่มต้นไคลเอ็นต์บริการข้อความ

ในโปรแกรม Java ให้เริ่มต้น TextServiceClient โดยการส่งคีย์ API เป็นส่วนหัวไปยัง TransportChannelProvider เพื่อให้ 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);

สร้างการฝัง

ในส่วนนี้ คุณจะเห็นวิธีสร้างการฝังสำหรับข้อความเดียวโดยใช้เมธอด embedText

หากต้องการใช้เมธอด embedText ให้ส่งชื่อโมเดลและข้อความบางส่วนที่จะฝัง คุณจะเห็นรายการค่าทศนิยม

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