> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/ai/openai-dashboard.md).

# OpenAI 연동 및 대시보드

## OpenAI 연동 및 대시보드

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

***

### 1. 연동하기

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

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

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

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

1. 사이드바에서 **설정** > **연동 관리**로 이동합니다.
2. **AI 도구** 섹션의 **OpenAI** 카드를 클릭합니다.
3. 화면 우측 상단의 **`연동 가이드 보기`** 버튼을 누르면 OpenAI 키 발급 절차를 정리한 외부 가이드 문서가 새 탭으로 열립니다.

연동 화면은 위쪽 **API Platform (Admin)** 카드와 아래쪽 **ChatGPT Workspace (Compliance)** 카드 두 장으로 구성됩니다. 각 카드를 따로 연동합니다.

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

1. 상단 **API Platform (Admin)** 카드를 봅니다.
2. 안내: *"OpenAI Platform → 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: Workspace ID + Compliance API Key 입력 (ChatGPT Workspace, 선택)**

1. 아래쪽 **ChatGPT Workspace (Compliance)** 카드를 봅니다.
2. 안내: *"ChatGPT Enterprise/Edu → Settings → Compliance → API Key에서 발급받은 키를 입력해주세요."*
3. `Workspace ID` 를 먼저 입력합니다 (placeholder: *"chatgpt.com/admin 에서 확인 가능한 Workspace ID"*). `chatgpt.com/admin` 화면에서 조회합니다.
4. `Compliance API Key` 를 입력합니다.
5. **`연동하기`** 버튼을 클릭합니다.

{% hint style="warning" %}
**Workspace ID 와 API Key 를 모두 입력해야 합니다** ChatGPT Workspace 연동은 **Workspace ID 와 Compliance API Key 두 값이 모두 입력되어야** **`연동하기`** 버튼이 활성화됩니다. 한쪽만 입력하면 버튼이 비활성화된 상태로 남습니다.
{% endhint %}

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

**연동 완료 후**

연동이 끝난 카드에는 **`대시보드 보기`** 버튼이 생깁니다. 누르면 해당 영역 탭이 열린 OpenAI 대시보드로 바로 이동합니다 (Admin 카드 → API Platform 탭, ChatGPT Workspace 카드 → ChatGPT Workspace 탭). 버튼 우측 드롭다운의 **`연동 해제`** 로 그 영역만 따로 해제할 수 있습니다.

***

### 2. 대시보드 접근

1. 사이드바의 **`AI`** > **`OpenAI`** 메뉴를 클릭합니다.
2. 또는 **AI 메인 페이지** (`/ai`) 에서 OpenAI 카드의 **`열기`** 버튼을 누릅니다.
3. 헤더 제목 **OpenAI** 와 설명 *"API 플랫폼과 ChatGPT Workspace의 비용, 사용량을 관리합니다."* 가 표시되면 화면이 정상 동작 중입니다.

**헤더 우측 버튼:**

* **`연동 설정`** — 설정 > 연동 관리 페이지로 이동합니다.

{% hint style="info" %}
**새로고침은 헤더가 아니라 각 탭 안에 있습니다** 수동 동기화 버튼 **`새로고침`** 은 헤더가 아니라 **API Platform / ChatGPT Workspace 각 탭 상단**에 따로 있습니다. 마지막 동기화 시각도 각 탭 설명 아래에 *"마지막 동기화: {시각}"* 으로 탭별로 표시됩니다. 자세한 동작은 §6을 참고하세요.
{% endhint %}

***

### 3. 탭 구성

OpenAI 대시보드는 두 개의 메인 탭으로 구성됩니다. 탭은 **ChatGPT Workspace** 가 먼저, **API Platform** 이 다음 순서로 나란히 표시됩니다.

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

기간은 **오늘 기준 최근 30일**로 고정되어 있습니다 (별도 날짜 필터는 없습니다).

{% hint style="info" %}
**처음 열릴 때 보이는 탭** ChatGPT Workspace 가 연동되어 있으면 **ChatGPT Workspace 탭**이, 아니면 **API Platform 탭**이 기본으로 열립니다. 단, 주소 끝에 `?tab=platform` 또는 `?tab=chatgpt` 를 붙이면 (또는 연동 화면의 **`대시보드 보기`** 로 진입하면) 그 탭이 열린 채로 들어갑니다.
{% endhint %}

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

***

### 4. API Platform 탭

**KPI 카드 (3장)**

| 카드          | 의미                                                 |
| ----------- | -------------------------------------------------- |
| **총 멤버**    | 연동된 OpenAI 조직의 총 멤버 수. 대기 중인 초대가 있으면 서브텍스트로 표시     |
| **이번 달 비용** | 최근 30일 누적 API 비용 (USD). 서브텍스트로 프로젝트 수              |
| **총 토큰**    | 30일 누적 입력·출력 토큰 합계 (K/M/B 단위). 서브텍스트로 *"캐시 효율 N%"* |

{% hint style="info" %}
**"이번 달 비용"의 기준 기간** 라벨은 *"이번 달 비용"* 이지만 실제 집계 구간은 달력 월이 아니라 **오늘로부터 최근 30일**입니다. 화면의 다른 수치와 동일한 30일 기준입니다.
{% endhint %}

**차트**

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

**멤버 목록 테이블**

* 이름, 이메일, 역할, 추가일
* 역할 값은 OpenAI 조직에서 내려오는 그대로 표시됩니다
* 발송했지만 아직 수락되지 않은 **대기 중인 초대**가 있으면 별도 목록으로 함께 표시됩니다

***

### 5. ChatGPT Workspace 탭

**KPI 카드 (3장)**

| 카드         | 의미                               |
| ---------- | -------------------------------- |
| **활성 사용자** | 최근 30일 ChatGPT 를 사용한 고유 사용자 수    |
| **총 메시지**  | 30일 누적 ChatGPT 메시지 수             |
| **총 토큰**   | 30일 누적 ChatGPT 토큰 사용량 (K/M/B 단위) |

세 카드 모두 **지난주 대비** 증감을 함께 보여줍니다. 서브텍스트에는 절대 변화량 *"(+N) 지난주 대비"* 가, 카드 모서리에는 증감률 (`+N%` / `-N%`) 과 방향이 표시됩니다.

**일별 메시지 추이 (영역 차트)**

날짜별 ChatGPT 메시지 수를 영역 차트로 보여줍니다. 데이터가 2일 이상 쌓이면 표시되며, 한 지점에 마우스를 올리면 그 날의 **사용자 수 / 메시지 수 / 토큰 수**가 함께 뜹니다.

**3개 그리드 (각각 별도 테이블)**

| 그리드             | 내용                                                  |
| --------------- | --------------------------------------------------- |
| **ChatGPT 사용량** | 사용자별 메시지 수 / 토큰 / 사용 도구 / 주요 모델 / 날짜 (메시지 수 내림차순)   |
| **Codex**       | 사용자별 모델 / 입력·출력 토큰 / 사용 도구 / 날짜 (날짜 내림차순)           |
| **활동**          | 관리자 감사·사용자 인증 이벤트를 합쳐 사용자 / 액션 / 대상 / 유형 / 시간 (최신순) |

각 그리드 제목 옆에는 행 개수를 나타내는 뱃지가 붙고, 검색·필터·정렬·열 보기 도구를 모두 쓸 수 있습니다.

***

### 6. 동기화 방식

* **자동 동기화** — 매일 **오전 5시 (KST)** 배치로 실행됩니다.
* **조직·멤버·프로젝트** — 연동 직후 첫 동기화 시 수집됩니다.
* **비용·토큰 사용량** — API 사용 후 **최대 1일 이내**에 프로젝트별 비용·모델별 토큰이 동기화됩니다.
* **ChatGPT 활동·Codex·인증 이벤트** — Compliance 연동 후 동기화됩니다.

**수동 새로고침 (탭별)**

수동으로 즉시 동기화가 필요하면 **각 탭 상단의 `새로고침` 버튼**을 사용하세요. API Platform 탭과 ChatGPT Workspace 탭의 새로고침은 서로 독립적으로 동작합니다.

{% hint style="warning" %}
**새로고침은 5분에 한 번** 한 번 새로고침하면 **5분 동안** 같은 탭의 버튼이 비활성화되고, 버튼에 남은 시간 (`m:ss`) 이 카운트다운으로 표시됩니다. 5분이 지나면 다시 누를 수 있습니다.
{% endhint %}

{% hint style="warning" %}
**일부 데이터 동기화 실패** 일부 API만 실패하면 노란색 배너로 *"일부 데이터 수집에 실패했습니다. 다음 동기화 시 재시도됩니다."* 가 표시됩니다. 중요한 지표를 확인할 때는 잠시 후 **`새로고침`** 으로 한 번 더 시도하세요.
{% endhint %}

***

### 7. 자주 묻는 질문

**Q: ChatGPT Workspace 연동 버튼이 비활성화되어 있습니다.**

ChatGPT Workspace 연동은 **Workspace ID 와 Compliance API Key 두 값이 모두** 입력되어야 **`연동하기`** 버튼이 켜집니다. Workspace ID 는 `chatgpt.com/admin` 에서 확인하고, Compliance API Key 는 ChatGPT Enterprise/Edu → Settings → Compliance → API Key 에서 발급해 둘 다 입력하세요.

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

ChatGPT 사용량은 Compliance API Key (와 Workspace ID) 가 별도로 필요합니다. ChatGPT Workspace 카드를 따로 연동해주세요. 연동되지 않은 ChatGPT Workspace 탭에는 *"Compliance API 연동이 필요합니다"* 안내만 표시됩니다.

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

연동 직후에는 API 사용 후 최대 1일 이내에 비용이 동기화됩니다. 자동 동기화는 매일 오전 5시 (KST) 에 돕니다. 시간이 지난 후에도 0 이라면 해당 기간에 실제 API 호출이 없었거나, Admin Key 권한 부족일 수 있습니다. API Platform 탭의 **`새로고침`** 으로 한 번 더 시도해보세요.

**Q: 새로고침 버튼이 회색이고 시간이 표시됩니다.**

수동 새로고침은 5분에 한 번만 가능합니다. 한 번 누르면 5분 동안 버튼이 비활성화되고 남은 시간 (`m:ss`) 이 표시됩니다. 카운트다운이 끝나면 다시 누를 수 있습니다.

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

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

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

연동 관리 페이지에서 연동된 카드의 **`대시보드 보기`** 우측 드롭다운 **`연동 해제`** 로 해제한 뒤 새 키로 다시 연동하세요. Admin 과 ChatGPT Workspace 는 각각 독립적으로 해제·재연동할 수 있습니다.

**Q: 이 외의 문제**

채널톡으로 문의해 주세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.