Vertex AI in Google SecOps einbinden
In diesem Dokument wird beschrieben, wie Sie Vertex AI in Google Security Operations einbinden.
Anwendungsfälle
Die Vertex AI-Integration unterstützt die folgenden Anwendungsfälle:
Automatisierte Analyse schädlicher E‑Mails: Analysieren Sie EML-Rohdateien, um Bedrohungsstufen zu extrahieren, Phishing-Links oder Social-Engineering-Indikatoren zu identifizieren und Überprüfungsschritte zu empfehlen.
Kontextbezogene Entitätsanreicherung: Generieren Sie Zusammenfassungen von Sicherheitsentitäten in natürlicher Sprache, um die Triage zu beschleunigen.
Flexible Playbook-Orchestrierung: Führen Sie unstrukturierte generative Text-Prompts in Playbooks aus, um die vorausschauende Abwehr oder komplexe Sicherheitsanalysen zu unterstützen.
Benutzerdefinierte Datentransformation: Automatisieren Sie programmatische Transformationen beliebiger JSON-Datenstrukturen mithilfe von Anweisungen in natürlicher Sprache.
Hinweis
Bevor Sie die Vertex AI-Integration in Google SecOps konfigurieren, müssen Sie die folgenden Voraussetzungen erfüllen:
Weisen Sie Ihrem Dienstkonto die erforderlichen IAM-Rollen (Identity and Access Management) zu.
Wählen Sie eine der folgenden Authentifizierungsmethoden aus und konfigurieren Sie sie:
Option 1: Workload Identity (empfohlen): Bei dieser Methode werden kurzlebige Tokens verwendet, die die Identitätsübernahme des Dienstkontos nutzen.
Option 2: JSON-Schlüssel für Dienstkonto: Diese Methode basiert auf einer statischen, langlebigen Secret-Schlüsseldatei.
Detaillierte Informationen zu den Servicegebühren finden Sie unter Vertex AI-Preise.
Dienstkonto erstellen
Rufen Sie in der Google Cloud Console IAM und Verwaltung > Dienstkonten auf.
Klicken Sie auf addDienstkonto erstellen.
Geben Sie einen Namen und eine Beschreibung ein und klicken Sie auf Fertig. Notieren Sie sich die E-Mail-Adresse des Dienstkontos.
IAM-Rollen zuweisen
Damit die Integration mit Plattformdiensten interagieren kann, müssen Sie Ihrem Hauptkonto Berechtigungen erteilen.
Rufen Sie in der Google Cloud Console IAM auf.
Suchen Sie Ihr Dienstkonto und klicken Sie auf Hauptkonto bearbeiten (Bearbeiten).
Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Vertex AI-Nutzer (
roles/aiplatform.user) aus.Klicken Sie auf Speichern.
Workload Identity-Anmeldedaten konfigurieren
Workload Identity ist der empfohlene Ansatz, da hier kurzlebige Zugriffstokens über die Identitätsübernahme des Dienstkontos verwendet werden.
Eindeutige Instanzidentität identifizieren
Zum Herstellen einer Verbindung müssen Sie Ihrer Google SecOps-Instanz die Berechtigung erteilen, die Identität Ihres Dienstkontos zu übernehmen.
Rufen Sie in Google SecOps Content Hub > Antwortintegrationen auf.
Wählen Sie die Integration Vertex AI aus und geben Sie die E-Mail-Adresse Ihres Dienstkontos unter Workload Identity-E-Mail-Adresse ein.
Klicken Sie auf Speichern > Testen. Der Test schlägt erwartungsgemäß fehl.
Klicken Sie neben dem Button Test auf close_small und suchen Sie nach der Identitäts-E-Mail-Adresse, die mit
gke-init-python@...odersoar-python@...beginnt.Kopieren Sie diese eindeutige E‑Mail-Adresse.
Instanzidentität in Google Cloudautorisieren
Rufen Sie in der Google Cloud Console IAM und Verwaltung > Dienstkonten auf.
Wählen Sie das Zieldienstkonto aus und rufen Sie Berechtigungen > Zugriff gewähren auf.
Fügen Sie die eindeutige E-Mail-Adresse in Neue Hauptkonten ein und weisen Sie die Rolle Ersteller von Dienstkonto-Tokens (
roles/iam.serviceAccountTokenCreator) zu.
JSON-Schlüssel konfigurieren
Statische, langlebige Secret-Schlüsseldateien müssen manuell rotiert werden. Verwenden Sie diese Methode nur, wenn die Workload Identity-Authentifizierung nicht verfügbar ist.
Rufen Sie in der Google Cloud Console IAM und Verwaltung > Dienstkonten auf und wählen Sie Ihr Dienstkonto aus.
Rufen Sie den Tab Schlüssel auf und klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
Wählen Sie JSON aus und klicken Sie auf Erstellen. Der Browser lädt die JSON-Datei auf Ihren Computer herunter.
Integrationsparameter
Für die Vertex AI-Integration sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
API Root |
Pflichtangabe. Der API-Stamm der Vertex AI-Instanz. Der Standardwert ist |
Workload Identity Email |
Optional. Die Client-E-Mail-Adresse Ihres Dienstkontos. Konfigurieren Sie diesen Parameter nur, wenn Sie sich mit einer Workload Identity authentifizieren. Wenn konfiguriert, wird |
Service Account JSON File Content |
Optional. Der vollständige Inhalt der JSON-Datei des Dienstkontoschlüssels. Konfigurieren Sie diesen Parameter für die Authentifizierung mit Dienstkontoschlüsseln. |
Project ID |
Optional. Die Projekt-ID, die in Pub/Sub als Ziel verwendet werden soll. Wenn kein Wert angegeben ist, ruft die Integration die ID aus den Anmeldedaten des Dienstkontos ab. |
Default Model |
Optional. Der Name des Standardmodells, auf das abgezielt werden soll. Der Standardwert ist |
Location |
Optional. Die Standort-ID für die Vertex AI API. Wenn kein Wert angegeben ist, extrahiert die Integration die Standort-ID aus dem API-Stamm. |
Verify SSL |
Pflichtangabe. Validiert das SSL-Zertifikat für die Verbindung zum Server. Standardmäßig aktiviert. |
Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.
Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.
Aktionen
Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.
EML analysieren
Mit der Aktion EML analysieren können Sie EML-Dateien mit Vertex AI analysieren. Dadurch wird jede Datei einzeln eingereicht.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion EML analysieren sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Model ID |
Optional Die ID des zu verwendenden Modells, z. B. |
Temperature |
Optional Der Wert, der den Grad der Zufälligkeit bei der Tokenauswahl steuert. Dieser Parameter akzeptiert Werte vom Datentyp Weitere Informationen zu Temperaturwerten finden Sie unter Mit Parameterwerten experimentieren. |
Files To Analyze |
Erforderlich Eine durch Kommas getrennte Liste von EML-Dateien, die zur Analyse eingereicht werden sollen. |
Max Output Tokens |
Optional Die maximale Anzahl von Ausgabe-Tokens, die in jeder Antwort generiert werden sollen. Ein Token besteht aus etwa vier Zeichen. 100 Tokens entsprechen etwa 60–80 Wörtern. Dieses Limit gilt für jede einzelne Entität. Weitere Informationen finden Sie unter Mit Parameterwerten experimentieren. Der Standardwert ist |
Aktionsausgaben
Die Aktion EML analysieren liefert die folgenden Ausgaben:
| Aktionsausgabetyp | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle mit Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion EML analysieren erhalten:
[{
"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
}
}
}]
Ausgabenachrichten
Die Aktion EML analysieren kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully analysed the following EML files using Vertex AI:
FILE_PATHS |
Die Aktion war erfolgreich. |
Error executing action "Analyze EML". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion EML analysieren verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Entität beschreiben
Verwenden Sie die Aktion Entität beschreiben, um Informationen zu Entitäten mit Vertex AI zusammenzufassen.
Diese Aktion wird für alle Google SecOps-Entitäten ausgeführt und jede Entität wird einzeln gesendet.
Aktionseingaben
Für die Aktion Entität beschreiben sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Model ID |
Optional Die ID des zu verwendenden Modells, z. B. |
Temperature |
Optional Der Wert, der den Grad der Zufälligkeit bei der Tokenauswahl steuert. Dieser Parameter akzeptiert Werte vom Datentyp Weitere Informationen zu Temperaturwerten finden Sie unter Mit Parameterwerten experimentieren. |
Exclude Fields |
Optional Eine durch Kommas getrennte Liste der Google SecOps-Entitätsmetadatenfelder, die bei der Generierung der Entitätszusammenfassung ausgeschlossen werden sollen. |
Force Refresh |
Optional Wenn diese Option ausgewählt ist, ignoriert die Aktion den Parameter Standardmäßig nicht ausgewählt. |
Refresh After (Days) |
Erforderlich Die Anzahl der Tage, die die Aktion warten soll, bevor die Entitätszusammenfassung aktualisiert wird. Die Aktion generiert einen Hash-Wert, der auf allen Eingaben basiert, die an Vertex AI gesendet werden, mit Ausnahme von Werten aus dem Parameter Die Aktion validiert den Hash-Wert der neuesten tatsächlich generierten Zusammenfassung und ignoriert den im Cache gespeicherten Hash-Wert. Der Standardwert ist |
Max Output Tokens |
Optional Die maximale Anzahl von Ausgabe-Tokens, die in jeder Antwort generiert werden sollen. Ein Token besteht aus etwa vier Zeichen. 100 Tokens entsprechen etwa 60–80 Wörtern. Dieses Limit gilt für jede einzelne Entität. Weitere Informationen finden Sie unter Mit Parameterwerten experimentieren. |
Aktionsausgaben
Die Aktion Entität beschreiben liefert die folgenden Ausgaben:
| Aktionsausgabetyp | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle mit Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Entität beschreiben empfangen wird:
[
{
"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
}
}
}
]
Ausgabenachrichten
Die Aktion Entität beschreiben kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully summarized the entity based on the available
information using Vertex AI. |
Die Aktion war erfolgreich. |
Error executing action "Describe Entity". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Entität beschreiben verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Prompt ausführen
Verwenden Sie die Aktion Prompt ausführen, um einzelne Text-Prompts mit Vertex AI auszuführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Prompt ausführen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Model ID |
Optional Die ID des zu verwendenden Modells, z. B. |
Text Prompt |
Erforderlich Die Textanleitung, die in den Prompt eingefügt werden soll. |
Temperature |
Optional Der Wert, der den Grad der Zufälligkeit bei der Tokenauswahl steuert. Dieser Parameter akzeptiert Werte vom Datentyp Weitere Informationen zu Temperaturwerten finden Sie unter Mit Parameterwerten experimentieren. |
Candidate Count |
Optional Die Anzahl der Antwortvarianten, die bei jeder Aktionsausführung zurückgegeben werden sollen. Für jede Anfrage wird die Abrechnung einmal für ein Eingabetoken und für jedes Ausgabetoken aller generierten Kandidaten angewendet. |
Response MIME Type |
Optional Der Medientyp (MIME-Typ) der Ausgabeantwort für den generierten Kandidatentext. Der MIME-Typ der Antwort ist für die folgenden Modelle verfügbar: Folgende Werte sind möglich:
text/plain. |
Response Schema |
Optional Das Schema, dem der generierte Kandidatentext folgen soll. Wenn Sie diesen Parameter verwenden möchten, müssen Sie den Parameter Das Antwortschema ist für die folgenden Modelle verfügbar: |
Max Input Tokens |
Optional Die maximale Anzahl von Eingabetokens, die gesendet werden sollen. Ein Token besteht aus bis zu vier Zeichen. 100 Tokens können 60–80 Wörtern entsprechen. Wenn Sie keinen Wert festlegen, führt die Aktion jeden Prompt aus. Wenn die Anzahl der Tokens die konfigurierte maximale Anzahl überschreitet, schlägt die Aktion fehl. |
Max Output Tokens |
Optional Die maximale Anzahl von Ausgabe-Tokens, die in jeder Antwort generiert werden sollen. Ein Token besteht aus etwa vier Zeichen. 100 Tokens entsprechen etwa 60–80 Wörtern. Dieses Limit gilt für jede einzelne Entität. Weitere Informationen finden Sie unter Mit Parameterwerten experimentieren. |
Aktionsausgaben
Die Aktion Prompt ausführen liefert die folgenden Ausgaben:
| Aktionsausgabetyp | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle mit Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Prompt ausführen empfangen wird:
{
"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": ""
}
Ausgabenachrichten
Die Aktion Prompt ausführen kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully executed a prompt. |
Die Aktion war erfolgreich. |
Error executing action "Execute Prompt". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Prompt ausführen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Ping
Verwenden Sie die Aktion Ping, um die Verbindung zu Vertex AI zu testen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Keine.
Aktionsausgaben
Die Aktion Ping liefert die folgenden Ausgaben:
| Aktionsausgabetyp | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle mit Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Nicht verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
Ausgabenachrichten
Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully connected to Vertex AI with the provided connection
parameters! |
Die Aktion war erfolgreich. |
|
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Daten transformieren
Verwenden Sie die Aktion Daten transformieren, um Datentransformationen mit Vertex AI durchzuführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Daten transformieren sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Model ID |
Optional Die ID des zu verwendenden Modells, z. B. |
Text Prompt |
Erforderlich Die Textanleitung, die in den Prompt eingefügt werden soll. |
Temperature |
Optional Der Wert, der den Grad der Zufälligkeit bei der Tokenauswahl steuert. Dieser Parameter akzeptiert Werte vom Datentyp Weitere Informationen zu Temperaturwerten finden Sie unter Mit Parameterwerten experimentieren. |
JSON Object |
Erforderlich Das JSON-Objekt, das als Aktionseingabe verwendet werden soll. |
Max Output Tokens |
Erforderlich Die maximale Anzahl von Ausgabe-Tokens, die in jeder Antwort generiert werden sollen. Ein Token besteht aus etwa vier Zeichen. 100 Tokens entsprechen etwa 60–80 Wörtern. Dieses Limit gilt für jede einzelne Entität. Weitere Informationen finden Sie unter Mit Parameterwerten experimentieren. Der Standardwert ist |
Aktionsausgaben
Die Aktion Daten transformieren liefert die folgenden Ausgaben:
| Aktionsausgabetyp | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle mit Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Daten transformieren empfangen wird:
{
"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": ""
}
Ausgabenachrichten
Die Aktion Daten transformieren kann die folgenden Ausgabemeldungen zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully transformed provided data. |
Die Aktion war erfolgreich. |
Error executing action "Transform Data". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Skriptausgabe aufgeführt, wenn die Aktion Daten transformieren verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten