Configuración del proyecto y el agente

Puedes controlar varios parámetros de configuración en la ubicación del proyecto, la aplicación del agente y los niveles del agente.

Configuración de la ubicación del proyecto

La configuración de ubicación del proyecto se aplica a cada aplicación del agente y agente dentro del proyecto y la ubicación específicos. Para editar la configuración de ubicación del proyecto, navega a la lista de agentes, selecciona el proyecto y la ubicación, luego haz clic en el botón de configuración .

Las siguientes opciones de configuración del proyecto y la ubicación están disponibles:

  • Controles del servicio de VPC: Consulta Controles del servicio de VPC.

  • Orígenes permitidos: Si usas los Controles del servicio de VPC, puedes definir los extremos HTTP(S) que se permiten cuando se realizan llamadas externas a la aplicación del agente. Esto permite que tus agentes interactúen de forma segura con servicios externos sin necesidad de enrutar el tráfico a través de un proxy. Esto se aplica a todos los tipos de herramientas y devoluciones de llamada, que pueden realizar solicitudes externas. Si los Controles del servicio de VPC no están habilitados (opción predeterminada), se permiten todos los extremos. Si los Controles del servicio de VPC están habilitados, no se permite ningún extremo, a menos que se agregue a la lista de orígenes permitidos.

    Los extremos se proporcionan como URLs de coincidencia exacta (sin comodines), incluido el esquema y el puerto opcional. Ejemplos:

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

    Para administrar los orígenes permitidos, necesitas los siguientes permisos de Identity and Access Management:

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

    Estos permisos están diseñados para otorgarse a administradores de seguridad o administradores de proyectos, aparte de quienes editan los datos del agente. Estos permisos se incluyen en el rol predefinido CES Admin.

    Este parámetro de configuración se aplica a nivel del proyecto y la ubicación para permitir que las organizaciones controlen los orígenes permitidos para todas las aplicaciones del agente. El parámetro de configuración no se puede aplicar por aplicación del agente ni por agente. También puedes usar la API para actualizar el SecuritySettings EndpointControlPolicy.

Configuración de la aplicación del agente

Para editar la configuración global de la aplicación del agente, haz lo siguiente:

  1. Haz clic en el ícono de configuración en el lado derecho del compilador.

Las siguientes opciones de configuración de la aplicación del agente están disponibles:

  • Básico:
    • Interacciones:
      • Modelo global: Es el modelo predeterminado que se usa, a menos que los agentes individuales lo anulen. Ten en cuenta que algunos modelos pueden estar optimizados para texto o voz.
      • Controles de idioma:
        • Idioma predeterminado: Inicia todas las conversaciones en este idioma.
        • Idiomas adicionales: Si tu aplicación del agente es multilingüe, proporciona idiomas adicionales. Tu aplicación del agente cambiará automáticamente de idioma para que coincida con la entrada del usuario.
        • Manejo de idiomas no disponibles: Cuando se proporciona la entrada del usuario en un idioma no disponible, la aplicación del agente le pedirá al usuario que repita la entrada una vez. Si la entrada nueva también usa un idioma no admitido, selecciona la acción que debe realizarse.
    • Comportamiento:
      • Voz: Es la voz que se usa para la síntesis de voz.
      • Sonidos ambientales: Son los sonidos de fondo que reproduce el agente.
      • Longitud de la respuesta: Ajusta el nivel de detalle del agente.
      • Permitir interrupciones del usuario: Permite que el usuario final interrumpa al agente.
      • Adaptar cuando se interrumpe: Cuando está habilitado, los agentes intentarán adaptar su respuesta teniendo en cuenta que es posible que el usuario no haya escuchado todo.
      • Comportamiento de fallback:
        • Reintentos: Si la IA no puede generar una respuesta, selecciona cuántas veces debe reintentar el agente.
        • Respuesta del agente: El agente les pedirá permiso a los usuarios finales antes de cada reintento. Puedes proporcionar una respuesta predeterminada aquí. Si no se proporciona, se usará una respuesta predeterminada.
        • Fallback: Decide qué sucede si el agente no puede continuar después de l último intento de reintento.
    • Detalles del agente:
      • Nombre visible: Es el nombre visible de la aplicación del agente.
      • Bloquear agente: Evita que se apliquen cambios.
      • Notas: Es una descripción legible de la aplicación del agente. No se envía al modelo.
  • Avanzado:
    • Voz:
      • Tiempo de espera de silencio: Espera la entrada del usuario y, luego, pídele que vuelva a interactuar.
      • Aumento de volumen del sonido ambiental: Ajusta el volumen del sonido ambiental.
      • Entrada del teclado: Configura la señalización multifrecuencia de dos tonos (DTMF) para las llamadas telefónicas. Habilitada de forma predeterminada.
    • Logging:
      • Registros y uso compartido de datos: Administra la configuración de todo el agente para los registros y el desarrollo del agente.
        • Datos de interacción: Almacena datos de interacción para obtener estadísticas más detalladas y como referencia. Esto incluye interacciones simuladas y en vivo, datos de seguimiento y mucho más. Si está inhabilitado, no podrás ver las conversaciones anteriores con tu agente.
      • Habilitar la ocultación: Busca y quita automáticamente los datos sensibles.
      • Habilitar Cloud Logging: Transmite automáticamente los registros a Cloud Logging.
      • Exportar registros a BigQuery: Exporta registros a BigQuery para realizar análisis personalizados.
      • Grabación de audio: Genera la ubicación del bucket de Cloud Storage para los archivos de audio files.
    • Herramientas:
      • Modo de ejecución: Ejecuta llamadas a herramientas en paralelo o en orden secuencial.
    • Instrucción global: Son instrucciones para todos los agentes de la aplicación del agente. Puedes usar estas instrucciones para configurar una identidad o personalidad estable en todos los agentes.

Configuración de agentes

Para editar la configuración específica del agente raíz o secundario, haz lo siguiente:

  1. Haz clic en el menú contextual en el cuadro de título del agente.
  2. Selecciona Editar configuración.

Las siguientes opciones de configuración del agente raíz y secundario están disponibles:

  • Nombre del agente: Es el nombre visible del agente. Usa snake_case.
  • Modelo: Es el modelo que se usa para el agente.
  • Descripción: Es una descripción del agente. Esta descripción se proporciona a otros agentes en la aplicación del agente.
  • Código personalizado: Proporciona código para las devoluciones de llamada.