Skip to main content
이 문서는 AI 에이전트 섹션의 일부입니다.

왜 에이전트 배포가 중요한가?

노트북에서 프로토타입으로 동작하는 에이전트와, 실제 사용자가 접근할 수 있는 프로덕션 에이전트는 전혀 다릅니다. 프로덕션 배포에는 확장성, 모니터링, 보안, 버전 관리 가 필요합니다.
💡 Databricks에서 AI 에이전트를 배포한다는 것은, 에이전트를 Model Serving Endpoint 로 호스팅하여 REST API로 접근할 수 있게 만드는 것입니다. 배포된 에이전트는 웹 앱, 슬랙 봇, 내부 도구 등 다양한 채널에서 호출할 수 있습니다.

배포 아키텍처 개요

Databricks의 에이전트 배포는 MLflow + Unity Catalog + Model Serving 의 통합 구조로 동작합니다.

Step 1: 에이전트 모델 로깅

배포의 첫 단계는 에이전트를 MLflow 모델 로 로깅하는 것입니다. 이때 에이전트 코드, 의존성, 설정이 모두 함께 패키징됩니다.

mlflow.models.set_model() 사용법

에이전트 코드를 별도 Python 파일로 분리한 뒤, set_model()로 진입점을 지정합니다. 이 방식이 Databricks에서 권장하는 표준 패턴입니다. agent.py(에이전트 코드):
로깅 노트북(모델 등록):

의존성 관리

에이전트가 사용하는 모든 외부 패키지와 리소스를 명시해야 합니다.
💡 resources에 명시된 리소스들은 배포 시 자동으로 서비스 프린시펄(Service Principal)에게 필요한 권한이 부여됩니다. 수동으로 권한을 설정할 필요가 없습니다.

Step 2: Unity Catalog에 모델 등록

registered_model_name을 지정하면 MLflow가 자동으로 Unity Catalog에 모델을 등록합니다. 등록된 모델은 버전 관리, 접근 제어, 리니지 추적이 가능합니다.

모델 버전 관리