Supabase을(를) ElevenLabs 대화형 AI 음성 에이전트에 연결

실시간 데이터베이스 접근

• 실시간 대화 중 Supabase에 직접 API 호출
• 1초 미만 응답 속도의 즉각적인 데이터 조회
• 복잡한 SQL 쿼리 및 조인 지원
• 자주 조회되는 데이터에 대한 내장 캐싱

안전한 인증 및 권한 관리

• Supabase Auth 기반 JWT 인증
• 사용자별 데이터 접근을 위한 행 수준 보안(RLS)
• 역할 기반 권한의 API 키 관리
• 민감 정보 암호화 전송

Edge Function 통합

• 통화 중 커스텀 서버리스 로직 실행
• 다중 테이블 작업 및 외부 API 호출
• 복잡한 워크플로우를 위한 TypeScript/JavaScript 지원
• 최소 지연을 위한 글로벌 배포

다국어 데이터 지원

• 31개 이상 언어로 음성 상호작용
• 입력 언어와 상관없이 통합 데이터 쿼리
• 실시간 번역 기능
• 응답 시 문화적 맥락 보존

실시간 데이터 동기화

• 대화 중 실시간 데이터베이스 업데이트
• 사전 알림을 위한 웹훅 지원
• 데이터 변경에 따른 이벤트 기반 응답
• 기존 워크플로우와 자연스러운 통합

1단계: Supabase 접근 준비

Supabase 프로젝트 인증 정보 수집

• app.supabase.com에서 Supabase 대시보드 로그인
• 프로젝트 선택 또는 새 프로젝트 생성
• 왼쪽 사이드바에서 설정 > API로 이동
• 프로젝트 URL 복사 (예시: https://your-project.supabase.co
• 서버 작업용 Service Role Key 복사
• 공개 접근이 필요하다면 Anon Key 확인

Row Level Security(행 수준 보안) 설정

• Supabase에서 인증 > 정책 메뉴로 이동
• 에이전트가 접근할 테이블에 맞는 RLS 정책 설정
• Service Role Key에 필요한 권한이 있는지 확인
• SQL 에디터에서 샘플 쿼리로 정책 테스트

2단계: ElevenLabs 에이전트 설정

Supabase 인증 정보 안전하게 저장

• ElevenLabs 대화형 AI 대시보드로 이동
• 설정 > 시크릿 매니저로 이동
• SUPABASE_SERVICE_KEY 이름으로 새 시크릿 생성
• Supabase Service Role Key를 값으로 붙여넣기
• 프로젝트 URL로 SUPABASE_URL 이름의 시크릿 추가 생성

도구 설정 접근

• 대시보드에서 음성 에이전트 선택
• 도구(툴) 섹션으로 이동
• 새 도구 추가 클릭 후 데이터베이스 통합 생성

3단계: 데이터베이스 도구 정의

데이터베이스 쿼리 도구

• 이름: query_database
• 설명: Supabase 데이터베이스에서 데이터 조회
• 메서드: GET
• URL: Supabase 프로젝트 URL 뒤에 /rest/v1/table_name 입력
• apikey라는 헤더 추가 후 안전하게 저장된 SUPABASE_SERVICE_KEY 선택
• Authorization 헤더 추가 후 Bearer 토큰 옵션에서 SUPABASE_SERVICE_KEY 선택
• Content-Type 헤더에 application/json 값 추가

레코드 삽입 도구

• 이름: insert_record
• 설명: Supabase 데이터베이스에 새 레코드 생성
• 메서드: POST
• URL: Supabase 프로젝트 URL 뒤에 /rest/v1/table_name 입력
• apikey라는 헤더 추가 후 안전하게 저장된 SUPABASE_SERVICE_KEY 선택
• Authorization 헤더 추가 후 Bearer 토큰 옵션에서 SUPABASE_SERVICE_KEY 선택
• Content-Type 헤더에 application/json 값 추가
• Prefer 헤더에 return=representation 값 추가

레코드 업데이트 도구

• 이름: update_record
• 설명: Supabase의 기존 레코드 업데이트
• 메서드: PATCH
• URL: Supabase 프로젝트 URL 뒤에 /rest/v1/table_name 입력
• apikey라는 헤더 추가 후 안전하게 저장된 SUPABASE_SERVICE_KEY 선택
• Authorization 헤더 추가 후 Bearer 토큰 옵션에서 SUPABASE_SERVICE_KEY 선택
• Content-Type 헤더에 application/json 값 추가
• 레코드 선택을 위한 쿼리 파라미터 설정

레코드 삭제 도구

• 이름: delete_record
• 설명: Supabase 데이터베이스에서 레코드 삭제
• 메서드: DELETE
• URL: Supabase 프로젝트 URL 뒤에 /rest/v1/table_name 입력
• apikey라는 헤더 추가 후 안전하게 저장된 SUPABASE_SERVICE_KEY 선택
• Authorization 헤더 추가 후 Bearer 토큰 옵션에서 SUPABASE_SERVICE_KEY 선택
• 레코드 선택을 위한 쿼리 파라미터 설정

4단계: 에이전트 프롬프트 설정

시스템 프롬프트 업데이트

에이전트의 시스템 프롬프트에 데이터베이스 접근 안내 추가:

다음 도구를 사용해 Supabase 데이터베이스에 접근할 수 있습니다:

• query_database: 사용자가 데이터에 대해 물을 때 정보 조회에 사용
• insert_record: 사용자 입력을 바탕으로 새 항목 생성 시 사용
• update_record: 요청 시 기존 데이터 수정에 사용
• delete_record: 권한이 있을 때 레코드 삭제에 사용

insert, update, delete 작업 전에는 항상 사용자에게 데이터 변경을 확인하세요. 데이터 조회 시에는 자연스럽고 대화체로 정보를 전달하세요.

도구 설명 설정

각 도구별로 언제 사용하는지 명확하게 설명을 제공하세요:

• 쿼리 도구: 기존 데이터, 검색, 조회 질문에 사용
• 삽입 도구: 사용자가 새 정보 추가나 레코드 생성을 원할 때 사용
• 업데이트 도구: 사용자가 기존 데이터 변경을 요청할 때 사용
• 삭제 도구: 사용자가 정보 삭제를 원할 때 신중하게 사용

응답 처리 설정

에이전트가 데이터베이스 응답을 적절히 처리하도록 훈련하세요:

• 반환된 데이터를 파싱해 대화체로 전달
• 결과가 없을 때도 친절한 메시지로 안내
• 삽입 및 업데이트 성공 시 확인 메시지 제공
• 오류 발생 시 사용자 친화적인 언어로 안내