PaLM API: מדריך למתחילים להטמעות ב-Java

במדריך למתחילים תוכלו להתחיל להשתמש בשירות ההטמעה של PaLM API. תשתמשו בשירות ההטמעות כדי ליצור הטמעות טקסט, שבהן תוכלו להשתמש באפליקציות שונות של שפה טבעית.

קבלת מפתח API

כדי להתחיל, אתם צריכים לקבל מפתח API.

מהן הטמעות?

הטמעות הן שיטה שמשמשת לייצוג טקסט (כמו מילים, משפטים או פסקאות שלמות) כרשימה של מספרי נקודות צפות במערך. הרעיון המרכזי הוא שלטקסט עם משמעויות דומות יהיו הטמעות דומות. אפשר להשתמש בקשרים ביניהם כדי לבצע משימות חשובות רבות.

התקנה של לקוח ה-API

ההוראות האלה יתקינו את PaLM Java SDK במאגר המקומי של Maven, כדי שתוכלו להוסיף אותו כתלות בפרויקט 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);