AI

Ask AI (Assistant)

대시보드의 Ask AI 어시스턴트로 프로젝트를 조회하고, 승인 후 콘텐츠·스키마·설정을 변경하는 방법을 설명합니다.

Ask AI는 Project 대시보드 오른쪽에 붙는 AI 어시스턴트입니다. 자연어로 질문하면 현재 Project의 Table, Contents, 설정, 사용량을 직접 조회해 답하고, 변경이 필요한 작업은 미리보기 카드를 보여준 뒤 승인한 경우에만 실행합니다.

사전 조건: Project 멤버여야 합니다. 대화는 AI.ASK.TOKENS 메트릭으로 크레딧을 사용합니다. 변경 작업은 대시보드에서 직접 할 때와 같은 권한 검사를 거칩니다.


열기와 대화 관리

  1. Project 화면 상단의 Ask AI 버튼을 클릭합니다. 패널이 오른쪽에 열리고 본문은 그만큼 줄어듭니다.
  2. 빈 화면의 빠른 프롬프트를 누르거나 입력창에 질문을 적고 Enter를 누릅니다. 파일(이미지, CSV, 텍스트)을 첨부할 수도 있습니다.
  3. 패널 헤더의 새 채팅으로 새 대화를 시작하고, 채팅 기록에서 이전 대화를 다시 열거나 이름 변경·보관·삭제할 수 있습니다.

어시스턴트는 지금 보고 있는 Table과 선택한 행을 알고 있습니다. Contents 목록에서 행을 체크한 뒤 "선택한 행을 발행해줘"처럼 말하면 그 행이 대상이 됩니다.


두 가지 동작 방식

구분 동작 예
바로 조회 질문 즉시 데이터를 읽어 답합니다. 데이터는 바뀌지 않습니다. "어떤 테이블이 API로 쓰기 가능해?"
승인 필요 변경 내용을 카드로 미리 보여주고 승인을 눌러야 실행합니다. 거절하면 아무것도 바뀌지 않습니다. "선택한 행 제목을 30자 이내로 다듬어줘"

답변 위의 작은 마커가 어시스턴트가 어떤 조회를 했는지 보여줍니다(예: 콘텐츠 검색 중 · 31개 행 일치). 마커가 빨간색이면 그 조회가 실패한 것이고, 어시스턴트는 보통 다른 방법으로 다시 시도합니다.


바로 조회할 수 있는 것

콘텐츠와 Table

할 수 있는 일 질문 예
Table과 컬럼, 카테고리 구조 "이 프로젝트 테이블 목록을 요약해줘"
조건에 맞는 행 검색, 행 전체 값 조회 "최근 7일 안에 발행된 글만 찾아줘"
행의 변경 이력과 두 버전 비교 "이 행의 버전 1과 현재를 비교해서 바뀐 필드만 보여줘"
변수와 번역(누락 언어 포함) "누락된 언어가 있는 번역 키를 알려줘"
프로젝트 점검 "프로젝트 상태를 점검해서 문제점을 체크리스트로 알려줘"

설정과 운영

할 수 있는 일 질문 예
Public API 설정(테이블별 엔드포인트, 임베딩·BM25, OpenAPI URL) "어떤 테이블이 API로 읽기/쓰기 가능한지 보여줘"
OpenAPI 스펙 URL과 오퍼레이션 목록 "OpenAPI 스펙에서 blogs 테이블 오퍼레이션만 보여줘"
API 레퍼런스와 클라이언트 코드 작성 "이 테이블을 페이지네이션으로 가져오는 TypeScript 예제를 작성해줘"
API 키(마스킹), 멤버와 역할, Webhook 목록 "API 키 현황과 멤버를 한 줄씩 요약해줘"
Webhook 전송 로그 "문의 웹훅의 실패한 전송만 최근 5개 보여주고 원인을 추정해줘"
Agent 목록과 설정 "에이전트가 어떤 모델과 지시문을 쓰는지 알려줘"
Vector 동기화 상태 "테이블별 벡터 동기화 상태를 알려줘"

파일

할 수 있는 일 질문 예
파일 검색(종류, 크기, 업로드일) "지난주에 올린 이미지 파일을 보여줘"
임시 다운로드 링크(기본 5분 만료) "가장 최근에 올린 로고 파일 링크를 줘"
파일 사용처와 미사용 파일 "어떤 행에서도 쓰지 않는 파일이 몇 개고 총 용량은 얼마야?"
이미지·PDF 텍스트 추출(OCR) "스캔한 계약서 파일의 텍스트를 추출해줘"

OCR은 업로드할 때 추출해 둔 텍스트가 있으면 크레딧 없이 바로 보여주고, 없으면 그 자리에서 실행하며 FILE.OCR.CALLS 1회가 기록됩니다.

크레딧, 로그, 문서

할 수 있는 일 질문 예
크레딧 잔액과 결제 주기 사용량 "이번 결제 주기 크레딧 사용량을 요약해줘"
비용 추정 "Docs 31개 행을 전부 임베딩하면 크레딧이 얼마나 들어?"
API 로그 분석(요청 수, 오류, 경로, 키별 비교) "최근 7일 API 로그를 분석해줘"
Onttle 공식 문서 검색 "Webhook 설정 방법을 문서에서 찾아줘"

문서 질문에는 답변 아래에 번호가 붙은 출처 목록이 표시되고, 각 항목은 해당 문서 섹션으로 연결됩니다. 답변 안의 [1], [2]가 그 번호입니다.


승인이 필요한 작업

작업 설명
목록 필터 보고 있는 Contents 목록에 필터·정렬을 적용합니다. 데이터는 바뀌지 않아 바로 적용됩니다.
Table 설계, 컬럼 추가·수정 새 Table 제안, 기존 Table에 컬럼 추가, 컬럼 이름·옵션 변경. 컬럼 타입은 바꿀 수 없습니다.
Table 수정 이름, slug, 설명, 읽기 전용 변경
행 생성·수정·삭제 붙여넣은 텍스트나 CSV 임포트, 선택한 행 일괄 수정, 삭제. 잠긴 행은 건너뜁니다.
Table 콘텐츠 모두 삭제 한 Table의 잠기지 않은 모든 행을 삭제합니다(truncate). 카드에 삭제될 행 수가 표시되며, 소유자와 관리자만 실행할 수 있고 되돌릴 수 없습니다.
발행·잠금·복원 발행/발행 취소/보관, 잠금/해제, 이전 버전으로 복원
Table 콘텐츠 모두 발행·발행 취소 한 Table의 발행되지 않은 모든 행을 발행하거나, 발행된 모든 행을 초안으로 되돌립니다. 카드에 변경될 행 수가 표시되며, 잠긴 행은 건너뛰고 보관된 행은 발행하지 않습니다.
카테고리·변수·번역 샘플 생성, 값 수정, 카테고리 값 추가·이름 변경·삭제, 변수 복원
API 설정 테이블 엔드포인트 켜기/끄기, 임베딩·BM25, OpenAPI URL
Webhook 생성 URL, 대상 Table, 이벤트(CREATED, UPDATED, DELETED)

카드에는 변경 전·후 값, 대상 행 수, 삭제처럼 되돌릴 수 없는 작업의 경고가 함께 표시됩니다. 실행이 끝나면 적용된 수와 실패한 수가 같은 카드에 남습니다.

AI 생성은 두 단계로 승인합니다

빈 셀 채우기, 샘플 행 생성, 번역 채우기를 AI에 맡기면 다음 순서로 진행됩니다.

  1. 생성 승인: "AI 크레딧이 사용됩니다"라는 카드가 뜹니다. 승인하면 값을 생성만 하고 저장하지 않습니다.
  2. 저장 승인: 생성된 값이 행 수정·행 생성·번역 수정 카드에 변경 전·후로 표시됩니다. 여기서 승인해야 저장됩니다.

몇 개 셀 정도는 어시스턴트가 직접 값을 써서 바로 저장 카드를 보여주고, 행이 많거나 "AI로 채워줘"라고 하면 위 두 단계를 거칩니다. 생성 단계는 AI.GENERATION.TOKENS를 사용합니다.


빠른 프롬프트

새 채팅의 빈 화면에는 자주 쓰는 요청이 버튼으로 준비되어 있습니다. 행을 선택한 상태면 선택한 행에 대한 항목이 먼저 보입니다.

  • 목록 필터, 테이블 설계, 일괄 수정, 행 임포트
  • 샘플 카테고리·변수·번역, 누락 번역 채우기, SEO 항목 채우기
  • API 코드, 로그 설명, 크레딧과 사용량, 프로젝트 점검
  • 문서에 질문하기
  • (행 선택 시) 선택한 행의 빈 칸 채우기, 수정, 발행, 삭제, 변경 이력

잘 쓰는 요령

  • Table 이름이나 slug로 말하세요. "docs 테이블에서…"처럼 적으면 어시스턴트가 알아서 찾습니다. 여러 Table이 있을 때는 어느 Table인지 되묻습니다.
  • 행은 체크해 두고 말하세요. "선택한 행"이 가장 정확합니다.
  • 한 번에 하나의 주제. 조회와 변경을 한 질문에 섞으면 변경 카드가 뒤로 밀릴 수 있습니다.
  • 승인 전에 카드를 확인하세요. 어시스턴트는 승인 결과가 돌아오기 전에는 "변경했다"고 말하지 않습니다.

사용량과 한도

사용 메트릭
Ask AI 대화 AI.ASK.TOKENS
AI 생성(빈 셀, 샘플 행, 번역 채우기) AI.GENERATION.TOKENS
OCR 실행 FILE.OCR.CALLS

크레딧이 부족하면 대화가 시작되지 않고 안내가 표시됩니다. 변경 이력·복원은 버전 기록이 포함된 플랜에서만 동작합니다.


주의 사항

  • AI 답변에는 오류가 있을 수 있습니다. 숫자와 설정 값은 카드와 대시보드 화면으로 확인하세요.
  • 질문과 조회 결과는 AI 모델에 전달됩니다. 개인 식별 정보, 결제 정보, 비밀번호나 토큰이 들어 있는 컬럼은 질문 대상에서 빼세요.
  • API 키는 항상 마스킹된 형태(접두사와 마지막 4자리)로만 표시되며, 어시스턴트는 전체 키를 보여주지 않습니다.

다음 단계

  • 콘텐츠 관리 — 화면에서 직접 쓰는 AI 콘텐츠 추가와 Auto-fill
  • Agents — Chats API에서 답변을 생성하는 Agent 설정
  • 지표 종류 — AI 토큰과 OCR 메트릭의 크레딧 차감 방식