Crea y administra habilidades

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:

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en 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.
  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Gemini Enterprise 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

  5. Make sure that you have the following role or roles on the project: Agent Platform Viewer (roles/aiplatform.viewer) or Agent Platform User (roles/aiplatform.user), Service Usage Consumer (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.
  6. 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.

    Go to project selector

  7. Verify that billing is enabled for your Google Cloud project.

  8. Enable the Gemini Enterprise 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

  9. Make sure that you have the following role or roles on the project: Agent Platform Viewer (roles/aiplatform.viewer) or Agent Platform User (roles/aiplatform.user), Service Usage Consumer (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.

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 la HIPAA No es compatible
VPC-SC No es compatible

Regiones disponibles

Skill Registry 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 es una operación de larga duración.

Para ver ejemplos de la estructura de habilidades esperada, 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 tus archivos de 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:

  1. Navega al directorio de tu habilidad:

    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 habilidad. Para obtener más información, consulta Regiones disponibles.

  • SKILL_ID: El SKILL_ID es inmutable y permanece reservado de forma permanente una vez creado, incluso si borras la habilidad más adelante. Los IDs de habilidades 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).
  • 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 habilidad.

  • BASE64_ZIPPED_BODY: Es el contenido codificado en Base64 de tu archivo ZIP de habilidades.

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 habilidades (como SKILL.md, instrucciones y archivos de código) en un directorio local. El SDK admite pasar una ruta de acceso de directorio local (que se comprime automáticamente) o una ruta de acceso con compresión previa.

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

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:

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 habilidades (como SKILL.md, instrucciones y archivos de código) en un directorio local. El SDK admite pasar una ruta de acceso de directorio local (que se comprime automáticamente) o una ruta de acceso con compresión previa.

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 indican en el parámetro de consulta updateMask.

REST

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

Prepara la carga útil

Es opcional. Si actualizas los archivos de la habilidad, empaqueta los archivos de la habilidad actualizados en un archivo ZIP y codifícalo en una cadena base64 de una sola línea:

  1. Navega al directorio de tu habilidad:

    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 habilidad. Para obtener más información, consulta Regiones disponibles.
  • SKILL_ID: Es el ID de la habilidad que se actualizará.
  • DISPLAY_NAME: Opcional Un nombre nuevo para la habilidad.
  • DESCRIPTION: Opcional Una descripción nueva de lo que hace la habilidad
  • BASE64_ZIPPED_BODY: Opcional Es el contenido codificado en Base64 de tu archivo ZIP de habilidad actualizado.

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 habilidad 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 directorio local descomprimida o una ruta 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 directorio local descomprimida o una ruta 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 las 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);
}

Obtener una habilidad

Para recuperar los metadatos y la carga útil de la revisión más reciente de una habilidad, 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 habilidad y todas sus revisiones, usa el método DeleteSkill. Esta es una operación de larga duración.

REST

En las siguientes secciones, se describe cómo usar la API de REST para borrar 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 encuentra la habilidad que quieres borrar. Para obtener más información, consulta Regiones disponibles.
  • SKILL_ID: Es el ID de la habilidad 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: Es el 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 habilidad, 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 habilidad. Para obtener más información, consulta Regiones disponibles.
  • SKILL_ID: Es el ID de la habilidad.
  • REVISION_ID: Es el ID de la revisión específica que se recuperará. Este se puede encontrar en el campo name que devuelve el método ListSkillRevisions. Por ejemplo, si el 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);

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 quieres 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 que coincidan.

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 de tiempo significativa 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, un name podría verse de la siguiente manera: 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. Extrae esto 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

Aprende a adjuntar habilidades registradas cuando creas o actualizas un agente con la API de Managed Agents en Agent Platform.

Guía

Aprende a integrarte con el registro de habilidades en el ADK.