PaLM API: Java के साथ क्विकस्टार्ट एम्बेड करना

इस क्विकस्टार्ट की मदद से, PaLM API की एम्बेड करने वाली सेवा का इस्तेमाल किया जा सकता है. टेक्स्ट एम्बेड करने की सुविधा जनरेट करने के लिए, एम्बेड करने की सेवा का इस्तेमाल किया जाएगा. इस सेवा का इस्तेमाल, नैचुरल लैंग्वेज में बनाए जाने वाले अलग-अलग ऐप्लिकेशन में किया जा सकता है.

कोई API कुंजी पाएं

शुरू करने के लिए, आपको एपीआई पासकोड चाहिए.

एम्बेड करना क्या होता है?

एम्बेड करना ऐसी तकनीक है जिसका इस्तेमाल टेक्स्ट (जैसे कि शब्द, वाक्य या पूरे पैराग्राफ़) को किसी अरे में फ़्लोटिंग पॉइंट नंबर की सूची के तौर पर दिखाने के लिए किया जाता है. मुख्य आइडिया यह है कि मिलते-जुलते मतलब वाले टेक्स्ट के लिए, एम्बेड किए गए टेक्स्ट एक जैसे होंगे. कई ज़रूरी कामों के लिए, इन दोनों के बीच संबंध का इस्तेमाल किया जा सकता है.

एपीआई क्लाइंट इंस्टॉल करें

इन निर्देशों की मदद से, आपके स्थानीय Maven का डेटा स्टोर करने की जगह में PaLM Java SDK टूल को इंस्टॉल कर दिया जाएगा. इससे आपके 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 शुरू करने के लिए अपनी एपीआई कुंजी को हेडर के तौर पर 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);