Projekt- und Agent-Einstellungen

Sie können eine Vielzahl von Einstellungen auf Projekt-, Agent-Anwendungs- und Agent-Ebene steuern.

Standorteinstellungen für das Projekt

Die Standorteinstellungen für das Projekt gelten für jede Agent-Anwendung und jeden Agent im jeweiligen Projekt und am jeweiligen Standort. Wenn Sie die Einstellungen für den Projektstandort bearbeiten möchten, rufen Sie die Agent-Liste auf, wählen Sie das Projekt und den Standort aus, und klicken Sie dann auf die Schaltfläche „Standorteinstellungen“ .

Folgende Projekt- und Standorteinstellungen sind verfügbar:

  • VPC Service Controls: Weitere Informationen finden Sie unter VPC Service Controls.

  • Zulässige Ursprünge: Wenn Sie VPC Service Controls verwenden, können Sie die HTTP(S) Endpunkte definieren, die bei Aufrufen außerhalb der Agent-Anwendung zulässig sind. So können Ihre Agenten sicher mit externen Diensten interagieren, ohne den Traffic über einen Proxy leiten zu müssen. Dies gilt für alle Arten von Tools und Callbacks, die externe Anfragen stellen können. Wenn VPC Service Controls nicht aktiviert ist (Standard), sind alle Endpunkte zulässig. Wenn VPC Service Controls aktiviert ist, ist kein Endpunkt zulässig, es sei denn, er wurde der Liste der zulässigen Ursprünge hinzugefügt.

    Endpunkte werden als URLs mit genauer Übereinstimmung (ohne Platzhalter) angegeben, einschließlich des Schemas und des optionalen Ports. Beispiele:

    • https://example.com:8443
    • https://api.example.com

    Zum Verwalten zulässiger Ursprünge benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):

    • ces.googleapis.com/securitysettings.get
    • ces.googleapis.com/securitysettings.update

    Diese Berechtigungen sind für Sicherheitsadministratoren oder Projektadministratoren vorgesehen und nicht für Personen, die Agent-Daten bearbeiten. Diese Berechtigungen sind in der vordefinierten Rolle CES Admin enthalten.

    Diese Einstellung wird auf Projekt- und Standortebene angewendet, damit Organisationen zulässige Ursprünge für alle Agent-Anwendungen steuern können. Die Einstellung kann nicht pro Agent-Anwendung oder pro Agent angewendet werden. Sie können die API auch verwenden, um die SecuritySettings EndpointControlPolicy zu aktualisieren.

Einstellungen für Agent-Anwendungen

So bearbeiten Sie globale Einstellungen für Agent-Anwendungen:

  1. Klicken Sie rechts im Builder auf das Symbol „Einstellungen“.

Folgende Einstellungen für Agent-Anwendungen sind verfügbar:

  • Basic:
    • Interactions:
      • Global model: Standardmodell das verwendet wird, sofern es nicht von einzelnen Agenten überschrieben wird. Einige Modelle sind möglicherweise für Text oder Sprache optimiert.
      • Language controls:
        • Default language: Alle Unterhaltungen in dieser Sprache beginnen.
        • Additional languages: Wenn Ihre Agent-Anwendung mehrsprachig ist, geben Sie zusätzliche Sprachen an. Ihre Agent-Anwendung wechselt automatisch die Sprache, um der Nutzereingabe zu entsprechen.
        • Umgang mit nicht unterstützten Sprachen: Wenn die Nutzereingabe in einer nicht unterstützten Sprache erfolgt, fordert die Agent-Anwendung den Nutzer auf, die Eingabe einmal zu wiederholen. Wenn die neue Eingabe ebenfalls in einer nicht unterstützten Sprache erfolgt, wählen Sie die Aktion aus, die ausgeführt werden soll.
    • Behavior:
      • Voice: Die Stimme, die für die Sprachsynthese verwendet wird.
      • Ambient sounds: Hintergrundgeräusche, die vom Agent abgespielt werden.
      • Response length: Legen Sie fest, wie ausführlich der Agent sein soll.
      • Allow user interruptions: Ermöglichen Sie dem Endnutzer, den Agent zu unterbrechen.
      • Adapt when interrupted: Wenn diese Option aktiviert ist, versuchen Agenten, ihre Antwort anzupassen, da der Nutzer möglicherweise nicht alles gehört hat.
      • Fallback behavior:
        • Wiederholungen: Wenn die KI keine Antwort generieren kann, wählen Sie aus, wie oft der Agent es noch einmal versuchen soll.
        • Agentenantwort: Der Agent bittet Endnutzer vor jedem erneuten Versuch um Erlaubnis. Hier können Sie eine Standardantwort angeben. Wenn keine Standardantwort angegeben wird, wird eine Standardantwort verwendet.
        • Fallback: Legen Sie fest, was passiert, wenn der Agent nach dem letzten erneuten Versuch nicht fortfahren kann.
    • Agent details:
      • Display name: Anzeigename für die Agent-Anwendung.
      • Lock agent: Verhindern Sie, dass Änderungen angewendet werden.
      • Notes: Eine für Menschen lesbare Beschreibung der Agent-Anwendung. Diese wird nicht an das Modell gesendet.
  • Advanced:
    • Speech:
      • Silence timeout: Warten Sie auf die Nutzereingabe und fordern Sie den Nutzer dann auf, noch einmal zu interagieren.
      • Ambient sound volume gain: Passen Sie die Lautstärke der Umgebungsgeräusche an.
      • Keypad input: Richten Sie die Zweiton-Mehrfrequenzsignalisierung (Dual-Tone Multi-Frequency, DTMF) für Telefonanrufe ein. Standardmäßig aktiviert.
    • Logging:
      • Logs and data sharing: Verwalten Sie Agent-weite Einstellungen für Logs und die Agent-Entwicklung.
        • Interaktionsdaten: Speichern Sie Interaktionsdaten für detailliertere Statistiken und als Referenz. Dazu gehören simulierte und Live-Interaktionen, Tracing-Daten und mehr. Wenn diese Option deaktiviert ist, können Sie keine früheren Unterhaltungen mit Ihrem Agent sehen.
      • Redaktion aktivieren: Sensible Daten automatisch finden und entfernen.
      • Cloud Logging aktivieren: Logs automatisch an Cloud Logging streamen.
      • Export logs to BigQuery: Logs für benutzerdefinierte Analysen nach BigQuery exportieren.
      • Audioaufnahme: Cloud Storage-Bucket-Speicherort für Audiodateien ausgeben.
    • Tools:
      • Ausführungsmodus: Tool-Aufrufe parallel oder sequenziell ausführen.
    • Globale Anweisung: Anweisungen für alle Agenten in der Agent-Anwendung. Mit diesen Anweisungen können Sie eine stabile Identität oder Persönlichkeit für alle Agenten einrichten.

Agent-Einstellungen

So bearbeiten Sie spezifische Einstellungen für Root- oder Sub-Agenten:

  1. Klicken Sie im Feld mit dem Agent-Titel auf das Kontextmenü.
  2. Wählen Sie Konfiguration bearbeiten aus.

Folgende Einstellungen für Root- und Sub-Agenten sind verfügbar:

  • Agent name: Anzeigename für den Agent. Verwenden Sie die Snake-Case-Schreibweise.
  • Modell: Das Modell für den Agent.
  • Beschreibung: Eine Beschreibung des Agenten. Diese Beschreibung wird anderen Agenten in der Agent-Anwendung zur Verfügung gestellt.
  • Custom code: Geben Sie Code für Callbacks an.