관리 작업을 Vibe Code로 하기

Cursor, Claude Code, 또는 Codex에서 자연어 프롬프트로 Confident AI를 관리해요.

출처: 문서

본문

개요

confident-client Agent Skill은 여러분의 코딩 에이전트 — Cursor, Claude Code, Codex — 가 Admin SDK를 대신 구동하는 방법을 가르쳐요. SDK 코드를 손으로 쓰는 대신 원하는 것을 묘사하면("[email protected]이 소유한 프로젝트를 만들어 줘") 에이전트가 올바른 호출을 작성하고 실행해요.

스킬은 그냥 SKILL.md 파일에 참조 문서를 더한 것이에요. confident-client 저장소 — Python과 TypeScript SDK와 같은 저장소 — 안에 들어 있으므로, 안내가 항상 코드와 일치해요.

이것은 Admin SDK 퀵스타트의 Vibe Code Your Administration 섹션 뒤에 있는 전체 워크스루예요. 계정 관리 — 조직, 프로젝트, 멤버, 역할, 거버넌스 정책, API 키 — 를 다루고, 트레이싱과 평가에 쓰는 프로젝트 키가 아니라 Organization API Key(CONFIDENT_ORG_API_KEY)로 인증해요.

설정할 흐름이에요:

Admin SDK 설치하기

스킬은 confidentai Admin SDK를 구동해요 — 에이전트가 실제로 실행하는 패키지죠. 에이전트가 명령을 실행하는 환경에, 프로젝트가 쓰는 언어에 맞춰 설치해요:

Python

pip install confidentai

TypeScript

npm install confidentai

스킬 설치하기

스킬은 confident-client 저장소에 있어요. Claude Code 플러그인으로, 또는 다른 에이전트라면 Skills CLI로 설치해요.

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 키 프로비저닝까지요. 아래 같은 프롬프트에 자동으로 발동해요.

Organization API Key 설정하기

모든 관리 호출은 Organization API Key(예: confident_us_org_...)가 필요해요. 가져온 뒤, 에이전트가 명령을 실행하는 터미널에서 내보내요:

export CONFIDENT_ORG_API_KEY="confident_us_org_..."

이것은 트레이싱과 평가용 프로젝트 스코프 키인 CONFIDENT_API_KEY와 같지 않아요. 둘 다 소스 컨트롤에 두지 마세요. 에이전트가 실제로 무엇이든 만들려면 셸 세션에 CONFIDENT_ORG_API_KEY가 필요해요.

첫 프로젝트 만들기

에이전트를 열고 원하는 프로젝트를 묘사해요. 예를 들어:

Create a Confident AI project called "Customer Support Bot" and make [email protected] the owner.

스킬이:

프로젝트가 명확히 둘 중 하나가 아니면 어떤 SDK 언어(Python 또는 TypeScript)를 쓸지 확인해요.
소유자를 배정할지 물어요(이메일은 기존 조직 멤버에 속해야 해요).
프로젝트를 만들고 id와 일회성 프로젝트 API 키를 반환해요 — 전체 시크릿은 생성 시에만 보여요.

프로젝트 키는 한 번만 반환되므로, 에이전트가 출력하자마자 안전한 곳에 복사해 두세요. 마지막 단계에서 쓸 거예요.

완료 ✅. SDK 코드 한 줄도 쓰지 않고 프로젝트를 만들었어요.

멤버 초대하고 역할 배정하기

팀을 같은 방식으로 — 프롬프트로 — 온보딩해요:

Invite [email protected] and [email protected] to my organization.

스킬이 보내기 전에 초대받을 사람에게 어떤 역할을 줄지 물어요(초대는 유료 플랜이 필요해요).

Create an "Analyst" role with read-only access and assign it to [email protected].

역할은 정책으로, 정책은 권한으로 만들어져요 — 스킬이 올바른 순서로 구성해 줘요. 거버넌스도 관리할 수 있어요:

Assign our governance policy to all of my production projects.

프로젝트 API 키 사용하기

3단계의 프로젝트 API 키는 여러분 애플리케이션이 트레이싱과 평가에 쓰는 것이에요. 앱이 도는 환경에 붙여 넣어요:

export CONFIDENT_API_KEY="confident_us_proj_..."

그게 프로젝트 스코프 키(CONFIDENT_API_KEY)예요 — 관리에 쓴 CONFIDENT_ORG_API_KEY와는 별개죠. 설정해 두면 confident-trace와 트레이싱 SDK가 데이터를 새 프로젝트로 보내요.

완료 ✅. 프로젝트가 살아서 트레이스와 평가를 받을 준비가 됐어요.

다음 단계

SDK와 스킬을 설치하고, 프로젝트를 만들고, 멤버를 온보딩하고, 프로젝트 키를 연결했어요 — 전부 프롬프트로요. 더 들어가 보려면:

관리 작업을 Vibe Code로 하기