Admin SDK로 프로젝트 관리하기
Admin SDK로 프로젝트 관리하기
조직의 프로젝트를 만들고, 읽고, 수정하고, 삭제할 수 있어요.
출처: 문서
본문
개요 (Overview)
프로젝트는 데이터셋, 프롬프트, 트레이스, 평가를 위한 격리된 작업 공간이에요. Admin SDK로 프로그래밍 방식으로 프로젝트를 만들고, 수정하고, 삭제할 수 있어요. 이는 프로젝트-당-에이전트, 프로젝트-당-환경, 프로젝트-당-고객 같은 조직 모델을 지원해요.
이 페이지의 모든 메서드는 조직 API 키가 필요해요. 클라이언트 생성은 퀵스타트를 참고해요.
프로젝트 목록 조회 (List Projects)
조직의 모든 프로젝트를 나열할 수 있어요.
Python
from confidentai import ConfidentAI
client = ConfidentAI()
projects = client.projects.list()
for project in projects:
print(project.id, project.name)
TypeScript
import { ConfidentAI } from "confidentai";
const client = new ConfidentAI();
const projects = await client.projects.list();
projects.forEach((project) => console.log(project.id, project.name));
프로젝트 생성 (Create a Project)
name만으로 새 프로젝트를 만들 수 있고, description은 선택이에요. 프로젝트를 만들면 첫 번째 프로젝트 API 키도 함께 생성되므로, 호출은 project와 그 api_key(전체 시크릿은 여기서만 확인 가능)를 모두 반환해요.
Python
created = client.projects.create(
name="Customer Support Bot",
description="Production support assistant",
)
print(created.project.id) # e.g. "clq9z3x1k0001la08f7t3g5p2"
print(created.api_key.value) # e.g. "confident_us_proj_...", shown only once
TypeScript
const created = await client.projects.create({
name: "Customer Support Bot",
description: "Production support assistant",
});
console.log(created.project.id); // e.g. "clq9z3x1k0001la08f7t3g5p2"
console.log(created.apiKey?.value); // e.g. "confident_us_proj_..."
프로젝트 조회 (Get a Project)
project_id로 단일 프로젝트를 조회할 수 있어요.
Python
project = client.project("clq9z3x1k0001la08f7t3g5p2")
project.get()
TypeScript
const project = client.project("clq9z3x1k0001la08f7t3g5p2");
await project.get();
프로젝트 수정 (Update a Project)
프로젝트의 name, description, 또는 둘 다를 수정할 수 있어요. 넘겨준 필드만 변경돼요.
Python
project = client.project("clq9z3x1k0001la08f7t3g5p2")
project.update(name="Support Bot (v2)")
TypeScript
const project = client.project("clq9z3x1k0001la08f7t3g5p2");
await project.update({ name: "Support Bot (v2)" });
프로젝트 삭제 (Delete a Project)
조직에서 프로젝트를 영구 삭제할 수 있어요.
프로젝트를 삭제하면 모든 데이터셋, 프롬프트, 트레이스, 평가가 영구적으로 제거돼요. 되돌릴 수 없어요.
Python
project = client.project("clq9z3x1k0001la08f7t3g5p2")
project.delete()
TypeScript
const project = client.project("clq9z3x1k0001la08f7t3g5p2");
await project.delete();
다음 단계 (Next Steps)
프로젝트를 구성한 뒤에는 접근과 키를 관리해요:
멤버와 초대 (Members & Invitations)
프로젝트에 사용자를 추가하고 역할을 할당해요.
API 키 (API Keys)
프로젝트 스코프 API 키를 프로비저닝해요.