프로젝트 및 에이전트 설정

프로젝트 위치, 에이전트 애플리케이션, 에이전트 수준에서 다양한 설정을 제어할 수 있습니다.

프로젝트 위치 설정

프로젝트 위치 설정은 특정 프로젝트 및 위치 내의 모든 에이전트 애플리케이션 및 에이전트에 적용됩니다. 프로젝트 위치 설정을 수정하려면 에이전트 목록으로 이동하여 프로젝트 및 위치를 선택한 다음 설정 버튼을 클릭합니다.

다음과 같은 프로젝트 및 위치 설정을 사용할 수 있습니다.

  • VPC 서비스 제어: 참고 VPC 서비스 제어.

  • 허용된 출처: VPC 서비스 제어를 사용하는 경우 에이전트 애플리케이션 외부에서 호출할 때 허용되는 HTTP(S) 엔드포인트를 정의할 수 있습니다. 이를 통해 에이전트는 프록시를 통해 트래픽을 라우팅하지 않고도 외부 서비스와 안전하게 상호작용할 수 있습니다. 이는 외부 요청을 할 수 있는 모든 유형의 도구 및 콜백에 적용됩니다. VPC 서비스 제어가 사용 설정되지 않은 경우 (기본값) 모든 엔드포인트가 허용됩니다. VPC 서비스 제어가 사용 설정된 경우 허용된 출처 목록에 추가되지 않는 한 엔드포인트가 허용되지 않습니다.

    엔드포인트는 스키마 및 선택적 포트를 포함하여 정확히 일치하는 URL (와일드 카드 없음)로 제공됩니다. 예:

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

    허용된 출처를 관리하려면 다음 Identity and Access Management 권한이 필요합니다.

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

    이러한 권한은 에이전트 데이터를 수정하는 사용자와 별도로 보안 관리자 또는 프로젝트 관리자에게 부여되도록 설계되었습니다. 이러한 권한은 CES Admin 사전 정의된 역할에 포함되어 있습니다.

    이 설정은 프로젝트 및 위치 수준에서 적용되어 조직이 모든 에이전트 애플리케이션의 허용된 출처를 제어할 수 있도록 합니다. 이 설정은 에이전트 애플리케이션별 또는 에이전트별로 적용할 수 없습니다. API를 사용하여 SecuritySettings EndpointControlPolicy를 업데이트할 수도 있습니다.

에이전트 애플리케이션 설정

전역 에이전트 애플리케이션 설정을 수정하려면 다음 단계를 따르세요.

  1. 빌더의 오른쪽에 있는 설정 아이콘을 클릭합니다.

다음과 같은 에이전트 애플리케이션 설정을 사용할 수 있습니다.

  • 기본:
    • 상호작용:
      • 전역 모델: 개별 에이전트가 재정의하지 않는 한 사용되는 기본 모델입니다. 일부 모델은 텍스트 또는 음성에 최적화될 수 있습니다.
      • 언어 컨트롤:
        • 기본 언어: 이 언어로 모든 대화를 시작합니다.
        • 추가 언어: 에이전트 애플리케이션이 다국어인 경우 추가 언어를 제공합니다. 에이전트 애플리케이션은 사용자 입력과 일치하도록 언어를 자동으로 전환합니다.
        • 지원되지 않는 언어 처리: 지원되지 않는 언어로 사용자 입력이 제공되면 에이전트 애플리케이션에서 사용자에게 입력을 한 번 반복하도록 요청합니다. 새 입력도 지원되지 않는 언어를 사용하는 경우 수행해야 할 작업을 선택합니다.
    • 행동:
      • 음성: 음성 합성에 사용되는 음성입니다.
      • 주변 소리: 에이전트가 재생하는 배경 소리입니다.
      • 응답 길이: 에이전트의 자세한 정도를 조정합니다.
      • 사용자 중단 허용: 최종 사용자가 에이전트를 중단하도록 허용합니다.
      • 중단 시 조정: 사용 설정하면 에이전트는 사용자가 모든 내용을 듣지 못했을 수 있다고 판단하여 응답을 조정하려고 시도합니다.
      • 대체 동작:
        • 재시도: AI가 응답을 생성할 수 없는 경우 에이전트가 재시도해야 하는 횟수를 선택합니다.
        • 에이전트 응답: 에이전트는 재시도하기 전에 최종 사용자에게 권한을 요청합니다. 여기에서 기본 응답을 제공할 수 있습니다. 기본 응답이 제공되지 않으면 기본 응답이 사용됩니다.
        • 대체: 에이전트가 마지막 재시도 후 계속할 수 없는 경우 어떻게 되는지 결정합니다.
    • 에이전트 세부정보:
      • 표시 이름: 에이전트 애플리케이션의 표시 이름입니다.
      • 에이전트 잠금: 변경사항이 적용되지 않도록 합니다.
      • 메모: 에이전트 애플리케이션에 대한 사람이 읽을 수 있는 설명입니다. 모델로 전송되지 않습니다.
  • 고급:
    • 음성:
      • 무음 시간 제한: 사용자 입력을 기다린 다음 다시 참여하도록 안내합니다.
      • 주변 소리 볼륨 게인: 주변 소리 볼륨을 조정합니다.
      • 키패드 입력: 전화 통화에 듀얼 톤 다중 주파수 (DTMF) 를 설정합니다. 기본적으로 사용 설정됩니다.
    • 로깅:
      • 로그 및 데이터 공유: 로그 및 에이전트 개발을 위한 에이전트 전체 설정을 관리합니다.
        • 상호작용 데이터: 더 심층적인 통찰력 과 참조를 위해 상호작용 데이터를 저장합니다. 여기에는 시뮬레이션된 상호작용과 실시간 상호작용, 추적 데이터 등이 포함됩니다. 사용 중지하면 에이전트와의 이전 대화를 볼 수 없습니다.
      • 수정 사용 설정: 민감한 정보를 자동으로 찾아 삭제합니다.
      • Cloud Logging 사용 설정: 로그를 Cloud Logging으로 자동 스트리밍합니다.
      • 로그를 BigQuery로 내보내기: 맞춤 분석을 위해 로그를 BigQuery로 내보냅니다.
      • 오디오 녹음: 오디오 파일의 Cloud Storage 버킷 위치를 출력합니다.
    • 도구:
      • 실행 모드: 도구 호출을 병렬 또는 순차적 순서로 실행합니다.
    • 전역 요청 사항: 에이전트 애플리케이션의 모든 에이전트에 대한 요청 사항입니다. 이러한 요청 사항을 사용하여 에이전트 전반에서 안정적인 ID 또는 개성을 설정할 수 있습니다.

에이전트 설정

루트 또는 하위 에이전트별 설정을 수정하려면 다음 단계를 따르세요.

  1. 에이전트 제목 상자에서 컨텍스트 메뉴를 클릭합니다.
  2. 구성 수정 을 선택합니다.

다음과 같은 루트 및 하위 에이전트 설정을 사용할 수 있습니다.

  • 에이전트 이름: 에이전트의 표시 이름입니다. 스네이크 케이스를 사용합니다.
  • 모델: 에이전트에 사용되는 모델 입니다.
  • 설명: 에이전트에 대한 설명입니다. 이 설명은 에이전트 애플리케이션의 다른 에이전트에 제공됩니다.
  • 커스텀 코드: 콜백 코드를 제공합니다.