ניהול משוב באמצעות Python SDK או API בארכיטקטורת REST

בדף הזה מוסבר איך להשתמש ב-API וב-SDK של שירות המשוב כדי לנהל רשומות של משוב והקשר. אתם יכולים להטמיע אמצעי בקרה מותאמים אישית למשוב (כמו לחצני לייק או דיסלייק) בממשק משתמש כמו ווידג'טים של צ'אט או אפליקציות לנייד, ולהשתמש בשירות המשוב כדי לעקוב אחרי המשוב.

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

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

  • התפקיד Agent Platform User (roles/aiplatform.user).
  • מגדירים את האימות לפי השלבים במאמר בנושא אימות.
  • מופע של Agent Runtime שנפרס. אם אין לכם מופע פרוס, אפשר לעיין במאמר בנושא פריסת סוכן או לאתחל וליצור מופע על ידי ביצוע השלבים בקטע הבא.
  • אופציונלי: כדי לראות רשומות משוב לצד אירועי מעקב במסוף, צריך לוודא שמופעל מעקב במופע של Agent Runtime.

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

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

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

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

‫API בארכיטקטורת REST

הפורמט של שם משאב Agent Runtime הוא: projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID

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

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

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

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

לשם כך:

  1. יוצרים סשן אינטראקציה עם נציג.

  2. שולחים שאילתה לסוכן ומזהים את התשובה שרוצים לשלוח לגביה משוב.

  3. מעתיקים את מזהה הסשן ואת מזהה אירוע התגובה (שמשמש כמזהה האירוע של רשומת המשוב). אם אתם משתמשים בשירות הסשנים המנוהל עם ADK, אתם יכולים לקבל את מזהה האירוע מהשדה raw_event.id של התגובה של רשימת האירועים (ראו רשימת אירועים בסשן).

רישום ביומן של רשומה של משוב באופן פרוגרמטי, שקשורה ישירות ליעד session_id ולevent_id הגדרה של אירוע שיחה של סוכן משתמש.

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

operation = client.feedback_entries.create(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID",
    session_id="SESSION_ID",
    event_id="EVENT_ID",
    feedback_type="THUMBS_UP",
    config={
        "feedback_text": "The response was helpful and accurate.",
        "feedback_labels": ["accurate"],
        "user_id": "user-123",
        "source": "Chat UI",
        "custom_metadata": {"model_temperature": "0.7"},
    }
)

# Retrieve the created feedback entry details
feedback_entry = operation.response
print(f"Created feedback entry: {feedback_entry.name}")

הערכים הנתמכים של feedback_type הם:

  • "THUMBS_UP"
  • "THUMBS_DOWN"
  • "FEEDBACK_TYPE_UNSPECIFIED"

‫API בארכיטקטורת REST

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

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

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

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries

גוף בקשת JSON:

{
  "sessionId": "SESSION_ID",
  "eventId": "EVENT_ID",
  "feedbackType": "THUMBS_DOWN",
  "feedbackLabels": ["inaccurate"],
  "feedbackText": "The answer was incorrect.",
  "userId": "user-123",
  "source": "Chat UI",
  "customMetadata": {
    "temperature": "0.7"
  }
}

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

curl

שומרים את גוף הבקשה בקובץ בשם 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/feedbackEntries"

PowerShell

שומרים את גוף הבקשה בקובץ בשם 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/feedbackEntries" | Select-Object -Expand Content

מתקבלת פעולה ממושכת שמציינת את הסטטוס של יצירת רשומת המשוב.

שליפת רשומת משוב

אפשר לאחזר את מטען הייעודי המלא והמובנה של רשומת משוב מבודדת באמצעות כתובת המשאב הייחודית שלה.

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

feedback_entry = client.feedback_entries.get(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID"
)

print(f"Feedback Type: {feedback_entry.feedback_type}")
print(f"Feedback Text: {feedback_entry.feedback_text}")

‫API בארכיטקטורת REST

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

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

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

GET https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_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/feedbackEntries/FEEDBACK_ENTRY_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/feedbackEntries/FEEDBACK_ENTRY_ID" | Select-Object -Expand Content

התגובה כוללת את פרטי רשומת המשוב, כמו מזהה הסשן, הסוג, התוויות והטקסט.

רשימת רשומות משוב

מציגים רשימה של רשומות משוב במופע של Agent Runtime. אפשר להחיל מסננים ומאפייני סדר.

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

response = client.feedback_entries.list(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID",
    config={
        "filter": 'session_id="SESSION_ID"',
        "order_by": "create_time desc"
    }
)

for entry in response:
    print(f"Entry name: {entry.name}, Type: {entry.feedback_type}")

‫API בארכיטקטורת 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/feedbackEntries

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

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/feedbackEntries"

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/feedbackEntries" | Select-Object -Expand Content

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

אפשר להשתמש בפרמטר השאילתה filter כדי לבצע שאילתה לפי מאפיינים ספציפיים. כדי למיין, משתמשים בפרמטר order_by של השאילתה.

שדות נתמכים לסינון:

  • session_id, כמו session_id="SESSION_ID"
  • user_id, כמו user_id="YOUR_USER_ID"
  • feedback_type, כמו feedback_type="THUMBS_DOWN"
  • feedback_labels, כמו feedback_labels: "inaccurate"
  • create_time
  • update_time

שדות נתמכים למיון:

  • create_time
  • update_time

עדכון רשומה של משוב

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

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

operation = client.feedback_entries.update(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID",
    feedback_type="THUMBS_DOWN",
    config={
        "feedback_text": "Actually, this response was not accurate.",
        "feedback_labels": ["inaccurate"],
    }
)

updated_entry = operation.response
print(f"Updated entry: {updated_entry.name}")

‫API בארכיטקטורת REST

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

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

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

PATCH https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID?updateMask=feedbackType,feedbackLabels,feedbackText

גוף בקשת JSON:

{
  "feedbackType": "THUMBS_DOWN",
  "feedbackLabels": ["inaccurate", "incomplete"],
  "feedbackText": "The response was details-lacking and inaccurate."
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
-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/feedbackEntries/FEEDBACK_ENTRY_ID?updateMask=feedbackType,feedbackLabels,feedbackText"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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

Invoke-WebRequest `
-Method PATCH `
-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/feedbackEntries/FEEDBACK_ENTRY_ID?updateMask=feedbackType,feedbackLabels,feedbackText" | Select-Object -Expand Content

מתקבלת פעולה ממושכת שמציינת את ההתקדמות של פעולת העדכון.

מחיקת רשומה של משוב

מחיקה סופית של רשומת משוב מהפרויקט.

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

client.feedback_entries.delete(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID"
)

print("Feedback entry deleted.")

‫API בארכיטקטורת REST

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

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

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

DELETE https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_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/feedbackEntries/FEEDBACK_ENTRY_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/feedbackEntries/FEEDBACK_ENTRY_ID" | Select-Object -Expand Content

תקבלו פעולה ממושכת שתציג את סטטוס המחיקה.

הקשר של המשוב

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

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

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

למשאב FeedbackContext יש את המבנה הבא:

projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext

אחזור הקשר של המשוב

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

Python SDK

import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

feedback_context = client.feedback_entries.feedback_contexts.get(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext"
)

# Point to event list
for event in feedback_context.context_events:
    print(f"Author: {event.author}")
    if event.content and event.content.parts:
        print(f"Content: {event.content.parts[0].text}")

‫API בארכיטקטורת REST

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

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

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

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

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

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/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext"

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/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext" | Select-Object -Expand Content

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

יצירה ועדכון של הקשר למשוב

Python SDK

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

  1. יצירת רשומת המשוב: קוראים לשיטות סטנדרטיות כדי ליצור את רשומת המשוב הראשית.
  2. עדכון ההקשר של המשוב: אחרי שמקבלים את מזהה רשומת המשוב, שולחים בקשה לאכלוס אירועי ההקשר.
import os
import agentplatform

# Set this environment variable to enable the Enterprise features.
os.environ["GOOGLE_GENAI_USE_ENTERPRISE"] = "TRUE"

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

# Construct conversation events
session_event = {
    "author": "user",
    "content": {
        "role": "user",
        "parts": [{"text": "Hello Agent"}]
    }
}

operation = client.feedback_entries.feedback_contexts.update(
    name="projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID",
    context_events=[session_event]
)

updated_context = operation.response
print("Feedback context updated successfully.")

‫API בארכיטקטורת REST

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

  1. יצירת רשומת המשוב: קוראים לפונקציה CreateFeedbackEntry כדי ליצור את רשומת המשוב הראשית.
  2. מעדכנים את ההקשר של המשוב: אחרי שמקבלים את מזהה רשומת המשוב, שולחים בקשת PATCH למשאב הצאצא של ההקשר (UpdateFeedbackContext) כדי לאכלס את contextEvents.

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

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

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

PATCH https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext?updateMask=contextEvents

גוף בקשת JSON:

{
  "contextEvents": [
    {
      "author": "user",
      "content": {
        "role": "user",
        "parts": [
          {
            "text": "What is the capital of France?"
          }
        ]
      }
    },
    {
      "author": "agent",
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Paris is the capital of France."
          }
        ]
      }
    }
  ]
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
-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/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext?updateMask=contextEvents"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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

Invoke-WebRequest `
-Method PATCH `
-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/feedbackEntries/FEEDBACK_ENTRY_ID/feedbackContext?updateMask=contextEvents" | Select-Object -Expand Content

מתקבלת פעולה ממושכת שמציגה את התקדמות העדכון של הקשר של המשוב.

כדי להסיר את ההקשר של המשוב, שולחים עדכון ריק (לדוגמה, עם context_events שמוגדר כרשימה ריקה).