system overview

Onyx를 하나의 팀용 AI 입구로 이해하기

Onyx는 모델, 사내 지식, 검색, Agent, 도구 호출을 한 화면의 업무 흐름으로 묶는 오픈소스 플랫폼입니다. 이 페이지는 각 lesson을 읽기 전에 무엇이 어디에 속하는지 먼저 잡아 주는 개요입니다.

누가 무엇을 결정하나

1

도입 검토자

Lite 또는 Standard 중 어떤 범위로 평가할지 정하고, 검증한 것과 검증하지 않은 것을 구분합니다.

2

관리자

로그인 방식, LLM Provider, 사용자 권한, 비용 경계를 정합니다.

3

지식/자동화 담당자

문서 연결, 검색 품질, Agent가 호출할 도구와 멈출 기준을 확인합니다.

데이터와 작업이 움직이는 순서

A

배포 범위 선택

작게 볼 때는 Lite, 문서검색과 커넥터까지 볼 때는 Standard로 시작합니다.

B

모델과 인증 연결

사용자가 들어올 수 있고, 선택한 모델이 실제 응답을 반환해야 다음 검토가 의미 있습니다.

C

지식과 도구 연결

문서 출처와 도구 권한을 확인한 뒤, Agent가 해도 되는 작업과 안 되는 작업을 나눕니다.

D

운영 점검

로그, 업데이트, 장애 대응, 사용자 안내 기준을 남겨 팀 운영으로 넘어갈 수 있는지 판단합니다.

초보자가 헷갈리기 쉬운 점

  • Lite 평가를 Standard 운영 검증으로 착각하기
  • 검색 결과 존재를 답변 품질 보장으로 착각하기
  • Agent 도구 호출 가능을 운영 승인으로 착각하기

좋은 확인 습관

  • 각 단계마다 문서, 설정, 로그, 화면 중 하나의 근거를 남깁니다.
  • 현장 환경에서 다시 확인해야 할 값은 lesson의 검증 경계에 남깁니다.
  • 모르면 먼저 `beginner.html`을 읽고, 그 다음 Workflow map에서 해당 흐름을 고릅니다.