# OpenAI 연동 및 대시보드

## OpenAI 연동 및 대시보드

조직의 OpenAI 사용 현황을 한 화면에서 분석합니다. **API Platform (Admin)** 과 **ChatGPT Workspace (Compliance)** 두 영역의 키를 각각 등록하여 비용·토큰·ChatGPT 활동을 함께 볼 수 있습니다. 매일 새벽 자동 동기화되며 필요 시 수동 새로고침도 가능합니다.

***

### 1. 연동하기

{% hint style="info" %}
**필요한 준비물**

* **API Platform**: OpenAI Platform → **Settings → Organization → Admin keys**에서 발급한 `sk-admin-`으로 시작하는 **Admin API Key** 1개.
* **ChatGPT Workspace**: ChatGPT Enterprise/Edu → **Settings → Compliance → API Key**에서 발급한 **Compliance API Key** 1개. (선택)

두 키 중 하나만 등록해도 동작합니다. 두 키를 모두 등록하면 비용과 ChatGPT 활동을 교차로 분석할 수 있습니다.
{% endhint %}

**단계 1: 연동 설정 화면 열기**

1. 사이드바에서 **설정** > **연동 관리**로 이동합니다.
2. **AI 도구** 섹션의 **OpenAI** 카드를 클릭합니다.

**단계 2: Admin API Key 입력 (API Platform)**

1. 상단 **API Platform (Admin)** 섹션을 엽니다.
2. 안내: *"OpenAI Platform → Settings → Organization → Admin keys에서 발급받은 키를 입력해주세요."*
3. `Admin API Key` 입력 (placeholder: `sk-admin-...`).
4. **`연동하기`** 버튼을 클릭합니다.

{% hint style="warning" %}
**Key 형식 확인** `sk-admin-`으로 시작하지 않으면 *"Admin API Key는 sk-admin-으로 시작해야 합니다."* 힌트가 표시됩니다. 일반 API Key (`sk-proj-...`, `sk-...`) 나 Service Account Key 로는 연동되지 않습니다.
{% endhint %}

**단계 3: Compliance API Key 입력 (ChatGPT Workspace, 선택)**

1. 하단 **ChatGPT Workspace (Compliance)** 섹션을 엽니다.
2. 안내: *"ChatGPT Enterprise/Edu → Settings → Compliance → API Key에서 발급받은 키를 입력해주세요."*
3. Compliance API Key 를 입력하고 **`연동하기`** 를 클릭합니다.

{% hint style="info" %}
**Compliance API 가능 여부** ChatGPT Enterprise·Edu 플랜에서만 제공됩니다. Plus·Team 플랜은 API Platform 연동만 가능합니다.
{% endhint %}

***

### 2. 대시보드 접근

1. 사이드바의 **`AI`** > **`OpenAI`** 메뉴를 클릭합니다.
2. 또는 **AI 메인 페이지** (`/ai`) 에서 OpenAI 카드의 **`열기`** 버튼을 누릅니다.
3. 헤더에 *"OpenAI — {조직명} · 마지막 동기화: {시각}"* 이 표시되면 연동이 정상 동작 중입니다.

**헤더 우측 버튼:**

* **`새로고침`** (SplitButton 메인) — 즉시 수동 동기화를 실행합니다.
* **`연동 설정`** (SplitButton 드롭다운) — 설정 > 연동 관리 페이지로 이동합니다.

***

### 3. 탭 구성

OpenAI 대시보드는 두 개의 메인 탭으로 구성됩니다.

| 탭                     | 활성화 조건                  | 내용                                  |
| --------------------- | ----------------------- | ----------------------------------- |
| **API Platform**      | Admin API Key 연동 시      | 총 멤버 / 이번 달 비용 / 총 토큰 + 프로젝트·모델별 차트 |
| **ChatGPT Workspace** | Compliance API Key 연동 시 | 총 메시지 / 총 토큰 + ChatGPT 사용량 추이       |

기간은 **오늘 기준 최근 30일**로 고정되어 있습니다.

{% hint style="info" %}
한 쪽만 연동된 경우, 미연동 탭에는 *"Admin API 연동이 필요합니다"* 또는 *"Compliance API 연동이 필요합니다"* 안내가 표시되며 해당 데이터는 비활성화됩니다.
{% endhint %}

***

### 4. API Platform 탭

**KPI 카드 (3장)**

| 카드          | 의미                                     |
| ----------- | -------------------------------------- |
| **총 멤버**    | 연동된 OpenAI 조직의 총 멤버 수                  |
| **이번 달 비용** | 이번 달 누적 API 비용 (USD). 서브텍스트로 활성 프로젝트 수 |
| **총 토큰**    | 30일 누적 입력·출력 토큰 합계 (K/M/B 단위)          |

**차트**

* **프로젝트별 비용 (수평 바차트)** — 각 프로젝트의 30일 누적 비용을 `$금액 / %` 로 표시합니다. 비용이 큰 순서대로 정렬됩니다.
* **모델별 토큰 사용량 (테이블)** — 모델별 입력/출력 토큰과 요청 수를 비교합니다.

**멤버 목록 테이블**

* 이름, 이메일, 역할 (Owner/Admin/Reader), 가입일, 소속 프로젝트 수
* 대기 중인 초대도 함께 표시됩니다

***

### 5. ChatGPT Workspace 탭

**KPI 카드**

| 카드        | 의미                               |
| --------- | -------------------------------- |
| **총 메시지** | 30일 누적 ChatGPT 메시지 수             |
| **총 토큰**  | 30일 누적 ChatGPT 토큰 사용량 (K/M/B 단위) |

ChatGPT 사용량 추이 차트와 사용자별 활동 분포가 함께 제공됩니다. Codex 세션·코드 변경·인증 이벤트도 같은 탭에서 확인할 수 있습니다.

***

### 6. 자동 동기화 주기

* **조직·멤버·프로젝트** — 연동 직후 즉시 동기화
* **비용·토큰 사용량** — OpenAI API 제공 주기에 따라 최대 24시간 지연
* **ChatGPT 활동·Codex·인증 이벤트** — Compliance 배치 주기에 따라 별도 동기화

수동으로 즉시 동기화가 필요하면 헤더의 **`새로고침`** 버튼을 사용하세요.

***

### 7. 자주 묻는 질문

**Q: Admin Key 만 등록했는데 ChatGPT 사용량이 보이지 않습니다.**

ChatGPT 사용량은 Compliance API Key 가 별도로 필요합니다. ChatGPT Enterprise/Edu → Settings → Compliance → API Key 에서 발급한 키를 등록해주세요.

**Q: 비용이 0 으로 나옵니다.**

연동 직후에는 OpenAI API 제공 주기에 따라 최대 24시간 지연될 수 있습니다. 시간이 지난 후에도 0 이라면 해당 기간에 실제 API 호출이 없었거나, Admin Key 권한 부족일 수 있습니다.

**Q: Anthropic 대시보드와 다른 점은?**

OpenAI 는 두 종류 키 (Admin / Compliance) 가 분리되어 있고, 탭 구조도 키 종류별로 나뉩니다. Anthropic 은 단일 Admin Key 로 모든 데이터 (비용·사용량·Claude Code 생산성) 를 동기화합니다.

**Q: 키를 교체하고 싶습니다.**

연동 관리 페이지에서 해당 섹션의 **연동 해제** 후 새 키로 다시 연동하세요. Admin 과 Compliance 는 각각 독립적으로 해제·재연동할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/ai/openai-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.