> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fim.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 실행 모드

> Standalone, Copilot, Hub — FIM One을 배포하는 세 가지 방법.

## 세 가지 모드

FIM One은 에이전트가 배포되고 사용되는 방식에 따라 결정되는 세 가지 모드로 작동합니다:

| 모드             | 설명                | 전달 방식                   | 예시                                        |
| -------------- | ----------------- | ----------------------- | ----------------------------------------- |
| **Standalone** | 범용 AI 어시스턴트       | Portal                  | 채팅, 검색, 코드 실행, 지식 기반 Q\&A                 |
| **Copilot**    | 호스트 시스템에 내장된 AI   | iframe / widget / embed | ERP 웹 UI에 내장된 "Finance Copilot"           |
| **Hub**        | 중앙 크로스시스템 오케스트레이션 | Portal / API            | 에이전트가 ERP를 쿼리하고, OA 승인을 확인하고, Lark를 통해 알림 |

진행 과정은 자연스럽습니다: Standalone으로 시작하고, Copilot으로 호스트 시스템에 내장한 다음, 크로스시스템 오케스트레이션을 위해 Hub를 설정합니다. Copilot은 내장된 상태로 계속 실행되며, Hub는 중앙 오케스트레이션 계층을 추가합니다.

## 모드 세부 정보

### 독립형 (0개 커넥터)

기본 모드입니다. FIM One은 완전한 기능의 AI 어시스턴트로 작동합니다:

* 기본 제공 도구: 웹 검색, Python 실행, 계산기, 파일 작업, 셸 명령
* RAG를 포함한 지식 베이스 (PDF, DOCX, Markdown, HTML, CSV)
* 복잡한 다단계 작업을 위한 동적 DAG 계획
* DAG 시각화를 포함한 실시간 스트리밍

외부 시스템 접근이 필요하지 않습니다. 일반적인 분석, 연구 및 코드 작업에 유용합니다.

### Copilot (내장형)

FIM One을 호스트 시스템의 웹 UI에 내장합니다. 에이전트는 사용자의 익숙한 인터페이스에서 함께 작동하므로 컨텍스트 전환이 필요 없습니다. Copilot 모드는 여러 커넥터를 사용할 수 있습니다(예: 호스트 시스템의 DB + 알림 서비스).

```mermaid theme={null}
flowchart LR
  subgraph Host["Host System (ERP / CRM / OA)"]
    Copilot["FIM One Copilot<br/>(iframe / widget)"]
  end
  Copilot -- Connectors --> DB["DB"]
  Copilot -- Connectors --> API["API"]
  Copilot -- Connectors --> Lark["Lark"]
```

예시:

* **재무 Copilot**: DB 커넥터를 통해 Kingdee(금蝶)에 연결 → 재무제표 조회, 분석 보고서 생성
* **계약 Copilot**: API 커넥터를 통해 계약 관리 시스템에 연결 → 계약 검색, 조항 추출, 위험 평가
* **HR Copilot**: API 커넥터를 통해 HR 시스템에 연결 → 직원 정보 조회, 통계 생성

에이전트는 Standalone 모드와 동일한 ReAct/DAG 엔진을 사용하지만, 이제 커넥터를 통해 실제 비즈니스 데이터에 액세스할 수 있습니다.

### Hub (중앙 오케스트레이션)

Hub는 중앙 인텔리전스 계층 역할을 하는 독립형 포털(또는 API)입니다. 단일 시스템에 내장되지 않으며, 대신 모든 시스템에 연결됩니다. 사용자는 Portal UI 또는 API를 통해 액세스합니다.

```mermaid theme={null}
flowchart LR
  ERP --> Hub["FIM One Hub<br/>(AI orchestration)"]
  Database --> Hub
  Lark --> Hub
  CRM --> Hub
  OA --> Hub
  CustomAPI["Custom API"] --> Hub
```

예시:

* "CRM에서 연체 계약 확인, ERP 결제와 교차 참조, Lark에서 재무팀에 알림"
* "OA 승인 완료 시, CRM에서 계약 상태 업데이트 및 감사 데이터베이스에 기록"
* "Salesforce에서 판매 데이터 조회, 비즈니스 DB를 사용하여 예측 생성, 경영진에게 요약 이메일 발송"

각 커넥터는 독립적인 브릿지입니다. 하나를 추가하거나 제거해도 다른 것에는 영향을 주지 않습니다.

## 전달 방법

| 전달                  | 설명                                             | 일반적인 모드            |
| ------------------- | ---------------------------------------------- | ------------------ |
| **Portal (Web UI)** | 기본 제공 Next.js 인터페이스                            | Standalone, Hub    |
| **API (headless)**  | HTTP/SSE 엔드포인트 (`/api/execute`, `/api/stream`) | Hub (프로그래밍 방식 액세스) |
| **iframe / Embed**  | 호스트 시스템 페이지에 주입됨                               | Copilot            |

전달 방법과 모드는 관련이 있지만 고정되지 않습니다: Hub에 API를 통해 액세스하거나 Portal을 통해 독립형 에이전트를 사용할 수 있습니다. 하지만 일반적인 패턴은 Hub의 경우 Portal, Copilot의 경우 embed입니다.

## 실행 엔진 (내부 구현)

내부적으로 FIM One은 두 가지 실행 엔진을 제공합니다:

| 엔진               | 최적 사용 사례  | 작동 방식                               |
| ---------------- | --------- | ----------------------------------- |
| **ReAct**        | 단일 복잡한 쿼리 | 도구를 사용한 Reason → Act → Observe 루프   |
| **DAG Planning** | 다단계 병렬 작업 | LLM이 종속성 그래프를 생성하고 독립적인 단계가 동시에 실행됨 |

```mermaid theme={null}
flowchart TD
  DAG["DAG Planning<br/>(orchestration layer)"]
  DAG --> step_1
  DAG --> step_2
  step_1 --> ReAct1["ReAct Agent"] --> Tools1["Tools"]
  step_2 --> ReAct2["ReAct Agent"] --> Tools2["Tools"]
  step_1 & step_2 --> step_3
  step_3 --> ReAct3["ReAct Agent"] --> Tools3["Tools"]
```

ReAct는 원자 단위이고 DAG는 오케스트레이션 계층입니다. 두 엔진 모두 세 가지 모드(Standalone, Copilot, Hub)에서 작동합니다. Hub 모드에서는 단일 DAG 단계가 다양한 시스템의 커넥터를 호출할 수 있습니다.

## 두 가지 실행 패러다임

FIM One은 작업을 수행하기 위한 두 가지 상호 보완적인 패러다임을 제공합니다:

| 패러다임            | 오케스트레이션                                | 최적 사용 사례                |
| --------------- | -------------------------------------- | ----------------------- |
| **에이전트 (Chat)** | LLM이 다음 단계를 동적으로 결정 (ReAct 또는 DAG)     | 탐색적 작업, 대화, 유연한 추론      |
| **워크플로우**       | 설계 시점에 정의된 고정 DAG (비주얼 에디터, 26개 노드 타입) | 승인 체인, 예약된 ETL, 다단계 자동화 |

**에이전트**는 작업이 개방형일 때 뛰어납니다 — "이번 분기 데이터를 분석하고 조치를 권장하세요." LLM이 즉시 계획하고 적응합니다.

**워크플로우**는 프로세스가 알려져 있고 반복 가능할 때 뛰어납니다 — "매주 월요일, ERP에서 송장을 가져오고, 규정 준수 검사를 실행하고, 예외를 검토자에게 라우팅하세요." 비주얼 에디터를 사용하면 노드(에이전트, 커넥터, KB, LLM, HTTP, 코드, 휴먼 승인, 서브워크플로우)를 고정 DAG로 연결할 수 있습니다.

두 패러다임은 자연스럽게 구성됩니다: 워크플로우는 고정 파이프라인 내에서 유연한 추론이 필요한 모든 단계에서 에이전트를 호출할 수 있습니다. 에이전트는 워크플로우를 직접 호출할 수 없습니다 — 관계는 일방향입니다.

<Tip>
  **어느 것을 선택할지:** 에이전트에 대해 매우 구체적이고 단계별 지침을 작성하고 있다면, 그 프로세스는 아마도 워크플로우에 속할 것입니다. 작업에 판단, 탐색 또는 예상치 못한 데이터에 대한 적응이 필요하면 에이전트로 유지하세요.
</Tip>