Crea y administra habilidades

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Puedes administrar y controlar de forma centralizada las habilidades independientes en Agent Registry. Para obtener más información, consulta Cómo registrar habilidades.

Para ver un ejemplo de cómo crear y administrar habilidades en Skill Registry, ejecuta el notebook “Intro to Skill Registry” en uno de los siguientes entornos:

Abrir en Colab | Abrir en Colab Enterprise | Abrir en Agent Platform Workbench | Ver en GitHub

En esta guía, se explica cómo crear, actualizar y administrar habilidades en el Registro de habilidades con la API de REST.

Antes de comenzar

Antes de usar Skill Registry, configura tu entorno:

Accede a tu cuenta de Google Cloud . Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Agent Platform API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Enable the API
Make sure that you have the following role or roles on the project: roles/aiplatform.viewer or roles/aiplatform.user, roles/serviceusage.serviceUsageConsumer
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Make sure that you have the following role or roles on the project: roles/aiplatform.viewer or roles/aiplatform.user, roles/serviceusage.serviceUsageConsumer

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

Nota: Para el acceso de solo lectura, el rol roles/aiplatform.viewer es suficiente. Skill Registry hereda los permisos a nivel del proyecto.

Cumplimiento

En la siguiente tabla, se resume el estado de cumplimiento:

Función	Estado
Transparencia de acceso	Admitido
Residencia de datos (DRZ) en EE.UU. y la UE	Admitido
Claves de encriptación administradas por el cliente (CMEK)	No es compatible
Certificación de HIPAA	No es compatible
VPC-SC	No es compatible

Regiones disponibles

El Registro de habilidades está disponible en las siguientes regiones:

Región	Ubicación
us-central1	Iowa
europe-west4	Países Bajos
us-east5	Columbus, Ohio

Crear una habilidad

Para crear una habilidad nueva, usa el método CreateSkill. Esta operación es una operación de larga duración.

Para ver ejemplos de la estructura esperada de la habilidad, consulta los archivos SKILL.md en el repositorio de Google Cloud Skills.

REST

En las siguientes secciones, se describe cómo usar la API de REST para crear una habilidad.

Prepara la carga útil

Antes de llamar a la API, empaqueta los archivos de tu skill en un archivo ZIP y codifícalo en una cadena Base64 de una sola línea. Para preparar la carga útil, sigue estos pasos:

Nota: La carga útil comprimida debe cumplir con requisitos específicos de tamaño y contenido para que la transferencia se realice correctamente. Para obtener más información, consulta Validación de la carga útil de la skill.

1. Navega al directorio de tu skill:

   cd <SKILL_DIRECTORY>
   

2. Crea el archivo ZIP y codifícalo en base64.

   Por ejemplo:

   zip -r skill.zip scripts/ references/ SKILL.md assets/ && base64 -w 0 -i skill.zip
   

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .

• LOCATION: Es la región de tu skill. Para obtener más información, consulta Regiones disponibles.

• SKILL_ID: El SKILL_ID es inmutable y permanece reservado de forma permanente una vez que se crea, incluso si borras la habilidad más adelante. Los IDs de skill deben cumplir con las siguientes restricciones:

  • Debe tener entre 1 y 63 caracteres.
  • Solo debe contener letras minúsculas, números y guiones.
  • Debe empezar con una letra y terminar con una letra o un número.
  • No debe comenzar con gcp- (este prefijo está reservado para las habilidades integradas).

Nota: Usa un SKILL_ID descriptivo. Dado que SKILL_ID se convierte en el nombre de la carpeta cuando la habilidad se vincula a un agente, un nombre significativo ayuda al modelo a comprender el propósito de la habilidad.

• DISPLAY_NAME: Es el nombre de la habilidad que se usa con el agente. El método RetrieveSkills usa el nombre visible y la descripción para buscar habilidades relevantes.

• DESCRIPTION: Es una descripción de lo que hace la skill.

• BASE64_ZIPPED_BODY: Es el contenido codificado en base64 de tu archivo comprimido de la skill.

Método HTTP y URL

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_ID

Cuerpo JSON de la solicitud

{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"zippedFilesystem": "BASE64_ZIPPED_BODY"
}

Comando curl

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "zippedFilesystem": "BASE64_ZIPPED_BODY"
    }' \
    "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_ID"

Python

Organiza los archivos de la skill (como SKILL.md, instrucciones y archivos de código) en un directorio local. El SDK admite el paso de una ruta de acceso a un directorio local (que se comprime automáticamente) o una ruta de acceso precomprimida.

Para la versión 1.154.0 y posteriores de google-cloud-aiplatform (que proporciona agentplatform):

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

skill = client.skills.create(
    skill_id="SKILL_ID",
    display_name="DISPLAY_NAME",
    description="DESCRIPTION",
    config={
        # Local directory path (automatically compressed) or pre-zipped path (.zip)
        "local_path": "SKILL_PATH",
    },
)
print(skill.name)

Para las versiones de google-cloud-aiplatform (que proporciona agentplatform) anteriores a 1.154.0, haz lo siguiente:

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

skill = client.skills.create(
    display_name="DISPLAY_NAME",
    description="DESCRIPTION",
    config={
        "skill_id": "SKILL_ID",
        # Local directory path (automatically compressed) or pre-zipped path (.zip)
        "local_path": "SKILL_PATH",
    },
)
print(skill.name)

Node.js

Organiza los archivos de la skill (como SKILL.md, instrucciones y archivos de código) en un directorio local. El SDK admite el paso de una ruta de acceso a un directorio local (que se comprime automáticamente) o una ruta de acceso precomprimida.

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const skill = await client.skills.create({
  skillId: 'SKILL_ID',
  displayName: 'DISPLAY_NAME',
  description: 'DESCRIPTION',
  config: {
    // Local directory path (automatically compressed) or pre-zipped path (.zip)
    localPath: 'SKILL_PATH',
  },
});
console.log(skill.name);

Actualiza una habilidad

Para actualizar una habilidad existente, usa el método UpdateSkill. Esta operación es una operación de larga duración.

Puedes actualizar el nombre visible, la descripción y la carga útil (sistema de archivos comprimido) de una habilidad existente. Solo se actualizan los campos que se enumeran en el parámetro de consulta updateMask.

REST

En las siguientes secciones, se describe cómo usar la API de REST para actualizar una skill.

Prepara la carga útil

Es opcional. Si vas a actualizar los archivos de la skill, empaquétalos en un archivo comprimido y codifícalos en una cadena base64 de una sola línea:

Nota: La carga útil comprimida debe cumplir con requisitos específicos de tamaño y contenido para que la transferencia se realice correctamente. Para obtener más información, consulta Validación de la carga útil de la skill.

1. Navega al directorio de tu skill:

   cd <SKILL_DIRECTORY>
   

2. Crea el archivo ZIP y codifícalo en Base64:

   zip -r skill.zip scripts/ references/ SKILL.md assets/ && base64 -w 0 -i skill.zip
   

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región de la skill. Para obtener más información, consulta Regiones disponibles.
• SKILL_ID: Es el ID de la habilidad que se actualizará.
• DISPLAY_NAME: Opcional Es un nombre nuevo para la habilidad.
• DESCRIPTION: Opcional Es una nueva descripción de lo que hace la habilidad.
• BASE64_ZIPPED_BODY: Opcional Contenido codificado en Base64 del archivo ZIP actualizado de tu skill.

Método HTTP y URL

PATCH https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID

Cuerpo JSON de la solicitud

{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"zippedFilesystem": "BASE64_ZIPPED_BODY"
}

Comando curl

El siguiente comando curl actualiza el nombre visible, la descripción y el archivo de skill comprimido.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "zippedFilesystem": "BASE64_ZIPPED_BODY"
    }' \
    "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,zippedFilesystem"

Python

El SDK admite la actualización de los archivos de habilidades pasando una ruta de acceso a un directorio local descomprimido o una ruta de acceso precomprimida.

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

skill = client.skills.update(
    name="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID",
    config={
        "display_name": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        # Optional. Local directory path (automatically compressed) or pre-zipped path (.zip)
        "local_path": "SKILL_PATH",
    },
)
print(skill.name)

Node.js

El SDK admite la actualización de los archivos de habilidades pasando una ruta de acceso a un directorio local descomprimido o una ruta de acceso precomprimida.

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const skill = await client.skills.update({
  name: 'projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID',
  config: {
    displayName: 'DISPLAY_NAME',
    description: 'DESCRIPTION',
    // Optional. Local directory path (automatically compressed) or pre-zipped path (.zip)
    localPath: 'SKILL_PATH',
  },
});
console.log(skill.name);

Mostrar habilidades

Para recuperar los metadatos de resumen de las habilidades en una ubicación específica (incluidos el nombre, el nombre visible y la descripción), usa el método ListSkills.

REST

En las siguientes secciones, se describe cómo usar la API de REST para enumerar habilidades.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región de las habilidades que deseas enumerar. Para obtener más información, consulta Regiones disponibles.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills"

Resultado de ejemplo

{
"name": "projects/1234567890/locations/us-central1/skills/3456789012",
"createTime": "2026-05-10T00:02:12.497720Z",
"updateTime": "2026-05-10T00:02:19.064874Z",
"displayName": "cymbal_skill",
"description": "A skill for managing Cymbal projects.",
"state": "ACTIVE"
}

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

pager = client.skills.list()
for skill in pager:
    print(skill.name, skill.display_name)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const pager = await client.skills.list();
for await (const skill of pager) {
  console.log(skill.name, skill.displayName);
}

Obtén una habilidad

Para recuperar los metadatos y la carga útil de la revisión más reciente de una skill, usa el método GetSkill.

REST

En las siguientes secciones, se describe cómo usar la API de REST para obtener una habilidad.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región en la que se encuentran las habilidades. Para obtener más información, consulta Regiones disponibles.
• SKILL_ID: Es el ID de la habilidad que se recuperará.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

skill = client.skills.get(
    name="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"
)
print(skill)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const skill = await client.skills.get({
  name: 'projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID',
});
console.log(skill);

Cómo borrar una habilidad

Para borrar una skill y todas sus revisiones, usa el método DeleteSkill. Esta operación es una operación de larga duración.

Nota: No puedes borrar las habilidades integradas cuyos IDs comiencen con gcp-.

Precaución: Cuando borras una habilidad, su SKILL_ID se reserva y no se puede volver a usar durante 24 horas.

REST

En las siguientes secciones, se describe cómo usar la API de REST para borrar una skill.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región en la que se encuentra la habilidad que deseas borrar. Para obtener más información, consulta Regiones disponibles.
• SKILL_ID: Es el ID de la skill que se borrará.

Método HTTP y URL

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID

Comando curl

curl -X DELETE \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

client.skills.delete(
    name="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"
)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

await client.skills.delete({
  name: 'projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID',
});

Enumera las revisiones de habilidades

Para recuperar el historial de revisiones de una habilidad específica, usa el método ListSkillRevisions.

REST

En las siguientes secciones, se describe cómo usar la API de REST para enumerar las revisiones de habilidades.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región en la que se encuentran las habilidades que deseas. Para obtener más información, consulta Regiones disponibles.
• SKILL_ID: ID de la habilidad.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions"

Resultado de ejemplo

{
  "skillRevisions": [
    {
      "name": "projects/1234567890/locations/us-central1/skills/cymbal_skill/revisions/4567890123",
      "createTime": "2026-05-10T00:02:12.497720Z",
      "updateTime": "2026-05-10T00:02:19.064874Z"
    }
  ]
}

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

response = client.skills.revisions.list(
    name="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"
)
for skill_revision in response.skill_revisions:
    print(skill_revision.name, skill_revision.create_time)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const response = await client.skills.revisions.list({
  name: 'projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID',
});
for (const revision of response.skillRevisions || []) {
  console.log(revision.name, revision.createTime);
}

Obtén una revisión de habilidades

Para recuperar una revisión específica de una skill, usa el método GetSkillRevision.

REST

En las siguientes secciones, se describe cómo usar la API de REST para obtener una revisión de habilidad.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región de la skill. Para obtener más información, consulta Regiones disponibles.
• SKILL_ID: ID de la habilidad.
• REVISION_ID: ID de la revisión específica que se recuperará. Se puede encontrar en el campo name que devuelve el método ListSkillRevisions. Por ejemplo, si name es projects/1234567890/locations/us-central1/skills/cymbal-skill/revisions/4567890123, el ID de revisión es 4567890123.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

revision = client.skills.revisions.get(
    name="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
)
print(revision)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const revision = await client.skills.revisions.get({
  name: 'projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID',
});
console.log(revision);

Cómo recuperar habilidades

Usa el método RetrieveSkills para encontrar habilidades con la búsqueda semántica. Por ejemplo, puedes buscar habilidades describiendo la tarea que deseas realizar, como find skills to manage cloud resources.

REST

En las siguientes secciones, se describe cómo usar la API de REST para recuperar habilidades.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región en la que se encuentran las habilidades que deseas buscar. Para obtener más información, consulta Regiones disponibles.
• QUERY: Es la cadena de consulta para encontrar habilidades coincidentes.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills:retrieve?query=QUERY

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/skills:retrieve?query=QUERY"

Python

import agentplatform

client = agentplatform.Client(project="PROJECT_ID", location="LOCATION")

response = client.skills.retrieve(
    query="QUERY",
    config={"top_k": TOP_K},
)
for retrieved_skill in response.retrieved_skills:
    print(retrieved_skill.skill_name, retrieved_skill.description)

Node.js

import { Client } from '@google-cloud/agentplatform';

const client = new Client({
  project: 'PROJECT_ID',
  location: 'LOCATION',
});

const response = await client.skills.retrieve({
  query: 'QUERY',
  config: {
    topK: TOP_K,
  },
});
for (const retrievedSkill of response.retrievedSkills || []) {
  console.log(retrievedSkill.skillName, retrievedSkill.description);
}

Obtén detalles de una operación de larga duración

Algunos métodos de la API de Skill Registry, como CreateSkill, UpdateSkill y DeleteSkill, son asíncronos y devuelven una operación de larga duración. Una operación de larga duración es un patrón de API que se usa para operaciones que pueden tardar una cantidad significativa de tiempo en completarse. En lugar de esperar a que finalice la operación, la API devuelve un recurso de operación.

La respuesta de estos métodos incluye un campo name, que contiene el ID de la operación. Por ejemplo, una name podría verse así: projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL_ID/operations/OPERATION_ID.

Para verificar el estado y obtener detalles de una operación de larga duración, usa el método GetOperation con el OPERATION_ID extraído.

REST

En las siguientes secciones, se describe cómo usar la API de REST para obtener una operación.

Variables de solicitud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION: Es la región en la que se ejecuta la operación. Debe coincidir con la región que usaste en tu solicitud inicial. Para obtener más información, consulta Regiones disponibles.
• OPERATION_ID: Es el ID de la operación. Extráelo del campo name que devuelven CreateSkill, UpdateSkill o DeleteSkill.

Método HTTP y URL

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Comando curl

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID"

¿Qué sigue?

Guía

Adjunta habilidades a un agente

Aprende a adjuntar habilidades registradas cuando crees o actualices un agente con la API de Agentes administrados en Agent Platform.

Guía

Integración del registro de habilidades del ADK

Obtén información para realizar la integración con Skill Registry en el ADK.