작동 방식
이 페이지의 내용
에이전트를 사용하는 데 이 페이지를 반드시 읽을 필요는 없습니다. 하지만 조직 내 누군가로부터 *"데이터가 실제로 어디에 저장되나요?"*라는 질문을 받는 담당자라면 이 페이지를 참고하세요.
시스템의 구조
세 가지 부분:
- 장치 — 에이전트와 지원 서비스가 실행되는 곳입니다. 에이전트의 모든 데이터(대화, Memory, 파일, 위키, 설정)가 여기에 저장됩니다. 시설 내의 AI Agent Processor(Physical Agent)이거나 선택한 지역의 Cloud Agent Instance(Cloud Agent)입니다.
- Performance Hub — 관리 평면입니다. 에이전트 추가, 액세스 제어, 예산, 백업 구성, 업데이트가 모두 여기에서 결정되어 장치로 전달됩니다.
- 장치가 사용하는 클라우드 서비스 — AI 모델(시설의 Model Router 계정을 통해), 선택한 지역의 암호화된 백업 스토리지, 푸시 알림 전달.
핵심 원칙: 데이터는 에이전트 장치에 유지되며, 클라우드는 두뇌, 백업 및 연결성을 제공합니다.
Physical Agent 및 Cloud Agent
두 종류의 에이전트는 동일한 소프트웨어를 실행하며 Performance Hub에서 동일한 방식으로 관리됩니다. 차이점은 장치의 위치입니다:
| Physical Agent | Cloud Agent | |
|---|---|---|
| 실행 환경 | 시설의 AI Agent Processor (하드웨어) | 추가 시 선택한 지역의 Cloud Agent Instance |
| 추가 방법 | 일련번호 또는 QR 코드로 페어링 | Cloud Agent 추가에서 실행 — 페어링 불필요 |
| 데이터 저장 위치 | 물리적으로 제어하는 하드웨어 | 선택한 Cloud region의 인스턴스 디스크 |
| 브라우저 연결 | 현장에 있을 때는 직접 연결(로컬 네트워크), 그 외에는 클라우드 릴레이 | 클라우드 릴레이 |
| 비용 | 제품의 일부로 AI Agent Processor 제공 | 프로비저닝한 인스턴스 크기 및 리소스에 따라 과금 |
| 오류 발생 시 | 하드웨어 교체 및 백업에서 복원 | 인스턴스 제거 후 백업에서 새 Cloud Agent 실행 |
Cloud Agent의 백업은 기본적으로 에이전트와 동일한 지역으로 이동하므로, 사용자가 다른 스토리지 지역을 선택하지 않는 한 데이터는 한 곳에 유지됩니다.
아웃바운드 전용 네트워킹
Physical Agent는 사용자의 네트워크에서 생성되는 일반적이고 암호화된 인터넷 연결인 아웃바운드 연결만 수행합니다. 열린 인바운드 포트, 포트 포워딩 또는 방화벽 변경이 전혀 필요하지 않습니다. 네트워크에서 웹 브라우징이 가능하다면, 해당 장치는 정상적으로 작동할 수 있습니다.
또한 Performance Hub가 장치에 도달하는 방식도 이와 같습니다. 장치는 Performance Hub 릴레이로 아웃바운드 연결을 맺고 해당 보안 연결을 유지하며, 관리 및 원격 액세스가 이를 통해 다시 전달됩니다. Cloud Agent도 동일한 방식으로 연결됩니다. 장치가 고정되어 있는 릴레이는 Device management의 Relay region에 표시됩니다.
브라우저가 에이전트에 도달하는 방식
AI Agent 모듈을 열면 장치에서 제공하는 에이전트 자체의 웹 인터페이스가 표시됩니다. 브라우저는 사용 가능한 가장 최적의 경로를 통해 연결되며, 모듈 상단에 해당 경로가 표시됩니다 (예: 릴레이 도시가 포함된 Cloud relay):
| 헤더 표시 | 경로 | 조건 |
|---|---|---|
| Direct (local network) | 브라우저 → 장치, LAN을 통한 직접 연결 | Physical Agent와 동일한 네트워크에 있는 경우 — 가장 빠름 |
| Cloud relay | 브라우저 → 가장 가까운 릴레이 → 장치 | 원격에 있는 경우 — 어디서나 접속하는 일반적인 경로 |
| via Performance Hub | 브라우저 → Performance Hub → 장치 | 릴레이 경로를 사용할 수 없는 경우의 대체 경로 |
모듈은 이 순서대로 자동으로 경로를 시도하며, 사용자가 직접 선택할 필요는 없습니다. 세 가지 경로 모두 종단간 암호화되며, Performance Hub 신원 정보가 함께 전달되므로 에이전트는 항상 대화 상대가 누구인지 파악할 수 있고 모든 경로에서 액세스 제어가 동일하게 적용됩니다.
장치 세션에는 모듈을 열 때 Performance Hub에서 발급한 수명이 짧은(short-lived) 자격 증명이 사용됩니다. 장치에 대한 상시 비밀번호는 존재하지 않으며, Performance Hub에서 권한이 취소되면 현재의 단기 세션이 만료되거나 페이지가 새로 고쳐질 때 적용됩니다.
에이전트가 AI 모델을 가져오는 방식
에이전트의 지능은 시설의 Model Router 계정을 통해 제공되는 AI 모델에서 비롯됩니다. 장치에서는 소형 프록시 서비스가 에이전트와 클라우드 사이에 위치합니다:
- 에이전트에는
auto모델 선택 기능이 사전 설정되어 있습니다. Performance Hub는 각 요청을 적절한 모델로 라우팅하며, 사용자가 별도로 재설정하지 않아도 개선 사항이 자동으로 적용됩니다. - 장치는 Performance Hub에서 발급한 **단기 자격 증명(short-lived credentials)**을 사용하여 인증합니다. 장치에 저장되는 장기 API 키는 없습니다 — 하드웨어를 도난당하더라도 유효하게 유지되는 정보가 없습니다.
- 모든 요청은 에이전트 고유의 사용 키(spend key)를 기준으로 측정되며, 이를 통해 Budgets & limits가 신뢰에 의존하지 않고 Performance Hub 측에서 중앙 집중식으로 적용됩니다.
에이전트가 Performance Hub 데이터에 도달하는 방식
비즈니스 데이터에 대한 에이전트의 액세스도 MCP(Model Context Protocol)를 통해 동일한 방식으로 작동합니다:
- 에이전트의 MCP 호출은 동일한 보안 연결을 통해 동일한 단기 자격 증명으로 인증되어 Performance Hub로 전송됩니다.
- Performance Hub 측에서 장치는 Connecting to Performance Hub에서 부여한 범위와 권한을 정확히 가진 서비스 계정으로 작동합니다. 모든 호출은 해당 권한을 기준으로 중앙에서 승인됩니다.
- 권한을 변경하거나 취소하면 즉시 적용됩니다. 장치는 데이터에 대한 독자적인 자격 증명을 보유하지 않습니다.
백업 흐름
장치의 백업 서비스는 매시간 암호화된 스냅샷을 생성하여 사용자가 선택한 지역의 클라우드 스토리지에 직접 업로드합니다. 업로드 전에 장치에서 암호화되며, 암호화 키는 시설용 Performance Hub에서 보관합니다(백업 자체에는 절대 저장되지 않음). 백업은 증분 방식이며 중복이 제거되므로 매시간 실행되어도 부담이 없습니다. 자세한 내용은 Backups을 참조하세요.
업데이트 작동 방식
장치는 전체 단위로 업데이트되는 관리형 소프트웨어 스택을 실행합니다:
- 새 릴리스는 장치에 자동으로 스테이징되지만, 사용자가 Update now를 클릭하거나 시간을 Schedule할 때까지 대기합니다. 장치가 예고 없이 임의로 재시작되는 일은 없습니다.
- 업데이트는 데이터가 아닌 소프트웨어를 교체합니다. 에이전트의 상태는 모든 업데이트 과정에서 유지되는 영구 데이터 영역에 저장됩니다.
- 배너를 전혀 조작하지 않더라도 장치는 현재 버전을 계속 실행합니다. 다만, 모든 업데이트는 출시 전에 엄격한 테스트를 거치며 최신 상태를 유지해야 최신 기능과 수정 사항을 항상 이용할 수 있으므로 최신 버전 유지를 권장합니다.
인터넷이 끊긴 경우
- 시설에 있고 Physical Agent를 사용하는 경우: Direct (local network) 경로가 계속 작동하므로, 연결이 복구될 때까지 AI 모델을 호출할 수 없어(즉, 새로운 요청을 처리할 수 없어) 장치가 생각할 수는 없지만 LAN을 통해 에이전트를 열고 사용할 수 있습니다.
- 백업 및 알림은 큐에 대기했다가 연결이 복구되면 재개됩니다.
- Performance Hub 관리 기능(서랍, 설정, 업데이트)은 장치가 온라인 상태여야 하며 자동으로 재연결됩니다.
하드웨어가 고장난 경우
백업이 해결책입니다. 장치가 고장 나더라도 클라우드 복원 지점은 계속 탐색 및 다운로드할 수 있으며, Replace this device를 통해 이전 장치의 최신 백업에서 새로운 유닛을 복구할 수 있습니다(일반적으로 최대 1시간 분량의 상태만 손실됨). Cloud Agent도 추가할 때 Restore from a backup을 사용하여 동일한 방식으로 시드(seed)할 수 있습니다. Restore & recovery를 참조하세요.
관련 페이지
- The hardware
- Security & privacy — 보안 검토 관점에서 정리한 동일한 내용
- Connecting to Performance Hub
- Backups