‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול סשנים באמצעות מסוף Google Cloud או קריאות ל-API

בקטע הזה מוסבר איך משתמשים ב-Agent Platform Sessions כדי לנהל סשנים באמצעות מסוף Google Cloud או קריאות ישירות ל-API. אם אתם לא רוצים להשתמש בסוכן ADK כדי לנהל סשנים, אתם יכולים להשתמש ב Google Cloud מסוף או בקריאות ישירות ל-API.

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

יצירת מופע של Agent Runtime

כדי לגשת לסשנים של Agent Platform, קודם צריך להשתמש במכונה של Agent Runtime. כדי להתחיל להשתמש בסשנים, לא צריך לפרוס קוד. אם השתמשתם ב-Agent Runtime בעבר, יצירת מופע של Agent Runtime נמשכת רק כמה שניות בלי פריסת קוד. אם זו הפעם הראשונה שאתם משתמשים ב-Agent Runtime, יכול להיות שזה ייקח יותר זמן.

אם אין לכם מכונה קיימת של Agent Runtime, אתם יכולים ליצור אחת באמצעות הקוד הבא:

import agentplatform

client = agentplatform.Client(
  project="PROJECT_ID",
  location="LOCATION"
)
# If you don't have an Agent Runtime instance already, create an instance.
remote_agent = client.runtimes.create()

# Optionally, print out the Agent Runtime resource name. You will need the
# resource name to interact with Sessions later on.
print(remote_agent.api_resource.name)

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שלכם. רשימת האזורים שבהם אפשר להשתמש ב-Sessions

הצגת רשימת סשנים

רשימת הסשנים שמשויכים למופע של Agent Runtime.

המסוף

בסוכנים פרוסים, אפשר להשתמש במסוף Google Cloud כדי להציג רשימה של הסשנים שמשויכים לסוכן:

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה סשנים. מוצגת רשימה של סשנים לפי מזהה.

Python

for session in client.sessions.list(
    name=remote_agent.api_resource.name,  # Required
):
    print(session)

# To list sessions for a specific user:
for session in client.sessions.list(
    name=remote_agent.api_resource.name,  # Required
    config={"filter": "user_id=USER_ID"},
):
    print(session)

‫USER_ID: בוחרים מזהה משתמש משלכם עם מגבלת תווים של 128. לדוגמה, user-123.

כברירת מחדל, client.sessions.list מחזיר סשנים שממוינים לפי זמן היצירה בסדר יורד (create_time desc). סדר ברירת המחדל הזה שומר על יציבות החלוקה לדפים כשסשנים פעילים מתעדכנים בו-זמנית. ב-Python SDK אין אפשרות order_by. כדי למיין לפי שדה אחר, צריך להשתמש ב-API בארכיטקטורת REST.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו יצרתם את המכונה של Agent Engine.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

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

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions" | Select-Object -Expand Content

אמורה להופיע רשימה של סשנים.

אם רוצים להציג רשימה של סשנים של משתמש ספציפי, אפשר להוסיף את פרמטר השאילתה ?filter=user_id=\"USER_ID\", כאשר USER_ID הוא המזהה של המשתמש שרוצים לשלוח לגביו שאילתה.

כדי למיין את הסשנים שמוחזרים, מוסיפים את פרמטר השאילתה ?orderBy=ORDER_BY, כאשר ORDER_BY הוא create_time,‏ update_time או display_name. אפשר להוסיף %20desc כדי למיין בסדר יורד, למשל ?orderBy=create_time%20desc. אם משמיטים את orderBy, ה-API מחזיר סשנים שממוינים לפי create_time desc. כדאי להשתמש ב-create_time desc כשמציגים סשנים בדפים במהלך עדכונים בו-זמניים, כדי שהעדכונים לא יעבירו סשנים בין דפים.

יצירת סשן

יוצרים סשן שמשויך למזהה משתמש.

המסוף

כדי ליצור סשנים לסוכנים שנפרסו, אתם יכולים להשתמש במסוף Google Cloud :

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה Playground.
לוחצים על סשן חדש כדי ליצור סשן חדש.

Python

session = client.sessions.create(
    name=remote_agent.api_resource.name,  # Required
    user_id=USER_ID, # Required
    session_id=SESSION_ID,
)

כאשר USER_ID הוא מזהה המשתמש שהגדרתם. לדוגמה, user-123.

ב-SESSION_ID, כדאי להביא בחשבון את ההגבלות הבאות כדי למנוע התנגשויות עם מזהים שנוצרו על ידי המערכת:

אם התו הראשון הוא אות, המזהה יכול להכיל עד 63 תווים. התווים החוקיים הם אותיות קטנות, מספרים ומקפים ([a-z0-9-]). התו האחרון חייב להיות אות או מספר.
אם התו הראשון הוא מספר, המזהה יכול להיות באורך של עד 9 תווים. התווים התקינים הם מספרים ([0-9]) ללא אפסים בתחילת המספר.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו יצרתם את המכונה של Agent Engine.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.
‫USER_ID: מזהה המשתמש שהגדרתם. לדוגמה, sessions-agent.
‫SESSION_ID: מזהה הסשן שהגדרתם. לדוגמה, my-custom-session.
כדי למנוע התנגשויות עם מזהים שנוצרו על ידי המערכת, צריך לפעול לפי ההגבלות הבאות כשמציינים מזהה סשן בהתאמה אישית:
- אם התו הראשון הוא אות, המזהה יכול להכיל עד 63 תווים. התווים החוקיים הם אותיות קטנות, מספרים ומקפים (`[a-z0-9-]`). התו האחרון חייב להיות אות או מספר.
- אם התו הראשון הוא מספר, המזהה יכול להיות באורך של עד 9 תווים. התווים החוקיים הם מספרים (`[0-9]`) ללא אפסים בתחילת המספר.
ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions
```
גוף בקשת JSON:
```
{
  "userId": USER_ID
}
```
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions"
PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions" | Select-Object -Expand Content
אתם אמורים לקבל פעולה ממושכת שאפשר לשלוח אליה שאילתה כדי לבדוק את סטטוס היצירה של הסשן.

הגדרת אורך החיים (TTL) של הסשן

לכל הסשנים צריך להיות זמן תפוגה. אתם יכולים להגדיר את זמן התפוגה הזה כשאתם יוצרים או מעדכנים סשן. הסשן והאירועים המשניים שלו נמחקים באופן אוטומטי אחרי שזמן התפוגה חולף. אפשר להגדיר את זמן התפוגה (expire_time) ישירות או להגדיר את משך החיים (ttl) בשניות. אם לא תציינו אף אחד מהם, המערכת תשתמש בערך ברירת המחדל של TTL, שהוא 365 ימים.

זמן חיים (TTL)

אם מגדירים את משך החיים, השרת מחשב את זמן התפוגה כ-create_time + ttl לסשנים חדשים שנוצרו או כ-update_time + ttl לסשנים מעודכנים.

client.sessions.create(
    name=remote_agent.api_resource.name,  # Required
    user_id=USER_ID, # Required
    config={
        # Session will be deleted 10 days after creation time.
        "ttl": f"{24 * 60 * 60 * 10}s"
    }
)

מועד התפוגה

import datetime

client.sessions.create(
    name=remote_agent.api_resource.name,  # Required
    user_id=USER_ID, # Required
    config={
        # Session will be deleted at the provided time (10 days after current time).
        "expire_time": datetime.datetime.now(tz=datetime.timezone.utc) + datetime.timedelta(seconds=24 * 60 * 60 * 10),
    }
)

איך מתחילים סשן

קבלת סשן ספציפי שמשויך למכונה של Agent Platform.

המסוף

כדי ליצור סשנים לסוכנים שנפרסו, אתם יכולים להשתמש במסוף Google Cloud :

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה Playground.
לוחצים על הכרטיסייה סשנים. מוצגת רשימה של סשנים לפי מזהה.
לוחצים על הסשן שרוצים לראות פרטים לגביו.

Python

session = client.sessions.get(
    name='projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID',  # Required
    user_id=USER_ID, # Required
)
# session.name will correspond to
#   'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID'

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו יצרתם את המכונה של Agent Engine.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.
‫SESSION_ID: מזהה המשאב של הסשן שרוצים לאחזר. אתם יכולים לקבל את מזהה הסשן מהתשובה שקיבלתם כשיצרתם את הסשן.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

מריצים את הפקודה הבאה:

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

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID" | Select-Object -Expand Content

בתשובה אמור להופיע מידע על הסשן.

איך מוחקים סשן

למחוק סשן שמשויך למכונה של Agent Platform.

המסוף

בסוכנים פרוסים, אתם יכולים להשתמש במסוף Google Cloud כדי למחוק סשנים שמשויכים לסוכן:

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה סשנים. מוצגת רשימה של סשנים לפי מזהה.
לוחצים על תפריט הפעולות הנוספות () של הסשן שרוצים למחוק.
לוחצים על Delete.
לוחצים על מחיקת הסשן.

Python

client.sessions.delete(name=session.name)

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו רוצים ליצור את המכונה של Example Store.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.
‫SESSION_ID: מזהה המשאב של הסשן שרוצים לאחזר.

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

הצגת רשימת אירועים בסשן

הצגת רשימה של אירועים בסשן שמשויך למכונה של Agent Platform.

המסוף

כדי ליצור סשנים לסוכנים שנפרסו, אתם יכולים להשתמש במסוף Google Cloud :

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה Playground.
לוחצים על הכרטיסייה סשנים. מוצגת רשימה של סשנים לפי מזהה.
לוחצים על הסשן שרוצים לראות פרטים לגביו.
לוחצים על הכרטיסייה אירועים כדי לראות את האירועים שמשויכים לסשן.

Python

for session_event in client.sessions.events.list(
    name=session.name,
):
    print(session_event)

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו יצרתם את המכונה של Agent Engine.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.
‫SESSION_ID: מזהה המשאב של הסשן שרוצים לאחזר.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID/events

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID/events"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions/SESSION_ID/events" | Select-Object -Expand Content

בתגובה אמורה להופיע רשימה של אירועים שמשויכים לסשן שלכם.

הוספת אירוע לסשן

הוספת אירוע לסשן שמשויך למכונה של Agent Platform.

המסוף

כדי ליצור סשנים לסוכנים שנפרסו, אתם יכולים להשתמש במסוף Google Cloud :

במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

מעבר אל Deployments

ברשימה מופיעים המופעים של Agent Engine ששייכים לפרויקט שנבחר. אפשר להשתמש בשדה Filter כדי לסנן את הרשימה לפי העמודה שציינתם.
לוחצים על השם של המכונה של Agent Engine.
לוחצים על הכרטיסייה Playground.
לוחצים על הכרטיסייה סשנים. מוצגת רשימה של סשנים לפי מזהה.
לוחצים על הסשן שרוצים לראות פרטים לגביו.
לוחצים על הכרטיסייה אירועים כדי לראות את האירועים שמשויכים לסשן.
כותבים הודעה ולוחצים על Enter כדי להוסיף אירוע חדש לסשן.

Python

import datetime

client.sessions.events.append(
    name=session.name,
    author="user",                                              # Required.
    invocation_id="1",                                          # Required.
    timestamp=datetime.datetime.now(tz=datetime.timezone.utc),  # Required.
    config={
        "content": {
            "role": "user",
            "parts": [{"text": "hello"}]
        },
    },
)

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

client.sessions.events.append(
    name=session.name,
    author="user",                                              # Required.
    invocation_id="1",                                          # Required.
    timestamp=datetime.datetime.now(tz=datetime.timezone.utc),  # Required.
    config={
        "raw_event": {
            "content": "hello",
            "custom_field": "custom_value"
        },
    },
)

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור שבו יצרתם את המכונה של Agent Engine.
‫AGENT_ENGINE_ID: מזהה המשאב של המכונה של Agent Engine.
‫USER_ID: מזהה המשתמש שהגדרתם. לדוגמה, sessions-agent.
‫SESSION_ID: מזהה הסשן שהגדרתם. לדוגמה, my-custom-session.
כדי למנוע התנגשויות עם מזהים שנוצרו על ידי המערכת, צריך לפעול לפי ההגבלות הבאות כשמציינים מזהה סשן בהתאמה אישית:
- אם התו הראשון הוא אות, המזהה יכול להכיל עד 63 תווים. התווים החוקיים הם אותיות קטנות, מספרים ומקפים (`[a-z0-9-]`). התו האחרון חייב להיות אות או מספר.
- אם התו הראשון הוא מספר, המזהה יכול להיות באורך של עד 9 תווים. התווים החוקיים הם מספרים (`[0-9]`) ללא אפסים בתחילת המספר.
ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions
```
גוף בקשת JSON:
```
{
  "userId": USER_ID
}
```
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions"
PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/sessions" | Select-Object -Expand Content
אתם אמורים לקבל פעולה ממושכת שאפשר לשלוח אליה שאילתה כדי לבדוק את סטטוס היצירה של הסשן.

הסרת המשאבים

כדי לנקות את כל המשאבים שבהם השתמשתם בפרויקט, אתם יכולים למחוק את המכונה של Agent Platform יחד עם המשאבים הצאצאים שלה:

remote_agent.delete(force=True)

ניהול סשנים באמצעות מסוף Google Cloud או קריאות ל-API קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

יצירת מופע של Agent Runtime

הצגת רשימת סשנים

המסוף

Python

REST

curl

PowerShell

יצירת סשן

המסוף

Python

REST

curl

PowerShell

הגדרת אורך החיים (TTL) של הסשן

זמן חיים (TTL)

מועד התפוגה

איך מתחילים סשן

המסוף

Python

REST

curl

PowerShell

איך מוחקים סשן

המסוף

Python

REST

curl

PowerShell

הצגת רשימת אירועים בסשן

המסוף

Python

REST

curl

PowerShell

הוספת אירוע לסשן

המסוף

Python

REST

curl

PowerShell

הסרת המשאבים

ניהול סשנים באמצעות מסוף Google Cloud או קריאות ל-API