שילוב של Vertex AI עם Google SecOps

במאמר הזה מוסבר איך לשלב את Vertex AI עם Google Security Operations.

תרחישים לדוגמה

השילוב של Vertex AI תומך בתרחישים הבאים:

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

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

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

  • טרנספורמציה של נתונים בהתאמה אישית: אוטומציה של טרנספורמציות פרוגרמטיות של מבני נתונים שרירותיים ב-JSON באמצעות הוראות בשפה טבעית.

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

לפני שמגדירים את השילוב של Vertex AI ב-Google SecOps, צריך לבצע את השלבים הבאים:

  1. יוצרים חשבון שירות.

  2. מקצים לחשבון השירות את התפקידים הנדרשים בניהול זהויות והרשאות גישה (IAM).

  3. בוחרים אחת משיטות האימות הבאות ומגדירים אותה:

    • אפשרות 1: Workload Identity (מומלץ): בשיטה הזו משתמשים באסימונים לטווח קצר באמצעות התחזות לחשבון שירות.

    • אפשרות 2: מפתח JSON של חשבון שירות: השיטה הזו מסתמכת על קובץ מפתח סודי סטטי לטווח ארוך.

למידע מפורט על חיובי השירות, קראו את המאמר תמחור ב-Vertex AI.

יצירה של חשבון שירות

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Service Accounts.

    לדף Service accounts

  2. לוחצים על addCreate service account.

  3. מזינים שם ותיאור ולוחצים על סיום. שימו לב לכתובת האימייל של חשבון השירות.

מתן תפקידים ב-IAM

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

  1. במסוף Google Cloud , נכנסים לדף IAM.

    כניסה לדף IAM

  2. מוצאים את חשבון השירות ולוחצים על Edit principal (עריכת חשבון משתמש).

  3. לוחצים על Add another role ובוחרים את התפקיד Vertex AI User (roles/aiplatform.user).

  4. לוחצים על Save.

הגדרת פרטי הכניסה של Workload Identity

הגישה המומלצת היא Workload Identity, כי היא משתמשת באסימוני גישה לטווח קצר באמצעות התחזות לחשבון שירות.

זיהוי המופע הייחודי של הזהות

כדי ליצור חיבור, צריך לתת למכונה של Google SecOps הרשאה להתחזות לחשבון השירות.

  1. ב-Google SecOps, עוברים אל Content Hub > Response Integrations.

  2. בוחרים את השילוב של Vertex AI ומזינים את כתובת האימייל של חשבון השירות בשדה Workload Identity Email.

  3. לוחצים על שמירה > בדיקה. הבדיקה צפויה להיכשל.

  4. לוחצים על close_small ליד הלחצן Test ומחפשים את כתובת האימייל של הזהות שמתחילה ב-gke-init-python@... או ב-soar-python@....

  5. מעתיקים את כתובת האימייל הייחודית הזו.

אישור זהות המכונה ב- Google Cloud

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Service Accounts.

    לדף Service accounts

  2. בוחרים את חשבון השירות הרצוי ועוברים אל Permissions > Grant Access.

  3. מדביקים את כתובת האימייל הייחודית בשדה New principals ומקצים את התפקיד Service Account Token Creator‏ (roles/iam.serviceAccountTokenCreator).

הגדרת מפתח JSON

קבצים סטטיים של מפתחות סודיים לטווח ארוך דורשים רוטציה ידנית. השתמשו בשיטה הזו רק אם האימות של Workload Identity לא זמין.

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Service Accounts ובוחרים את חשבון השירות.

    לדף Service accounts

  2. עוברים לכרטיסייה Keys ולוחצים על Add key > Create new key.

  3. בוחרים באפשרות JSON ולוחצים על Create. הדפדפן מוריד את קובץ ה-JSON למחשב.

פרמטרים של שילוב

כדי לשלב את Vertex AI, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
API Root

חובה.

שורש ה-API של המכונה ב-Vertex AI.

ערך ברירת המחדל הוא https://LOCATION-aiplatform.googleapis.com.

Workload Identity Email

זה שינוי אופציונלי.

כתובת האימייל של הלקוח בחשבון השירות.

צריך להגדיר את הפרמטר הזה רק אם מבצעים אימות באמצעות Workload Identity. אם המדיניות מוגדרת, המערכת מתעלמת מהמדיניות Service Account JSON File Content.

Service Account JSON File Content

זה שינוי אופציונלי.

התוכן המלא של קובץ ה-JSON של מַפְתח חשבון השירות.

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

Project ID

זה שינוי אופציונלי.

מזהה הפרויקט לטירגוט ב-Pub/Sub.

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

Default Model

זה שינוי אופציונלי.

שם המודל שמוגדר כברירת מחדל לטירגוט.

ערך ברירת המחדל הוא gemini-1.5-flash-002.

Location

זה שינוי אופציונלי.

מזהה המיקום של Vertex AI API.

אם לא מציינים ערך, השילוב מחלץ את מזהה המיקום מהשורש של ה-API.

Verify SSL

חובה.

מאמת את אישור ה-SSL של החיבור לשרת. מופעלת כברירת מחדל.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

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

ניתוח EML

משתמשים בפעולה ניתוח EML כדי לנתח קובצי EML באמצעות Vertex AI. הפעולה הזו שולחת כל קובץ בנפרד.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה Analyze EML דורשת את הפרמטרים הבאים:

פרמטר תיאור
Model ID אופציונלי

מזהה המודל שבו רוצים להשתמש, למשל gemini-1.5-flash-002.

Temperature אופציונלי

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

למידע נוסף על ערכי הטמפרטורה, ראו ניסוי עם ערכי הפרמטרים.

Files To Analyze חובה

רשימה מופרדת בפסיקים של קובצי EML שרוצים לשלוח לניתוח.

Max Output Tokens אופציונלי

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

טוקן הוא בערך ארבעה תווים. ‫100 אסימונים שווים בערך ל-60-80 מילים. המגבלה הזו חלה על כל ישות בנפרד.

מידע נוסף זמין במאמר ניסוי עם ערכי פרמטרים.

ערך ברירת המחדל הוא 100.

ערכי פלט של פעולות

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

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

הדוגמה הבאה מראה את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה ניתוח EML:

[{
   "Entity": "file",
   "EntityResult": {
       "raw": "{\"threat_level\": \"High\", \"threats_found\": [{\"threat\": \"Phishing Links\", \"explanation\": \"Multiple links point",
       "extracted_info": {
           "threat_level": "High",
           "threats_found": [
               {
                   "threat": "Phishing Links",
                   "explanation": "Multiple links point to example.com, a suspicious domain likely used for phishing campaigns.",
                   "example": "URL"
               },
               {
                   "threat": "Social Engineering",
                   "explanation": "The email uses urgency and scarcity tactics, pressuring the recipient to click links quickly.",
                   "example": "Register Now and Save $1,000 on all 2-Day Project Management (Fundamentals)"
               },
               {
                   "threat": "Suspicious Domain",
                   "explanation": "The email uses the domain example.com', which is not commonly associated with legitimate businesses or organizations and may be a newly registered domain for malicious purposes. This should be checked for validity and legitimacy. The email also uses the domain pdu-xl.com which may also be suspicious.",
                   "example": "example.com"
               }
           ],
           "verification_steps": [
               "Check the domain reputation of example.com using online tools like VirusTotal or URLVoid.",
               "Analyze email headers to identify the true sender's IP address and location using email analysis tools.",
               "Verify the legitimacy of mentioned products or services by independently contacting the companies mentioned."
           ],
           "protection_measures": [
               "Avoid clicking links in suspicious emails. Hover over links to check the actual URL in a separate tool.",
               "Enable email filtering and anti-phishing features in your email client.",
               "Regularly update your antivirus and anti-malware software.",
               "Educate users about social engineering tactics and phishing schemes."
           ]
       },
       "usageMetadata": {
           "promptTokenCount": 12,
           "candidatesTokenCount": 778,
           "totalTokenCount": 790
       }
   }
}]
הודעות פלט

הפעולה ניתוח EML יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully analysed the following EML files using Vertex AI: FILE_PATHS הפעולה בוצעה בהצלחה.
Error executing action "Analyze EML". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

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

שם תוצאת הסקריפט ערך
is_success True או False

תיאור הישות

הפעולה Describe Entity משמשת לסיכום מידע על ישויות באמצעות Vertex AI.

הפעולה הזו פועלת על כל הישויות של Google SecOps ושולחת כל ישות בנפרד.

קלט של הפעולה

הפעולה Describe Entity דורשת את הפרמטרים הבאים:

פרמטר תיאור
Model ID אופציונלי

מזהה המודל שבו רוצים להשתמש, למשל gemini-1.5-flash-002.

Temperature אופציונלי

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

למידע נוסף על ערכי הטמפרטורה, ראו ניסוי עם ערכי הפרמטרים.

Exclude Fields אופציונלי

רשימה מופרדת בפסיקים של שדות המטא-נתונים של הישות ב-Google SecOps שרוצים להחריג במהלך יצירת סיכום הישות.

Force Refresh אופציונלי

אם האפשרות הזו נבחרת, הפעולה מתעלמת מהפרמטר Refresh After (Days) ומאימות ה-hash, ויוצרת מחדש את סיכום הישות בכל הפעלה של הפעולה.

האפשרות הזו לא מסומנת כברירת מחדל.

Refresh After (Days) חובה

מספר הימים שהפעולה צריכה להמתין לפני רענון סיכום הישות.

הפעולה יוצרת ערך גיבוב (hash) שמבוסס על כל הקלט שנשלח ל-Vertex AI, חוץ מהערכים של הפרמטר Fields To Ignore. אם ערך הגיבוב השתנה, הפעולה מרעננת את הסיכום אחרי מספר הימים שהוגדר. אם ערך ה-hash לא השתנה, הפעולה לא מרעננת את הסיכום גם אם ערך הפרמטר Refresh After (Days) מוקדם יותר מהמועד האחרון שבו נוצר הסיכום.

הפעולה מאמתת את ערך ה-hash של הסיכום האחרון שנוצר בפועל ומתעלמת מערך ה-hash שנשמר במטמון.

ערך ברירת המחדל הוא 30.

Max Output Tokens אופציונלי

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

טוקן הוא בערך ארבעה תווים. ‫100 אסימונים שווים בערך ל-60-80 מילים. המגבלה הזו חלה על כל ישות בנפרד.

מידע נוסף זמין במאמר ניסוי עם ערכי פרמטרים.

ערכי פלט של פעולות

הפעולה Describe Entity מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Describe Entity:

[
    {
        "Entity": "1B16D64CE18772B8F77C74C3D4DC24AA066BB117",
        "EntityResult": {
            "summary": "This is a suspicious, enriched, internal file hash (SHA1: 1B16D64CE18772B8F77C74C3D4DC24AA066BB117) identified as a Microsoft Excel 2007+ file (\"FC090000\") located on a user's desktop.  VirusTotal analysis shows 3 malicious flags out of 65 total engines.  The file contains macros, is potentially obfuscated, and exhibits behaviors like writing to files, running DLLs, and downloading content.  It was last modified on 2024-11-13 and created on 2021-07-07.  The file is linked to a single case (\"potential_apt_doc_files\") which was closed.  The file is flagged as an artifact but not vulnerable or a pivot point.\n",
            "usageMetadata": {
                "promptTokenCount": 12,
                "candidatesTokenCount": 778,
                "totalTokenCount": 790
            }
        }
    }
]
הודעות פלט

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

הודעת פלט תיאור ההודעה
Successfully summarized the entity based on the available information using Vertex AI. הפעולה בוצעה בהצלחה.
Error executing action "Describe Entity". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

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

שם תוצאת הסקריפט ערך
is_success True או False

הרצת הפרומפט

משתמשים בפעולה Execute Prompt כדי להריץ פרומפטים טקסטואליים נפרדים באמצעות Vertex AI.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

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

פרמטר תיאור
Model ID אופציונלי

מזהה המודל שבו רוצים להשתמש, למשל gemini-1.5-flash-002.

Text Prompt חובה

ההוראות בטקסט שצריך לכלול בהנחיה.

Temperature אופציונלי

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

למידע נוסף על ערכי הטמפרטורה, ראו ניסוי עם ערכי הפרמטרים.

Candidate Count אופציונלי

מספר הווריאציות של התשובות שיוחזרו בכל הפעלה של פעולה.

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

Response MIME Type אופציונלי

סוג המדיה (MIME) של התשובה שנוצרה.

סוג המדיה (MIME) של התשובה זמין במודלים הבאים: gemini-1.5-pro,‏ gemini-1.5-flash.

הערכים האפשריים הם:

  • application/json
  • text/plain
  • text/x.enum
ערך ברירת המחדל הוא text/plain.
Response Schema אופציונלי

הסכימה שלפיה ייווצר הטקסט של המועמד.

כדי להשתמש בפרמטר הזה, צריך להגדיר את הפרמטר Response MIME Type.

סכמת התשובה זמינה במודלים הבאים: gemini-1.5-pro,‏ gemini-1.5-flash.

Max Input Tokens אופציונלי

המספר המקסימלי של אסימוני קלט שאפשר לשלוח.

טוקן אחד מורכב מעד ארבעה תווים. ‫100 טוקנים יכולים להיות שווי ערך ל-60 עד 80 מילים.

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

Max Output Tokens אופציונלי

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

טוקן הוא בערך ארבעה תווים. ‫100 אסימונים שווים בערך ל-60-80 מילים. המגבלה הזו חלה על כל ישות בנפרד.

מידע נוסף זמין במאמר ניסוי עם ערכי פרמטרים.

ערכי פלט של פעולות

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

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Execute Prompt:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Responding to a malicious email requires a layered approach.  Here's a breakdown of remediation steps, prioritizing actions based on urgency:\n\n**Immediate Actions (within minutes):**\n\n1. **Do NOT click any links or open any attachments.** This is paramount.  Malicious links can download malware, and attachments can contain viruses or exploits.\n\n2. **Disconnect from the internet (if possible).** This limits the damage the malware can do if it's already on your system.  Unplug your ethernet cable or turn off Wi-Fi.\n\n3. **Close the email immediately.** Don't even hover over links or attachments; the preview might be enough to trigger some malware.\n\n**Investigative Actions (within hours):**\n\n4. **Check your email account for unauthorized access.**  Look for unfamiliar sent emails, changed settings (like forwarding rules), or new accounts added.\n\n5. **Run a full system scan with your antivirus software.**  Ensure your antivirus definitions are up-to-date before running the scan.  Consider a second opinion scan with a different reputable antivirus program.\n\n6. **Review your computer's processes (Task Manager on Windows, Activity Monitor on macOS).** Look for unfamiliar processes consuming significant resources.  This could indicate malware activity.\n\n7. **Check your network connections.**  See if any unauthorized connections exist.\n\n8. **Change your email password immediately.** Use a strong, unique password.  Consider using a password manager.\n\n9. **If you clicked a link or opened an attachment, consider the potential impact.** Did you enter credentials?  Did you download a file?  The severity of action needed depends on this.\n\n**Remediation Actions (within days):**\n\n10. **Contact your IT department or security professional.**  They can provide expert guidance and assist with more advanced remediation steps.\n\n11. **Consider more advanced malware scanning tools.**  There are specialized tools that can detect malware missed by standard antivirus.\n\n12. **Review your operating system's security settings.**  Ensure firewalls are enabled and that other security features are adequately configured.\n\n13. **Report the malicious email to your email provider.** This helps them remove the email and prevent others from being affected. You can often do this by forwarding the email to an abuse reporting address provided by your provider.  Report it to the appropriate authorities if you suspect the email involves a crime.\n\n14. **Monitor your accounts and financial records for suspicious activity.**  Phishing emails often aim to steal credentials and financial information.\n\n**Preventive Actions (ongoing):**\n\n15. **Implement strong email filtering.** Use spam filters and configure your email provider's security settings to block suspicious emails.\n\n16. **Train yourself and others to identify phishing emails.**  Be wary of emails with unusual addresses, grammatical errors, urgent requests, or suspicious attachments.\n\n17. **Keep your software up to date.** Regularly update your operating system, applications, and antivirus software.\n\n18. **Use strong, unique passwords for all accounts.**  A password manager can assist with this.\n\n19. **Enable two-factor authentication (2FA) wherever possible.** This adds an extra layer of security to your accounts.\n\n\n**If you suspect your personal data or financial information has been compromised:**\n\n* **Contact your bank and credit card companies immediately.**  Report any suspicious transactions and consider placing a fraud alert on your accounts.\n* **Consider credit monitoring services.**  This can help you detect and respond to identity theft.\n\n\nThe severity of the remediation steps depends on the nature of the malicious email and what actions you took in response to it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "avgLogprobs": -0.4171245741660307
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 778,
    "totalTokenCount": 790
  },
  "modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}
הודעות פלט

הפעולה הפעלת הנחיה יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully executed a prompt. הפעולה בוצעה בהצלחה.
Error executing action "Execute Prompt". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Execute Prompt:

שם תוצאת הסקריפט ערך
is_success True או False

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Vertex AI.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

אין.

ערכי פלט של פעולות

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

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
הודעות פלט

הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully connected to Vertex AI with the provided connection parameters! הפעולה בוצעה בהצלחה.

Failed to connect to Vertex AI. The API root that you provided doesn't match the following expected pattern: "https://((\w|-)+)-aiplatform.googleapis.com". Check the spelling.

Failed to connect to Vertex AI! The error is ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

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

שם תוצאת הסקריפט ערך
is_success True או False

טרנספורמציה של נתונים

משתמשים בפעולה Transform Data כדי לבצע טרנספורמציות של נתונים באמצעות Vertex AI.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה Transform Data דורשת את הפרמטרים הבאים:

פרמטר תיאור
Model ID אופציונלי

מזהה המודל שבו רוצים להשתמש, למשל gemini-1.5-flash-002.

Text Prompt חובה

ההוראות בטקסט שצריך לכלול בהנחיה.

Temperature אופציונלי

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

למידע נוסף על ערכי טמפרטורה, ראו ניסוי עם ערכי הפרמטרים.

JSON Object חובה

אובייקט ה-JSON שמשמש כקלט לפעולה.

Max Output Tokens חובה

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

טוקן הוא בערך ארבעה תווים. ‫100 אסימונים שווים בערך ל-60-80 מילים. המגבלה הזו חלה על כל ישות בנפרד.

מידע נוסף זמין במאמר ניסוי עם ערכי פרמטרים.

ערך ברירת המחדל הוא 100.

ערכי פלט של פעולות

הפעולה Transform Data מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Transform Data:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Respondo it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "avgLogprobs": -0.4171245741660307
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 778,
    "totalTokenCount": 790
  },
  "modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}
הודעות פלט

הפעולה Transform Data יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully transformed provided data. הפעולה בוצעה בהצלחה.
Error executing action "Transform Data". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Transform Data:

שם תוצאת הסקריפט ערך
is_success True או False

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.