문서 목차
AkashiQ v0.1.0 · SAMANDA AI
SAMANDA 사용법
패널 열기, 질문 입력, 대화 이력 관리, 음성 입력 사용 방법
QUANTUM C&S
패널 열기
화면 상단 헤더의 SAMANDA 버튼을 누르면 우측에서 패널이 열립니다. 어느 화면에서든 사용할 수 있습니다.
질문하기
- 하단 입력창에 한글 또는 영어로 질문을 입력합니다.
- 전송하면 응답이 스트리밍으로 표시됩니다.
- 응답 위에 호출된 도구가 표시됩니다.
처음 열면 추천 질문이 제시됩니다. 무엇을 물어볼 수 있는지 감을 잡는 데 사용하세요.
후속 질문
같은 세션에서는 대화 맥락이 유지되므로 이전 답변을 가리키는 질문이 가능합니다.
사용자: 최근 등록된 데이터셋 알려줘
SAMANDA: (3건 표시)
사용자: 두 번째 것 컬럼 구조 보여줘
질문을 구체적으로
같은 의도라도 표현에 따라 결과 차이가 큽니다.
| 덜 좋은 질문 | 더 좋은 질문 |
|---|---|
| "데이터 보여줘" | "품질 관련 데이터셋 중 최근 7일 안에 갱신된 것 알려줘" |
| "실패한 거 있어?" | "오늘 실패한 수집 작업과 오류 메시지 알려줘" |
| "이거 이상해" | "이 테이블에서 필수 컬럼이 비어 있는 행이 몇 건인지 확인해줘" |
도구 호출 확인
응답 위의 도구 호출 항목을 펼치면 다음을 볼 수 있습니다.
- 호출된 도구 이름
- 전달한 파라미터
- 반환된 원본 결과
응답 내용이 의심스러울 때 가장 먼저 확인할 곳입니다. 모델이 요약하는 과정에서 생기는 오해를 원본으로 바로 확인할 수 있습니다.
대화 이력
패널의 이력에서 이전 대화 목록을 열 수 있습니다.
| 항목 | 의미 |
|---|---|
| 제목 | 첫 질문 요약 |
| 마지막 활동 | 최근 메시지 시각 |
항목을 선택하면 그 대화로 전환되고, 새 메시지는 같은 대화에 이어집니다.
대화 삭제
이력에서 대화를 삭제할 수 있습니다. 확인 절차를 거치며, 삭제한 대화는 복구할 수 없습니다.
첨부 파일
파일을 첨부해 질문할 수 있습니다. 문서 내용을 기준으로 질문하거나, 데이터 파일의 구조를 확인할 때 사용합니다.
⚠️ 주의
첨부하는 파일도 사내 데이터 취급 정책을 따릅니다. 등급이 높은 자료를 첨부할 때는 사내 규정을 확인하세요.
음성 입력과 읽어주기
- 입력창의 마이크로 음성 입력을 시작합니다. 인식된 내용이 입력창에 채워집니다.
- 응답을 음성으로 들을 수 있습니다. 다시 누르면 정지합니다.
브라우저의 음성 기능을 사용하므로 지원 브라우저에서만 동작하고, 마이크 권한 허용이 필요합니다.
안전 장치
| 장치 | 동작 |
|---|---|
| 권한 상속 | 사용자가 볼 수 없는 데이터는 응답에 등장하지 않습니다 |
| 마스킹 유지 | 민감 컬럼은 마스킹된 값으로 응답에 포함됩니다 |
| 감사 기록 | 모든 도구 호출이 사용자 명의로 기록됩니다 |
| 변경 동작 제한 | 데이터를 바꾸는 동작은 사용자 확인 후에만 수행합니다 |
자주 겪는 상황
| 상황 | 확인 |
|---|---|
| 데이터가 없다고 답함 | 실제로 없는지, 권한 밖인지 구분 필요. 도구 호출 결과를 확인하세요 |
| 답변이 사실과 다름 | 도구 호출 원본을 확인하고, 필요하면 Compute에서 직접 조회 |
| 음성 입력이 동작하지 않음 | 브라우저 지원 여부와 마이크 권한 확인 |
| 이전 대화가 보이지 않음 | 다른 계정으로 로그인했는지 확인. 대화는 사용자별로 분리됩니다 |