Impostazioni di progetto e agente

Puoi controllare una serie di impostazioni a livello di località del progetto, applicazione dell'agente e agente.

Impostazioni di localizzazione del progetto

Le impostazioni di localizzazione del progetto si applicano a ogni applicazione dell'agente e agente all'interno del progetto e della località specifici. Per modificare le impostazioni di localizzazione del progetto, vai all'elenco degli agenti, seleziona il progetto e la località, quindi fai clic sul pulsante delle impostazioni.

Sono disponibili le seguenti impostazioni di progetto e località:

  • Controlli di servizio VPC: consulta Controlli di servizio VPC.

  • Origini consentite: se utilizzi i Controlli di servizio VPC, puoi definire gli endpoint HTTP(S) consentiti quando effettui chiamate esterne all'applicazione dell'agente. In questo modo, i tuoi agenti possono interagire in modo sicuro con i servizi esterni senza dover instradare il traffico tramite un proxy. Questa impostazione si applica a tutti i tipi di strumenti e callback che possono effettuare richieste esterne. Se i Controlli di servizio VPC non sono abilitati (impostazione predefinita), tutti gli endpoint sono consentiti. Se i Controlli di servizio VPC sono abilitati, nessun endpoint è consentito a meno che non venga aggiunto all'elenco delle origini consentite.

    Gli endpoint vengono forniti come URL di corrispondenza esatta (senza caratteri jolly), inclusi lo schema e la porta facoltativa. Esempi:

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

    Per gestire le origini consentite, devi disporre delle seguenti autorizzazioni Identity and Access Management:

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

    Queste autorizzazioni sono progettate per essere concesse agli amministratori della sicurezza o agli amministratori del progetto, separatamente da coloro che modificano i dati dell'agente. Queste autorizzazioni sono incluse nel ruolo predefinito CES Admin.

    Questa impostazione viene applicata a livello di progetto e località per consentire alle organizzazioni di controllare le origini consentite per tutte le applicazioni dell'agente. L'impostazione non può essere applicata per applicazione dell'agente o per agente. Puoi anche utilizzare l'API per aggiornare le SecuritySettings EndpointControlPolicy.

Impostazioni dell'applicazione dell'agente

Per modificare le impostazioni globali dell'applicazione dell'agente:

  1. Fai clic sull'icona delle impostazioni sul lato destro del builder.

Sono disponibili le seguenti impostazioni dell'applicazione dell'agente:

  • Di base:
    • Interazioni:
      • Modello globale: Modello predefinito utilizzato a meno che non venga sostituito da singoli agenti. Tieni presente che alcuni modelli potrebbero essere ottimizzati per il testo o la voce.
      • Controlli della lingua:
        • Lingua predefinita: avvia tutte le conversazioni in questa lingua.
        • Lingue aggiuntive: se l'applicazione dell'agente è multilingue, fornisci lingue aggiuntive. L'applicazione dell'agente cambierà automaticamente la lingua in base all'input utente.
        • Gestione delle lingue non supportate: quando input utente viene fornito in una lingua non supportata, l'applicazione dell'agente chiederà all'utente di ripetere l'input una volta. Se il nuovo input utilizza anche una lingua non supportata, seleziona l'azione da eseguire.
    • Comportamento:
      • Voce: la voce utilizzata per la sintesi vocale.
      • Musica ambient: suoni di sottofondo riprodotti dall'agente.
      • Lunghezza della risposta: regola la quantità di informazioni fornite dall'agente.
      • Consenti interruzioni dell'utente: consente all'utente finale di interrompere l'agente.
      • Adatta quando interrotto: se questa opzione è abilitata, gli agenti tenteranno di adattare la loro risposta tenendo conto del fatto che l'utente potrebbe non aver sentito tutto.
      • Comportamento di fallback:
        • Nuovi tentativi: se l'AI non riesce a generare una risposta, seleziona il numero di volte in cui l'agente deve riprovare.
        • Risposta dell'agente: l'agente chiederà l'autorizzazione agli utenti finali prima di ogni nuovo tentativo. Puoi fornire una risposta predefinita qui. Se non viene fornita, viene utilizzata una risposta predefinita.
        • Fallback: Decidi cosa succede se l'agente non può continuare dopo l'ultimo tentativo.
    • Dettagli dell'agente:
      • Nome visualizzato: nome visualizzato dell'applicazione dell'agente.
      • Blocca agente: impedisce l'applicazione delle modifiche.
      • Note: descrizione leggibile dell'applicazione dell'agente. Non viene inviata al modello.
  • Avanzate:
    • Voce:
      • Timeout di silenzio: attendi input utente, quindi chiedigli di interagire di nuovo.
      • Guadagno del volume del suono ambientale: regola il volume del suono ambientale.
      • Input tastierino: configura la tecnologia multifrequenza a due toni (DTMF) per le chiamate telefoniche. Abilitato per impostazione predefinita.
    • Registrazione:
      • Log e condivisione dei dati: gestisci le impostazioni a livello di agente per i log e lo sviluppo dell'agente.
        • Dati di interazione: archivia i dati di interazione per approfondire gli insight e come riferimento. Sono inclusi interazioni simulate e live, dati di tracciamento e altro ancora. Se questa opzione è disattivata, non potrai visualizzare le conversazioni precedenti con l'agente.
      • Attiva oscuramento: trova e rimuovi automaticamente i dati sensibili.
      • Attiva Cloud Logging: esegui automaticamente lo streaming dei log in Cloud Logging.
      • Esporta i log in BigQuery: esporta i log in BigQuery per l'analisi personalizzata.
      • Registrazione audio: percorso del bucket Cloud Storage di output per i file audio.
    • Strumenti:
      • Modalità di esecuzione: esegui le chiamate agli strumenti in ordine parallelo o sequenziale.
    • Istruzioni globali: Istruzioni per tutti gli agenti nell'applicazione dell'agente. Puoi utilizzare queste istruzioni per configurare un'identità o una personalità stabile tra gli agenti.

Impostazioni dell'agente

Per modificare le impostazioni specifiche dell'agente principale o secondario:

  1. Fai clic sul menu contestuale nella casella del titolo dell'agente.
  2. Seleziona Modifica configurazione.

Sono disponibili le seguenti impostazioni dell'agente principale e secondario:

  • Nome dell'agente: nome visualizzato dell'agente. Utilizza la notazione snake_case.
  • Modello: il modello utilizzato per l'agente.
  • Descrizione: una descrizione dell'agente. Questa descrizione viene fornita ad altri agenti nell'applicazione dell'agente.
  • Codice personalizzato: fornisci il codice per i callback.