변수

변수는 런타임 대화 데이터를 저장하고 검색하는 데 사용됩니다. 이를 통해 에이전트는 대화 턴 전반에서 정보를 기억하여 컨텍스트에 맞는 상호작용을 할 수 있습니다.

변수 데이터

변수에는 다음 데이터가 있습니다.

  • 이름: 스네이크 표기법을 사용하는 변수 이름
  • 유형: 변수 유형:
    • 텍스트: 문자열 값
    • 숫자: 숫자 값
    • 예/아니요: 불리언 값
    • 맞춤 객체: 객체의 스키마를 제공합니다.
    • 목록: 변수 목록입니다. 쉼표로 구분된 목록으로 값을 입력합니다.
  • 기본값: 변수의 기본값
  • 설명: 변수에 대한 설명입니다(선택사항).

안내의 변수 참조

안내에서 이름으로 변수를 참조하려면 중괄호({variable_name})를 사용하세요.

변수 확인

모델의 프롬프트를 생성할 때 CX Agent Studio는 변수 참조를 실제 런타임 값으로 바꿉니다.

변수 값 업데이트

에이전트 자체는 변수 값을 업데이트할 수 없지만 도구와 콜백은 변수 값을 업데이트할 수 있습니다.

에이전트 변수는 변수를 업데이트하는 데 사용할 수 있는 ADK 컨텍스트 상태를 사용합니다. context라는 전역 변수를 Python 도구 코드에서 사용할 수 있습니다. 예를 들어 Python 도구에서 다음 문을 사용하여 ADK 기능을 통해 변수를 업데이트할 수 있습니다.

context.state["variable_name"] = value