יצירה וניהול של מיומנויות

במדריך הזה מוסבר איך ליצור, לעדכן ולנהל מיומנויות במאגר המיומנויות באמצעות REST API.

לפני שמתחילים

לפני שמשתמשים במאגר המיומנויות, צריך להגדיר את הסביבה:

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. 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

  4. 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 Cloud de Confiance 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 Cloud de Confiance 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 identifier for a user in a workforce identity pool. For details, see Represent workforce pool users in IAM policies, or contact your administrator.

    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.

תאימות

בטבלה הבאה מפורט סיכום של סטטוס התאימות:

תכונה סטטוס
Access Transparency נתמך
מיקום אחסון הנתונים (DRZ) בארה"ב ובאיחוד האירופי נתמך
מפתחות הצפנה בניהול הלקוח (CMEK) לא נתמך
אישור HIPAA לא נתמך
VPC-SC לא נתמך

אזורים שבהם השירות זמין

מאגר הכישורים זמין באזורים הבאים:

אזור מיקום
us-central1 איווה
europe-west4 הולנד
us-east5 קולומבוס, אוהיו

יצירת מיומנות

כדי ליצור סקיל חדש, משתמשים בשיטה CreateSkill. הפעולה הזו היא פעולה ממושכת.

דוגמאות למבנה המיומנויות הצפוי מופיעות בקובצי SKILL.md במאגר המיומנויות של Google Cloud.

REST

בקטעים הבאים מוסבר איך להשתמש ב-API בארכיטקטורת REST כדי ליצור סקיל.

הכנת המטען הייעודי (payload)

לפני שמפעילים את ה-API, צריך לארוז את קובצי המיומנות בארכיון ZIP ולקודד אותו למחרוזת base64 בשורה אחת. כדי להכין את מטען הייעודי (payload), פועלים לפי השלבים הבאים:

  1. עוברים לספריית הסקילים:

    cd <SKILL_DIRECTORY>

  2. יוצרים את קובץ ה-ZIP ומקודדים אותו ל-base64.

    לדוגמה:

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

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .

  • ‫LOCATION: האזור של ה-Skill. מידע נוסף זמין במאמר אזורים זמינים.

  • ‫SKILL_ID: אי אפשר לשנות את SKILL_ID אחרי שהוא נוצר, והוא נשאר שמור באופן קבוע גם אם מוחקים את הסקיל בהמשך. מזהי הסקילים צריכים לעמוד במגבלות הבאות:

    • השם צריך להיות באורך של 1 עד 63 תווים.
    • השם חייב להכיל רק אותיות קטנות, מספרים ומקפים.
    • השם חייב להתחיל באות ולהסתיים באות או במספר.
    • השם לא יכול להתחיל ב-gcp- (הקידומת הזו שמורה לסקילים מובנים).

  • ‫DISPLAY_NAME: השם של המיומנות שמשמשת את הסוכן. השיטה RetrieveSkills משתמשת בשם המוצג ובתיאור כדי לחפש מיומנויות רלוונטיות.

  • DESCRIPTION: תיאור של מה שהסקיל עושה.

  • ‫BASE64_ZIPPED_BODY: התוכן בקידוד base64 של ארכיון המיומנות (skill) הדחוס.

שיטת ה-HTTP וכתובת ה-URL

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

תוכן בקשת JSON

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

פקודה אחת (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

ארגון קבצי מיומנויות (כמו SKILL.md, הוראות וקבצי קוד) בספרייה מקומית. ה-SDK תומך בהעברת נתיב של ספרייה מקומית (שנדחסת אוטומטית) או נתיב של קובץ ZIP.

ל-google-cloud-aiplatform (שמספק את agentplatform) בגרסה 1.154.0 ואילך:

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)

בגרסאות של google-cloud-aiplatform (שמספק agentplatform) שקודמות לגרסה 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

ארגון קבצי מיומנויות (כמו SKILL.md, הוראות וקבצי קוד) בספרייה מקומית. ה-SDK תומך בהעברת נתיב של ספרייה מקומית (שנדחסת אוטומטית) או נתיב של קובץ ZIP.

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

עדכון סקיל

כדי לעדכן מיומנות קיימת, משתמשים בשיטה UpdateSkill. הפעולה הזו היא פעולה ממושכת.

אתם יכולים לעדכן את השם המוצג, התיאור והמטען הייעודי (מערכת קבצים דחוסה) של מיומנות קיימת. רק השדות שמפורטים בפרמטר השאילתה updateMask מתעדכנים.

REST

בקטעים הבאים מוסבר איך משתמשים ב-API בארכיטקטורת REST כדי לעדכן סקיל.

הכנת המטען הייעודי (payload)

זה שינוי אופציונלי. אם אתם מעדכנים את קובצי המיומנות, אתם צריכים לארוז את קובצי המיומנות המעודכנים בארכיון ZIP ולקודד אותו למחרוזת base64 בשורה אחת:

  1. עוברים לספריית הסקילים:

    cd <SKILL_DIRECTORY>

  2. יוצרים את ארכיון ה-ZIP ומקודדים אותו ל-base64:

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

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור של המיומנות. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫SKILL_ID: המזהה של הסקיל שרוצים לעדכן.
  • ‫DISPLAY_NAME: אופציונלי. שם חדש למיומנות.
  • ‫DESCRIPTION: אופציונלי. תיאור חדש של מה שהסקיל עושה.
  • ‫BASE64_ZIPPED_BODY: אופציונלי. התוכן בקידוד Base64 של ארכיון הסקיל המעודכן שלכם בפורמט zip.

שיטת ה-HTTP וכתובת ה-URL

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

תוכן בקשת JSON

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

פקודה אחת (curl)

הפקודה curl הבאה מעדכנת את השם המוצג, התיאור ואת קובץ הסקיל הדחוס.

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

ה-SDK תומך בעדכון קובצי הסקיל באמצעות העברה של נתיב של ספרייה מקומית לא מכווצת או נתיב מכווץ מראש.

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

ה-SDK תומך בעדכון קובצי הסקיל באמצעות העברה של נתיב של ספרייה מקומית לא מכווצת או נתיב מכווץ מראש.

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

פירוט של רשימת המיומנויות

כדי לאחזר מטא-נתונים של סיכום לגבי מיומנויות במיקום ספציפי (כולל השם, השם המוצג והתיאור), משתמשים בשיטה ListSkills.

REST

בקטעים הבאים מוסבר איך משתמשים ב-API בארכיטקטורת REST כדי להציג רשימה של מיומנויות.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור של הכישורים שרוצים להציג. מידע נוסף זמין במאמר אזורים זמינים.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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"

פלט לדוגמה

{
"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);
}

הוספת סקיל

כדי לאחזר את המטא-נתונים ואת מטען הייעודי (payload) של הגרסה האחרונה של סקיל, משתמשים בשיטה GetSkill.

REST

בקטעים הבאים מוסבר איך להשתמש ב-API בארכיטקטורת REST כדי לקבל סקיל.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור שבו נמצאות המיומנויות. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫SKILL_ID: המזהה של הסקיל שרוצים לאחזר.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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);

מחיקת סקיל

כדי למחוק מיומנות ואת כל הגרסאות שלה, משתמשים בשיטה DeleteSkill. הפעולה הזו היא פעולה ממושכת.

REST

בקטעים הבאים מוסבר איך להשתמש ב-API בארכיטקטורת REST כדי למחוק סקיל.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור שבו נמצא הסקיל שרוצים למחוק. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫SKILL_ID: המזהה של המיומנות שרוצים למחוק.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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',
});

רשימת הגרסאות של הסקיל

כדי לאחזר את היסטוריית גרסאות של מיומנות ספציפית, משתמשים ב-method‏ ListSkillRevisions.

REST

בקטעים הבאים מוסבר איך משתמשים ב-API בארכיטקטורת REST כדי להציג רשימה של גרסאות סקיל.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור שבו נמצאות המיומנויות שרוצים. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫SKILL_ID: המזהה של המיומנות.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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"

פלט לדוגמה

{
  "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);
}

קבלת גרסה של סקיל

כדי לאחזר גרסה ספציפית של מיומנות, משתמשים בשיטה GetSkillRevision.

REST

בקטעים הבאים מוסבר איך להשתמש ב-API בארכיטקטורת REST כדי לקבל גרסה של סקיל.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור של המיומנות. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫SKILL_ID: המזהה של המיומנות.
  • ‫REVISION_ID: המזהה של הגרסה הספציפית שרוצים לאחזר. אפשר למצוא אותו בשדה name שמוחזר על ידי השיטה ListSkillRevisions. לדוגמה, אם name הוא projects/1234567890/locations/us-central1/skills/cymbal-skill/revisions/4567890123, מזהה הגרסה הוא 4567890123.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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);

אחזור סקילים

אפשר להשתמש בשיטה RetrieveSkills כדי למצוא מיומנויות באמצעות חיפוש סמנטי. לדוגמה, אפשר לחפש מיומנויות על ידי תיאור המשימה שרוצים לבצע, כמו find skills to manage cloud resources.

REST

בקטעים הבאים מוסבר איך משתמשים ב-API בארכיטקטורת REST כדי לאחזר מיומנויות.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור שבו נמצאות המיומנויות שרוצים לחפש. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫QUERY: מחרוזת השאילתה לחיפוש כישורים תואמים.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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);
}

קבלת פרטים על פעולה ממושכת

חלק מהשיטות ב-Skill Registry API, כמו CreateSkill,‏ UpdateSkill ו-DeleteSkill, הן אסינכרוניות ומחזירות פעולה ממושכת. פעולה ממושכת היא תבנית API שמשמשת לפעולות שיכולות להימשך זמן רב. במקום לחכות שהפעולה תסתיים, ה-API מחזיר משאב פעולה.

התשובה מהשיטות האלה כוללת את השדה name, שמכיל את מזהה הפעולה. לדוגמה, name יכול להיראות כך: projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL_ID/operations/OPERATION_ID.

כדי לבדוק את הסטטוס ולקבל פרטים על פעולה ממושכת, משתמשים ב-method‏ GetOperation עם ה-OPERATION_ID שחולץ.

REST

בקטעים הבאים מוסבר איך להשתמש ב-API בארכיטקטורת REST כדי לקבל פעולה.

בקשת משתנים

לפני שמשתמשים בנתוני הבקשה, מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
  • ‫LOCATION: האזור שבו הפעולה מתבצעת. האזור הזה צריך להיות זהה לאזור שצוין בבקשה הראשונית. מידע נוסף זמין במאמר אזורים זמינים.
  • ‫OPERATION_ID: מזהה הפעולה. אפשר לחלץ את הערך הזה מהשדה name שמוחזר על ידי CreateSkill, UpdateSkill או DeleteSkill.

שיטת ה-HTTP וכתובת ה-URL

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

פקודה אחת (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"

המאמרים הבאים

מדריך

במאמר הזה מוסבר איך לצרף סקילים רשומים כשיוצרים או מעדכנים סוכן באמצעות Managed Agents API ב-Agent Platform.

מדריך

איך משלבים עם Skill Registry ב-ADK