SAMANDA 소개

SAMANDA 는 AkashiQ에 탑재된 AI 에이전트입니다. 일반 챗봇과 다른 점은 답을 생성하는 것이 아니라 AkashiQ의 실제 API를 호출해 결과를 가져와 답한다는 점입니다.

무엇을 할 수 있나

질문 예	내부 동작
"최근 등록된 데이터셋 알려줘"	데이터셋 검색 → 목록 반환
"이 테이블 상위 10건 보여줘"	쿼리 실행 → 표 반환
"오늘 실패한 수집 작업 있어?"	수집 작업 상태 조회 → 요약
"어제 이 데이터에 누가 접근했어?"	감사 로그 조회 → 요약
"이 배치의 일탈 이력 정리해줘"	품질 기록 · 문서 조회 → 요약

동작 구조

[ 사용자 질문 ]
      ↓
[ SAMANDA 패널 ]
      ↓
[ 에이전트 서비스 ] ── 시스템 프롬프트 + 사용자 권한 + 대화 맥락
      ↓
[ 도구 호출 판단 ]
      ↓
[ AkashiQ 내부 API 호출 ] ── 데이터셋 · 카탈로그 · 수집 · 쿼리 · 자산 · 품질 · 거버넌스
      ↓
[ 결과를 종합해 응답 ] ── 스트리밍으로 표시

세 가지 요소로 구성됩니다.

1. 언어 모델 — 질문 해석과 응답 생성
2. 도구(MCP) — 모델이 호출할 수 있는 AkashiQ 내부 기능 모음
3. 대화 기억 — 세션별 대화 이력 보관

권한을 그대로 따릅니다

가장 중요한 특성입니다. SAMANDA는 질문한 사용자의 권한으로 도구를 호출합니다.

• 사용자가 볼 수 없는 데이터셋은 응답에도 나타나지 않습니다.
• 마스킹된 컬럼은 마스킹된 상태로 응답에 포함됩니다.
• 접근 권한이 없는 문서는 참조하지 않습니다.
• 모든 도구 호출은 사용자 명의로 감사 로그에 기록됩니다.

AI를 통해 권한을 우회하는 경로가 생기지 않도록 설계했습니다.

도구 호출을 볼 수 있습니다

응답에는 어떤 도구를 어떤 인자로 호출했는지 함께 표시됩니다. 펼치면 전달된 파라미터와 반환된 원본 결과를 확인할 수 있습니다.

"왜 이렇게 답했는지"를 사용자가 검증할 수 있어야 실제 업무에 쓸 수 있다고 보았습니다. 답변만 보이는 AI는 확인할 방법이 없습니다.

기타 특성

특성	설명
스트리밍 응답	생성되는 대로 표시됩니다
대화 맥락 유지	같은 세션에서 이전 답변을 참조하는 후속 질문이 가능합니다
대화 이력	이전 대화를 다시 열 수 있습니다
추천 질문	처음 사용 시 예시 질문이 제시됩니다
첨부 파일	파일을 첨부해 질문할 수 있습니다
음성 입력 · 출력	브라우저 음성 기능을 사용합니다

한계와 주의사항

⚠️ 주의

• 응답은 참고 자료입니다. 중요한 판단은 원본 데이터를 직접 확인하세요.
• 복잡한 SQL은 의도와 다르게 생성될 수 있습니다. Compute에서 직접 실행해 검증하세요.
• 외부 인터넷 검색은 수행하지 않습니다. 사내 데이터만 다룹니다.
• 데이터를 변경하는 동작은 보수적으로 처리하며, 사용자 확인 없이 임의로 수행하지 않습니다.

다음 단계

• SAMANDA 사용법 — 패널 사용 방법
• 활용 예시 — 실제 질문 예시