Palm API: Embeddings با جاوا شروع سریع می‌کند

این شروع سریع به شما کمک می‌کند تا از سرویس جاسازی‌های PalM API استفاده کنید. شما از سرویس embeddings برای ایجاد جاسازی های متنی استفاده خواهید کرد که می توانید در برنامه های مختلف زبان طبیعی استفاده کنید.

یک کلید 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")
   }
   

سرویس گیرنده متن را راه اندازی کنید

در برنامه جاوا خود، یک 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);