API de PaLM: Guía de inicio rápido sobre incorporaciones con Java

Con esta guía de inicio rápido, aprenderás a usar el servicio de incorporaciones de la API de PaLM. Usarás el servicio de incorporaciones para generar incorporaciones de texto que puedes usar en varias aplicaciones de lenguaje natural.

Obtén una clave de API

Para comenzar, deberás obtener una clave de API.

¿Qué son las incorporaciones?

Las incorporaciones son una técnica que se usa para representar texto (como palabras, oraciones o párrafos enteros) como una lista de números de punto flotante en un array. La idea clave es que el texto con significados similares tendrá incorporaciones similares. Puedes usar la relación entre ellos para muchas tareas importantes.

Instala el cliente de la API

Con estas instrucciones, se instalará el SDK de PaLM para Java en tu repositorio local de Maven para que puedas agregarlo como una dependencia a tu proyecto de Gradle.

1. Descarga el archivo google-cloud-ai-generativelanguage-v1-java.tar.gz.

2. Extrae los archivos y, luego, instálalos en 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. Abre tu archivo de configuración de Gradle y asegúrate de que mavenLocal() aparezca en repositories:

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

4. Además, en el archivo de configuración de Gradle, agrega las bibliotecas necesarias al bloque 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")
   }
   

Inicializa el cliente de servicio de texto

En tu programa Java, inicializa un TextServiceClient. Para ello, pasa tu clave de API como un encabezado a TransportChannelProvider que usará 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 incorporaciones

En esta sección, aprenderás a generar incorporaciones para un texto con el método embedText.

Para usar el método embedText, pasa el nombre del modelo y el texto para incorporar. Obtendrás una lista de valores de punto flotante.

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