Admin SDK 퀵스타트

Admin SDK를 설치하고 첫 관리 호출을 만들어 보는 가이드예요.

출처: 문서

본문

개요 (Overview)

Admin SDK는 조직, 프로젝트, 멤버, 역할, API 키를 프로그래밍 방식으로 관리하게 해 줘요. confidentai SDK를 통해 Python과 TypeScript 모두에서 사용할 수 있어요.

이 퀵스타트는 SDK를 설치하고, 조직 API 키를 구성하고, 클라이언트를 만들고, 조직의 프로젝트를 나열하는 방법을 보여줘요.

관리 작업을 Vibe Code로 하기 (Vibe Code Your Administration)

코딩 에이전트가 계정 관리를 대신 수행하게 할 수 있어요 — 프로젝트 만들기, 멤버 초대, 정책과 권한으로 역할 구성하기, API 키 프로비저닝까지요. 원하는 걸 평범한 영어로 설명하면 에이전트가 올바른 Admin SDK 호출을 작성하고 실행해요. 전체 워크스루는 Vibe Code Your Administration 가이드를 참고하고, 아래에서 에이전트에 맞는 설치 방법을 골라 바로 시작할 수 있어요.

Claude Code (플러그인)

Claude Code에서 이 네 가지 명령을 실행해요:

/plugin marketplace add confident-ai/confident-client
/plugin install confident-client@confident-ai-plugins
/reload-plugins
/plugins

/plugins 명령이 confident-client를 설치된 플러그인에 표시할 거예요.

Cursor, Codex, Windsurf 등 (Skills CLI)

confident-client Agent Skill을 Skills 호환 설치기로 설치해요. Cursor, Claude Code, Codex, Windsurf, OpenCode 등 Skills 표준을 지원하는 어떤 어시스턴트에서도 동작해요:

npx skills add confident-ai/confident-client --skill "confident-client"

이 스킬은 에이전트가 Admin SDK를 다루는 법을 가르쳐 줘요 — 프로젝트 만들기, 멤버 초대, 정책과 권한으로 역할 구성하기, 거버넌스 정책 할당, API 키 프로비저닝까지요. 아래 같은 프롬프트에서 자동으로 트리거돼요.

설치 후 프로젝트를 열고 에이전트에게 필요한 것을 말해요. 예시 프롬프트:

"Create a Confident AI project called 'Customer Support Bot' and make [email protected] the owner."
"Invite [email protected] and [email protected] to my organization as analysts."
"Create an 'Analyst' role with read-only access and assign it to [email protected]."

에이전트는 SDK 언어를 확인하고, 올바른 순서(권한 → 정책 → 역할)로 호출을 실행한 뒤, 생성된 ID와 일회용 API 키를 돌려줘요.

시작하기 (Get Started)

SDK 설치 (Install the SDK)

Python

pip install confidentai

TypeScript

npm install confidentai

조직 API 키 설정 (Set your Organization API Key)

ConfidentAI 클라이언트는 조직 API 키가 필요해요. 이는 트레이싱과 평가에 쓰는 프로젝트 키와는 별개예요. 클라이언트를 구성하기 전에 직접 가져와요.

클라이언트는 기본적으로 CONFIDENT_ORG_API_KEY 환경 변수를 읽어요. 이는 트레이싱과 평가에 쓰는 CONFIDENT_API_KEY와는 별개이므로 둘을 동시에 구성할 수 있어요.

export CONFIDENT_ORG_API_KEY="confident_us_org_..."

클라이언트 생성 (Create a client)

Python

from confidentai import ConfidentAI

client = ConfidentAI()

TypeScript

import { ConfidentAI } from "confidentai";

const client = new ConfidentAI();

환경 변수 대신 키를 명시적으로 넘길 수도 있어요. 같은 프로세스에서 여러 조직을 관리할 때 유용해요.

Python
client = ConfidentAI(api_key="confident_us_org_...")
TypeScript
const client = new ConfidentAI({ apiKey: "confi......" });

첫 호출 만들기 (Make your first call)

조직의 프로젝트를 나열해서 클라이언트가 올바르게 구성됐는지 확인해요.

Python

# List the projects in your organization
for project in client.projects.list():
    print(project.id, project.name)

TypeScript

// List the projects in your organization
const projects = await client.projects.list();
projects.forEach((project) => console.log(project.id, project.name));

완료 ✅. Admin SDK 클라이언트가 구성되었고 관리 요청을 보낼 수 있어요.

다음 단계 (Next Steps)

흔한 관리 작업에 대한 리소스 참조를 확인해요:

Admin SDK 퀵스타트