변수의 데이터 유형 이해
변수 사용의 실제적인 측면을 살펴보기 전에 Botpress에서 사용 가능한 다양한 데이터 유형에 익숙해지도록 하겠습니다.
- 끈: 문자열은 문자, 숫자 또는 특수 문자로 구성될 수 있는 텍스트를 저장하는 데 사용됩니다. 일반적으로 사용자 이름이나 AI 생성 메시지를 저장하는 데 사용됩니다.
- 부울: 부울은 true 또는 false의 두 가지 값만 가질 수 있습니다. 이는 사용자가 재방문 고객인지 또는 사용자가 다른 것을 묻기를 원하는지 여부와 같은 이진 정보를 저장하는 데 이상적입니다.
- 숫자: 이름에서 알 수 있듯이 숫자 변수는 정수 또는 소수 자릿수가 있는 숫자일 수 있는 숫자 값을 저장하는 데 사용됩니다. 전화번호, 지역번호 및 기타 숫자 데이터를 저장하는 데 유용합니다.
- 날짜: 날짜 변수는 ISO 8601 날짜/시간 형식을 사용합니다. 단일 날짜 또는 날짜와 시간을 나타냅니다.
- 물체: 객체 변수는 사전이나 맵과 유사한 키-값 쌍의 모음입니다. 이는 사용자 프로필이나 API 호출 결과와 같은 복잡한 데이터 구조를 저장하는 데 유용합니다.
- 정렬: 배열은 유사한 변수의 컬렉션을 저장하는 데 사용됩니다. 문자열이나 개체를 보유할 수 있으므로 사용자의 과거 메시지를 저장하거나 사용자가 선택할 수 있는 옵션을 제공하는 등 다양한 사용 사례에 다목적으로 사용할 수 있습니다.
- 열거형: 이는 미리 정의된 선택 사항이 제한된 변수입니다. 요일이나 음식 메뉴에 사용 가능한 항목을 저장하는 것과 같은 시나리오에 적합합니다.
- 무늬: 패턴 변수는 정규식(Regex)을 활용하여 특정 단어나 숫자를 일치시키는 데 사용할 수 있는 특수 패턴을 저장합니다. 계좌 번호나 항공편 번호를 저장하는 데 편리합니다.
변수 범위 이해
Botpress에는 다양한 유형의 변수가 포함되어 있으며 챗봇 흐름에서 액세스할 수 있는 위치에 따라 달라집니다. 가장 제한된 것부터 가장 넓은 것까지 다양한 변수 범위를 살펴보겠습니다.
워크플로우 변수
이러한 변수는 단일 또는 동일한 워크플로 내에서 정의되고 사용됩니다. AI 작업 출력 저장, 질문에 대한 사용자 답변 저장, API 호출 데이터 정리 등 일회용 흐름에 탁월합니다.
워크플로 변수를 생성하려면 다음 단계를 따를 수 있습니다.
1 단계. '탐색기' 메뉴에서 적절한 작업 흐름을 선택합니다.
2 단계. 워크플로 편집기의 빈 영역을 두 번 클릭하면 검사기 패널이 열립니다.
3단계. 변수 이름을 지정하고 변수의 데이터 유형을 선택한 다음 '추가' 버튼을 클릭하여 변수를 만듭니다.
'추가 설정' 섹션에서 변수에 기본값(초기)을 추가할 수 있습니다.
입력 및 출력 워크플로 변수
정보를 교환하기 위해 워크플로에는 입력 및 출력 변수가 있을 수 있습니다. 입력은 외부 소스나 다른 워크플로에서 정보를 받는 데 사용되는 반면, 출력은 외부 소스나 다른 워크플로에 정보를 제공합니다. 이를 통해 봇 내에서 보다 유연한 통신 및 데이터 교환이 가능해집니다.
입력 변수를 표시하려면 다음 단계를 따를 수 있습니다.
1 단계. 워크플로 내부에 변수를 만듭니다.
2 단계. 검사기 패널에서 워크플로의 항목 노드를 클릭하여 변수를 선택합니다.
출력 변수를 표시하기 위해 다음 단계를 따를 수 있습니다.
1 단계. 워크플로 내부에 변수를 만듭니다.
2 단계. 검사기 패널에서 워크플로의 종료 노드를 클릭하여 변수를 선택합니다.
세션 변수
모든 흐름에서 이러한 변수에 액세스할 수 있지만 단일 대화에만 액세스할 수 있습니다. 채팅 기록, 가상 장바구니에 수집된 항목, API 호출의 임시 데이터 등 대화 전반에 걸쳐 사용되는 데이터를 저장하는 데 이상적입니다.
세션 변수를 생성하려면 다음 코드를 작성하면 됩니다.
세션.변수이름 = '안녕하세요 여러분!' ;텍스트 카드에서 변수를 사용하려면 중괄호로 닫아야 합니다. 예: {{세션.변수 이름}} .
사용자 변수
사용자 변수는 대화 사이에 사용자를 따르므로 챗봇과의 여러 상호 작용에서 데이터가 지속될 수 있습니다. 개인 정보, 과거 대화의 태그, 언어 기본 설정 등 시간이 지나도 사용자와 관련된 정보를 저장하는 데 적합합니다.
사용자 변수를 생성하려면:
1 단계. 왼쪽 상단에 있는 Botpress 아이콘에서 'Chatbot 설정'을 엽니다.
2 단계. 탭에서 '변수'를 선택합니다.
3단계. 이름을 지정하고 데이터 유형을 지정하여 사용자 변수를 정의합니다.
@user.variablename 또는 {{user.variablename}}을 사용하여 텍스트 카드에서 '사용자' 변수를 참조할 수 있습니다.
봇 변수
챗봇의 모든 사용자는 모든 대화에서 이러한 변수에 액세스할 수 있습니다. API 호출에 대한 엔드포인트 저장, 봇의 버전 번호 또는 이름과 같은 개발자 정보 및 구성을 저장하는 데 자주 사용됩니다.
Bot 변수를 생성하려면 다음 단계를 따르세요.
1 단계. 왼쪽 상단에 있는 Botpress 아이콘을 클릭하여 “Chatbot 설정”을 선택합니다.
2 단계. 탭에서 '변수'를 선택합니다.
3단계. 봇 변수의 이름과 데이터 유형을 지정합니다.
사용자 변수와 마찬가지로 @bot.variablename 또는 bot.variablename을 사용하여 카드의 봇 변수를 참조할 수 있습니다.
구성 변수
이는 특별한 유형의 보안 봇 변수입니다. 클라우드 대시보드에서 관리할 수 있으며 봇을 열 필요가 없습니다. 구성 변수는 API 토큰, 개인 IP 주소 또는 데이터베이스 자격 증명과 같은 민감한 정보를 저장하는 데 이상적입니다.
구성 변수를 생성하려면 다음을 수행하십시오.
1 단계. 왼쪽 상단에 있는 Botpress 아이콘에서 'Chatbot 설정'을 엽니다.
2 단계. '변수' 탭을 클릭하세요.
3단계. 구성 변수를 추가하고 해당 이름과 값을 제공합니다.
코드의 구성 변수에 액세스하려면 'env.key'를 사용할 수 있습니다. 여기서 'key'는 검색할 구성 변수 이름을 나타냅니다.
코드에서 변수 사용
코드에서 변수를 사용할 때는 중괄호 '{{ }}' 또는 @ 기호가 필요하지 않습니다. 코드의 변수에 액세스하는 구문은 'variabletype.variablename' 패턴을 따릅니다. 예를 들어:
암호:
- 워크플로우.전화번호
- session.userAcctId
- 사용자.이름
- 봇.엔드포인트
- env.api키
변수에 값을 할당하거나 코드에서 업데이트할 수 있습니다. 그러나 오류를 방지하려면 할당된 값이 변수의 데이터 유형과 일치하는지 확인하는 것이 중요합니다.
결론
변수는 Botpress의 역동적이고 개인화된 상호 작용의 구성 요소입니다. 다양한 데이터 유형을 사용하고 가변 범위를 이해함으로써 개발자는 강력한 기능을 갖춘 챗봇을 만들 수 있습니다. 사용자 정보를 저장해야 하는지 여부에 관계없이 Botpress의 API로 연결하거나 워크플로와 변수 간에 데이터를 전달하면 필요한 유연성과 제어가 제공됩니다.