API PaLM: Bắt đầu nhanh bằng Java

Hướng dẫn nhanh này sẽ giúp bạn bắt đầu sử dụng dịch vụ nhúng của API PaLM. Bạn sẽ sử dụng dịch vụ nhúng để tạo văn bản nhúng mà bạn có thể sử dụng trong nhiều ứng dụng ngôn ngữ tự nhiên.

Lấy khoá API

Để bắt đầu, bạn cần lấy khoá API.

Nhúng là gì?

Nhúng là một kỹ thuật dùng để biểu thị văn bản (như các từ, câu hoặc toàn bộ đoạn văn) dưới dạng danh sách các số dấu phẩy động trong một mảng. Ý tưởng chính là văn bản có ý nghĩa tương tự nhau sẽ có các cách nhúng tương tự nhau. Bạn có thể sử dụng mối quan hệ giữa chúng cho nhiều tác vụ quan trọng.

Cài đặt ứng dụng API

Những hướng dẫn này sẽ cài đặt PaLM Java SDK trong kho lưu trữ Maven cục bộ để bạn có thể thêm SDK đó làm phần phụ thuộc cho dự án Gradle của mình.

1. Tải tệp google-cloud-ai-generativelanguage-v1-java.tar.gz xuống.

2. Giải nén và cài đặt các tệp trong 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. Mở tệp cấu hình Gradle và đảm bảo mavenLocal() được liệt kê trong repositories:

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

4. Ngoài ra, trong tệp cấu hình Gradle, hãy thêm các thư viện cần thiết vào khối 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")
   }
   

Khởi động ứng dụng dịch vụ văn bản

Trong chương trình Java, hãy khởi chạy TextServiceClient bằng cách truyền Khoá API của bạn dưới dạng tiêu đề đến TransportChannelProvider để TextServiceSettings sử dụng:

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

Tạo các video nhúng

Trong phần này, bạn sẽ xem cách tạo tính năng nhúng cho một đoạn văn bản bằng phương thức embedText.

Để sử dụng phương thức embedText, hãy truyền tên mô hình cũng như một số văn bản cần nhúng. Bạn sẽ nhận được một danh sách các giá trị dấu phẩy động.

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