챗봇에서 앱 명령 사용하기

명령(Command)은 사용자의 애플리케이션 안에서 실행되므로 현재 화면과 애플리케이션 상태에 접근할 수 있습니다. 예를 들어 지도 화면을 특정 위치로 이동할 수 있습니다. 앱이 명령을 선언하고 제공해야 챗봇 도구로 연결할 수 있습니다. Workshop의 Button Group, Metric Card와 App Pairing 위젯도 명령을 제공하는 앱의 동작을 호출할 수 있습니다.

추가와 구성

Chatbot configuration > Add tool > Commands를 선택하고 Search commands...에서 하나 이상의 명령을 추가합니다. 같은 명령에 서로 다른 지시를 적용하려면 여러 번 선택할 수 있습니다.

명령 도구를 사용하는 챗봇의 세션 보존 기간은 비활동 24시간 후 만료되도록 자동 설정됩니다. 명령 도구의 세부 구성은 베타 기능이며 인터페이스가 바뀔 수 있습니다.

추가한 명령을 선택하면 구성 대화상자가 열립니다. Show more에서 선택적 설정, 입력과 실행 동작을 확인합니다. Additional documentation에는 기본 도구 설명에 더할 문맥을 적습니다. 예를 들어 기존 임시 지도 지형이 새 지형과 관련되지 않으면 그리기 전에 Remove all features를 호출하도록 지시할 수 있습니다.

입력 재정의

기본적으로 필수 매개변수는 Instructions와 사용자 질문을 바탕으로 챗봇이 정합니다. 선택적 매개변수도 필요하면 값을 정할 수 있습니다. Add parameter override로 특정 매개변수를 선택하고 다음 방식을 지정합니다.

예를 들어 Draw polygon의 Fill pattern이나 Stroke width를 고정할 수 있습니다.

실행 승인

Asks for user approval before execution은 기본으로 켜져 있습니다. 사용자가 명령 페이로드를 검토하고 Reject 또는 Approve를 선택한 뒤 실행합니다. 끄면 질문에 따라 수동 확인 없이 실행합니다.

업무 데이터를 바꾸거나 정보를 공유하는 명령에는 승인 검토가 권장됩니다. 승인 없이 실행하면 잘못되거나 지나치게 넓은 범위의 명령이 바로 적용될 수 있습니다. 목적과 페이로드를 확인할 수 있게 구성합니다.

앱과 연결하여 시험하기

명령을 제공하는 앱을 별도 브라우저 창에서 열고 Chatbot Studio 옆에 배치합니다. Choose an app to pair with... > Pair에서 해당 앱을 선택한 뒤 질문으로 명령 동작을 확인합니다. 확인 후 저장하고 게시하여 Assist나 Workshop의 Chatbot 위젯에 제공합니다.

App Pairing은 열려 있는 앱을 자동 발견합니다. 여러 인스턴스와 연결하려면 Discovered 옆 Add로 연결 Group을 만듭니다. 실행할 앱에 연결되어 있지 않으면 챗봇이 연결할 앱을 선택하도록 요청합니다.

함수로 게시한 챗봇을 Automate처럼 명령을 지원하지 않는 환경에서 실행하면 명령 도구를 무시합니다. 서버 실행에서 클라이언트 화면 명령이 수행된다고 가정해서는 안 됩니다.

Assist와 Workshop 배치

Studio 왼쪽 로켓 아이콘의 Usage에서 AIP Assist를 켜고 오른쪽 위 Publish를 선택합니다. Assist의 Chat with an AIP Chatbot에서 선택하면 대상 앱과 자동 연결됩니다. 여러 앱의 도구가 있지만 연결되지 않은 앱이 있으면 열린 탭에서 대상을 선택하라는 요청이 표시됩니다.

Workshop에는 AIP Chatbot 위젯과 Iframe 위젯으로 대상 앱을 나란히 배치할 수 있습니다. 같은 모듈의 챗봇과 iframe 앱은 자동 연결되며 관련 명령은 해당 iframe 앱을 대상으로 실행됩니다.