API PaLM: guida rapida sull'incorporamento con Java

Questa guida rapida ti aiuta a iniziare a utilizzare il servizio Embeddings dell'API PaLM. Utilizzerai il servizio di incorporamento per generare incorporamenti di testo da usare in varie applicazioni di linguaggio naturale.

Ottenere una chiave API

Per iniziare, devi ottenere una chiave API.

Che cosa sono gli incorporamenti?

Gli incorporamenti sono una tecnica utilizzata per rappresentare il testo (ad esempio parole, frasi o interi paragrafi) come elenco di numeri con rappresentazione in virgola mobile in un array. L'idea chiave è che il testo con significati simili avrà incorporamenti simili. Puoi utilizzare la relazione tra loro per molte attività importanti.

Installa il client API

Queste istruzioni installeranno l'SDK PaLM Java nel tuo repository Maven locale in modo che tu possa aggiungerlo come dipendenza al progetto Gradle.

1. Scarica il file google-cloud-ai-generativelanguage-v1-java.tar.gz.

2. Estrai i file e installali in 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. Apri il file di configurazione Gradle e assicurati che mavenLocal() sia elencato in repositories:

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

4. Inoltre, nel tuo file di configurazione Gradle, aggiungi le librerie necessarie al blocco 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")
   }
   

Inizializza il client di servizio di testo

Nel tuo programma Java, inizializza TextServiceClient passando la chiave API sotto forma di intestazione a TransportChannelProvider per l'utilizzo da parte di 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);

Genera incorporamenti

In questa sezione, scoprirai come generare incorporamenti per una porzione di testo utilizzando il metodo embedText.

Per utilizzare il metodo embedText, trasmetti il nome del modello e il testo da incorporare. Verrà visualizzato un elenco di valori in virgola mobile.

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