AIP Analyst Workshop 위젯
Workshop 모듈에 AIP Analyst 위젯을 넣으면 애플리케이션의 변수와 분석 문맥을 연결하고 결과를 다른 위젯에서 사용할 수 있습니다. 검색 범위, 사용할 도구, 모델과 화면 요소를 각각 구성합니다.
기본 구성
Custom system prompt는 기본 Analyst 시스템 프롬프트 뒤에 추가할 지시문입니다. 분석 주제, 응답 방식과 업무 규칙을 적으며 고정값 또는 Workshop 변수를 사용할 수 있습니다.
Select default model에서 Specific Model을 선택하면 모델을 직접 지정하거나 모델 RID가 들어 있는 문자열 변수를 연결합니다. 해당 모델의 사용량을 이 프로젝트에 귀속할 수 없으면 대체 모델을 사용합니다. Model Categories를 선택하면 Fast, Balanced, Smart에 연결할 모델과 기본 범주를 설정합니다.
Suggested prompts는 빈 대화에 표시할 질문 목록입니다. 고정 목록이나 애플리케이션 상태에 따라 바뀌는 변수를 연결합니다.
입력 문맥
| 입력 | 동작과 제약 |
|---|---|
| User message | 변수 값이 바뀌면 그 값을 사용자 메시지로 보내고 분석을 자동 시작합니다. |
| Object sets | 지정한 순서로 Input 1, Input 2 등의 이름을 붙입니다. 각 집합의 객체 유형도 기본으로 추가합니다. 대화가 시작되면 재설정하거나 새 대화를 만들 때까지 집합 변경을 반영하지 않습니다. |
| Notepad documents | 문서 목록을 문맥에 추가합니다. |
| Skills | 스킬 이름과 적용 조건을 시스템 프롬프트에 넣고 관련될 때 전체 지시를 읽습니다. |
| Enable user skills | 그룹에서 상속한 스킬을 포함한 사용자 스킬 모음을 제공하며 입력란에 관리 버튼을 표시합니다. |
| Object types / Functions / Actions | 객체 유형, 함수, 액션 목록을 추가합니다. 액션별 Should auto-submit action을 켜면 에이전트가 자율 제출하며, 끄면 사용자가 제출할 폼이 표시됩니다. |
| Workshop modules / Datasets | 지정 모듈이나 데이터셋을 추가합니다. |
| Media items | 미디어 집합과 개별 항목 RID를 지정합니다. 이미지 및 PDF 유형만 지원합니다. |
| Recent resources context / Favorite resources context | 로드 시 사용자의 최근 리소스 또는 즐겨찾기를 추가합니다. |
객체 집합, Notepad 문서, 객체 유형, 함수, 액션, Workshop 모듈, 데이터셋과 미디어 항목에는 선택적으로 Title and description을 지정하여 리소스를 제공한 이유와 사용 방법을 설명할 수 있습니다.
출력 변수
| 출력 | 전달하는 값 |
|---|---|
| Last object set | 분석에서 마지막으로 생성한 객체 집합입니다. 특정 객체 유형으로 한정할 수 있습니다. |
| Last user message / All user messages | 마지막 질문 또는 전체 질문 목록입니다. |
| Last assistant message / All assistant messages | 마지막 응답 또는 전체 응답 목록입니다. |
| All Vega chart specs | 해석이 끝난 Vega-Lite 규격 문자열 목록입니다. 데이터가 포함된 스냅샷이므로 실시간 뷰가 아닙니다. |
| All messages | 도구 호출을 포함한 전체 메시지입니다. 구성된 입력 문맥 포함 여부를 선택할 수 있습니다. 도구 사용 및 도구 결과 메시지의 JSON 형태에는 하위 호환성 보장이 없습니다. |
| Selected cited object | 가장 최근에 선택한 인라인 인용의 객체입니다. 이 변수를 설정하면 기본 인라인 참조 동작을 대체합니다. |
| Selected cited media reference | 가장 최근에 선택한 미디어 인용입니다. mediaItemRid, mediaSetRid, mediaItemReadToken 필드를 가진 구조체여야 하며 기본 참조 동작을 대체합니다. |
| Active tab agent running | 활성 탭의 에이전트가 실행 중인지 나타내는 불리언입니다. 로딩 표시나 입력 비활성화에 사용할 수 있습니다. |
분석 이벤트에 액션 연결
액션은 구성한 그대로 실행되므로 모든 필수 매개변수를 지정해야 합니다. 두 이벤트 모두 성공 여부를 알리는 토스트를 표시하도록 할 수 있으며 토스트에서 실행 취소를 제공할 수도 있습니다.
On user message send는 사용자가 메시지를 보낼 때마다 실행됩니다. 위젯이 Text input value와 Chat session ID를 제공합니다. 실제 메시지 제출 전에 실행하므로 이 시점의 All user messages에는 새 메시지가 아직 없습니다.
On agent stopped는 활성 탭의 에이전트가 멈출 때 실행되며 위젯이 Chat session ID를 제공합니다. 기록, 감사나 후속 작업에 사용할 수 있습니다. 이 액션이 실행되는 동안에는 새 사용자 메시지를 보낼 수 없습니다.
도구와 검색 범위
Customize default enabled tools에서 기본 도구를 고릅니다. Hide configure tools button과 함께 사용하면 사용자가 구성한 도구 범위로 제한할 수 있습니다.
Filter to Ontology는 직접 선택한 온톨로지나 RID 문자열 변수로 범위를 정합니다. Filter to object type groups는 고정 RID 목록이나 변수로 지정합니다. Filter to projects는 프로젝트를 지정하며 일반 폴더는 무시합니다. Filter to object type statuses, Filter to object type visibilities는 상태와 표시 수준을 제한합니다. 이 필터는 Object type search와 Object search에 적용됩니다.
Default semantic search threshold는 객체 집합 도구의 의미 기반 검색 임계값이며 0부터 1 사이입니다. 검색 범위는 데이터 권한을 대신하지 않으며 직접 제공한 입력 문맥과도 구분해야 합니다.
사용할 수 있는 도구와 각 도구의 동작은 AIP Analyst 기능에서 확인할 수 있습니다.
위젯을 열기 전 사유 확인
플랫폼 관리자는 Checkpoints에서 AIP Analyst를 여는 동작에 사유 확인을 구성할 수 있습니다. 설정이 적용되는 사용자는 요구된 확인이나 사유 제출을 마쳐야 위젯을 열 수 있습니다. 위젯 접근에 해당하는 유형은 AIP Analyst widget opened이며, 유형별 적용 동작과 조직 및 공간 범위를 함께 확인합니다.
화면 구성
| 설정 | 효과 |
|---|---|
| Customize empty state | 빈 대화의 제목과 설명을 고정 텍스트나 문자열 변수로 지정합니다. 그림에는 사용자 색상의 아이콘 또는 업로드 이미지를 사용합니다. |
| Customize input placeholder | 빈 입력란 안내문을 정합니다. |
| Hide input area | 직접 메시지를 입력하지 못하게 합니다. User message 변수는 계속 메시지를 보낼 수 있습니다. |
| Hide input resources section | 빈 상태의 미리 제공된 리소스 영역을 숨깁니다. |
| Hide tab header | 탭 머리글과 새 탭 생성을 없애며 대화 분기도 비활성화합니다. |
| Hide PDF export button | PDF 내보내기를 숨깁니다. 머리글만 숨긴 경우 내보내기 버튼은 아래 행으로 이동합니다. |
| Hide Quiver export button / Hide Contour export button | 각각의 내보내기를 숨깁니다. |
| Hide Notepad export button | Export to Notepad와 Summarize in Notepad를 모두 숨깁니다. |
| Hide outline sidebar | 개요와 그래프 사이드바를 숨깁니다. |
| Hide configure tools button | 도구 변경 버튼을 숨겨 기본 도구만 사용하게 합니다. |
| Hide record audio button | 음성 녹음 버튼을 숨깁니다. |
| Add context options | 문맥 메뉴에 나타나는 객체 유형, 객체 집합, 데이터셋, 미디어 집합, Notepad, 파일 업로드 옵션을 정합니다. URL 붙여 넣기, 끌어놓기, 메시지 텍스트에서 불러오는 문맥과 사용 가능한 도구에는 영향을 주지 않습니다. |
| Hide token estimator | 토큰 추정기를 숨깁니다. |
| Hide model selector | 사용자가 구성된 모델 또는 범주를 바꾸지 못하게 합니다. |
| Compact tool views | 추론과 도구 활동을 접힌 상태 요약으로 묶고 질문 및 텍스트 응답은 유지합니다. |
| Hide thinking details | 진행 표시를 유지하면서 추론 내용을 숨깁니다. |
| Default collapse tools | 도구 결과 대신 도구 이름만 표시하는 접힌 상태를 기본으로 사용합니다. |
| Hide upgrade to media set panel | 업로드 파일을 미디어 집합으로 전환하라는 안내를 숨깁니다. |
저장과 세션 수명
Analysis saving을 활성화하면 분석 저장과 로드 방식을 정할 수 있습니다. 플랫폼 인스턴스에서 분석 저장을 금지했다면 이 설정을 구성할 때 오류가 표시됩니다.
Save location은 새 분석을 저장할 폴더이며 직접 선택하거나 RID 문자열 변수를 연결합니다.Require save location을 켜면 사용자가 위치를 바꾸지 못합니다. 폴더 권한이 없으면 저장할 수 없습니다.Loaded analysis source는 불러올 Compass 분석 리소스입니다. 고정값이나 변수로 지정합니다.Unsaved analysis header는 미저장 분석의 머리글이며 고정 텍스트나 문자열 변수입니다.Only show analyses created in this module은 이 모듈에서 만든 분석만 발견하게 합니다. 고정값이나 불리언 변수를 사용하며 임베드 모듈 안에서 소비되는 경우 최상위 모듈을 기준으로 합니다.
저장 분석을 열면 위젯의 도구 구성이 저장 분석 설정보다 우선합니다. 저장 분석에 이미 있는 대화에는 위젯 입력이 적용되지 않으며 새 대화를 만들거나 재설정해야 적용됩니다.
기본적으로 브라우저 탭이 열린 동안 임시 대화 상태를 메모리에 보관합니다. 같은 모듈의 탭이나 접힌 영역에서 위젯을 숨겼다가 다시 표시해도 대화, 문맥과 도구 결과가 유지됩니다. 새로고침하거나 브라우저 탭을 닫으면 미저장 상태가 사라집니다.
Clear chat on navigation을 켜면 위젯이 페이지에서 제거될 때 임시 상태를 버리고 다시 나타날 때 새 세션을 시작합니다. Reset key에 연결한 변수 값이 바뀌어도 새 세션으로 재설정합니다.
구성 방향
관련 리소스를 미리 제공하면 탐색 시간을 줄일 수 있습니다. 업무 지침과 제안 질문을 설정하고 사용자에게 필요하지 않은 고급 제어는 숨깁니다. 메시지 입력 변수를 다른 화면 이벤트에 연결하고 출력 변수를 시각화나 필터에 연결할 수 있습니다. 이벤트 액션은 메시지 저장이나 후속 업무를 연결할 때 사용하되 실행 순서와 필수 입력을 확인합니다.