본문으로 건너뛰기
Documentation

테넌트 온보딩

마지막 게시: 2026-07-21 19:00

테넌트 온보딩

테넌트 온보딩에서는 새 회사가 Echo AI를 사용할 때 필요한 식별자, 회사 프로필과 기본 실행 구성을 등록합니다. 회사별 데이터와 용어가 섞이지 않도록 tenantId를 먼저 확정한 뒤 모델·프롬프트와 도구를 연결합니다.

개요

회사 프로필은 모델이 운영 회사를 정확히 설명하도록 시스템 프롬프트에 추가됩니다. 프로필이 없으면 모델이 학습 데이터에 의존해 회사를 추측하지 않고, 회사 소개가 아직 구성되지 않았다고 답하도록 보호 문구가 적용됩니다.

준비 정보

항목 설명
Tenant ID API, DB와 도구 호출에서 사용하는 데이터 격리 키입니다.
Company Code 회사 프로필 파일과 구성을 찾는 코드입니다.
Company Name 사용자에게 표시할 공식 회사명입니다.
Description 회사의 사업과 서비스 범위를 설명합니다.
Terminology 회사에서 사용하는 업무 용어와 코드 매핑입니다.
Default Profile 기본 프롬프트와 모델 구성입니다.

등록 절차

  1. 기존 테넌트와 겹치지 않는 Tenant ID를 정합니다.
  2. 공식 회사명과 확인된 소개 내용을 등록합니다.
  3. 기본 모델과 프롬프트 프로필을 연결합니다.
  4. 필요한 MCP 서버와 읽기 도구를 연결합니다.
  5. 회사 용어를 proposed 상태로 등록하고 검토합니다.
  6. 시험 사용자로 로그인해 회사 소개와 업무 질문을 확인합니다.
  7. 데이터 조회가 해당 테넌트 범위만 반환하는지 검증합니다.

회사 프로필 작성

회사 프로필에는 확인 가능한 사실만 기록합니다. 제품, 주요 사업과 조직 명칭을 간결하게 작성하고 홍보 문구나 추정 정보를 넣지 않습니다. 변경 시 적용 회사 코드와 배포 경로를 확인합니다.

격리 검증

다른 테넌트에서 같은 사용자 질문을 실행해 결과와 도구 인수가 분리되는지 확인합니다. tenantId가 없는 요청을 허용하는 경로가 있다면 기본 테넌트 적용 규칙을 문서화하고 외부 호출에서는 명시적으로 전달합니다.

운영 전 확인

  • 기본 프롬프트와 모델이 활성 상태인지 확인합니다.
  • API 키와 인증 정책이 테넌트에 맞게 적용되는지 확인합니다.
  • 용어 카탈로그에는 승인된 항목만 서비스되는지 확인합니다.
  • 쓰기 도구는 승인 흐름 없이 실행되지 않는지 확인합니다.
  • 턴·사용량 조회가 다른 테넌트 데이터를 포함하지 않는지 확인합니다.

프로필이 적용되지 않을 때

Company Code와 프로필 파일 위치를 확인합니다. 프로필이 없거나 읽기에 실패하면 추측 답변을 허용하지 않는 보호 문구가 붙는 것이 정상입니다. 프로필을 수정한 뒤에는 새 턴에서 시스템 프롬프트가 갱신됐는지 확인합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.