Projekt- und Agent-Einstellungen

Sie können verschiedene Einstellungen auf Projektstandort-, Agentenanwendungs- und Agentenebene steuern.

Standorteinstellungen für das Projekt

Die Standorteinstellungen für das Projekt gelten für jede Agentenanwendung und jeden Agenten im jeweiligen Projekt und am jeweiligen Standort. Wenn Sie die Einstellungen für den Projektstandort bearbeiten möchten, rufen Sie die Agentenliste auf, wählen Sie das Projekt und den Standort aus und klicken Sie dann auf die Schaltflächeneinstellungen .

Die folgenden 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 Agentenanwendung 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 Rückrufen, 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 Agentendaten bearbeiten. Sie 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 Agentenanwendungen steuern können. Die Einstellung kann nicht pro Agentenanwendung oder pro Agent angewendet werden. Sie können die API auch verwenden, um die SecuritySettings EndpointControlPolicy zu aktualisieren.

Einstellungen für Agentenanwendungen

So bearbeiten Sie globale Einstellungen für Agentenanwendungen:

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

Die folgenden Einstellungen für Agentenanwendungen sind verfügbar:

  • Grundlegend:
    • Interaktionen:
      • Globales Modell: Standardmodell das verwendet wird, sofern es nicht von einzelnen Agenten überschrieben wird. Einige Modelle sind möglicherweise für Text oder Sprache optimiert.
      • Spracheinstellungen:
        • Standardsprache: Alle Unterhaltungen in dieser Sprache beginnen.
        • Zusätzliche Sprachen: Wenn Ihre Agentenanwendung mehrsprachig ist, geben Sie zusätzliche Sprachen an. Die Agentenanwendung 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 Agentenanwendung 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.
    • Verhalten:
      • Sprache: Weitere Informationen finden Sie unter Sprache und Spracheingabe.
      • Umgebungsgeräusche: Hintergrundgeräusche, die vom Agenten abgespielt werden.
      • Länge der Antwort: Anpassen, wie ausführlich der Agent ist.
      • Nutzerunterbrechungen zulassen: Endnutzern erlauben, den Agenten zu unterbrechen.
      • Bei Unterbrechung anpassen: Wenn diese Option aktiviert ist, versuchen Agenten, ihre Antwort anzupassen, da der Nutzer möglicherweise nicht alles gehört hat.
      • Fallback-Verhalten:
        • Wiederholungen: Wenn die KI keine Antwort generieren kann, wählen Sie aus, wie oft der Agent es versuchen soll.
        • Antwort des Agenten: Der Agent bittet Endnutzer vor jedem Wiederholungsversuch um Erlaubnis. Hier können Sie eine Standardantwort angeben. Wenn keine Standardantwort angegeben wird, wird eine verwendet.
        • Fallback: Legen Sie fest, was passiert, wenn der Agent nach dem letzten Wiederholungsversuch nicht fortfahren kann.
    • Agentendetails:
      • Anzeigename: Anzeigename für die Agentenanwendung.
      • Agent sperren: Verhindern, dass Änderungen angewendet werden.
      • Hinweise: Eine menschenlesbare Beschreibung der Agentenanwendung. Diese wird nicht an das Modell gesendet.
  • Erweitert:
    • Sprache: Weitere Informationen finden Sie unter Sprache und Spracheingabe.
    • Logging:
      • Protokolle und Datenweitergabe: Agentenweite Einstellungen für Protokolle und die Agentenentwicklung verwalten.
        • Interaktionsdaten: Interaktionsdaten für detailliertere Statistiken und Ihre Referenz speichern. 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 Agenten sehen.
      • Entfernung aktivieren: Sensible Daten automatisch finden und entfernen.
      • Cloud Logging aktivieren: Logs automatisch an Cloud Logging streamen.
      • Logs nach BigQuery exportieren: Logs zur benutzerdefinierten Analyse nach BigQuery exportieren.
      • Audioaufzeichnung: Cloud Storage-Bucket-Speicherort für Audio dateien ausgeben.
    • Tools:
      • Ausführungsmodus: Toolaufrufe parallel oder sequenziell ausführen.
    • Globale Anweisung: Anweisungen für alle Agenten in der Agentenanwendung. 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 Agententitel auf das Kontextmenü.
  2. Wählen Sie Konfiguration bearbeiten aus.

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

  • Agentenname: Anzeigename für den Agenten. Verwenden Sie Snake Case.
  • Modell: Das Modell für den Agenten.
  • Beschreibung: Eine Beschreibung des Agenten. Diese Beschreibung wird anderen Agenten in der Agentenanwendung zur Verfügung gestellt.
  • Benutzerdefinierter Code: Code für Rückrufe angeben.