AI 코딩 에이전트의 백엔드 프로비저닝 방법

AI 코딩 에이전트는 프로젝트 테넌트 하나를 만들고, 필요한 각 서비스의 현재 계약을 읽고, 리소스를 하나씩 프로비저닝하고, 반환된 엔드포인트를 검증해 Cohesivity 백엔드를 구성할 수 있습니다. 기존 .cohesivity 파일을 재사용하고 두 Cohesivity 자격 증명을 브라우저 코드에 넣지 않아야 합니다.

이 가이드는 모든 리소스 요청 본문을 문서에 고정하지 않고 작업 순서를 설명합니다. 에이전트가 작업을 실행할 때는 제품 안내 페이지가 기준입니다.

애플리케이션 요구 사항부터 확인하세요

애플리케이션에 필요한 상태와 외부 효과를 나열합니다.

관계형 데이터에는 postgres가 필요할 수 있습니다.
Google 로그인에는 social-login이 필요할 수 있습니다.
업로드에는 object-storage가 필요할 수 있습니다.
공개 서버에는 railway-hosting 또는 cloudflare-workers가 필요할 수 있습니다.
비동기 이메일에는 inbox가 필요할 수 있습니다.
실시간 팬아웃에는 realtime이 필요할 수 있습니다.

애플리케이션에 AI 기능이 있다는 이유만으로 벡터 데이터베이스를 프로비저닝하지 마세요. Postgres와 벡터 데이터베이스 가이드는 의미 검색에 별도 스토어가 필요한 시점을 설명합니다.

프로젝트를 초기화하거나 재사용하세요

먼저 유효한 .cohesivity 파일을 확인하세요. 있다면 해당 테넌트를 재사용합니다. 새 테넌트를 만들면 관련 리소스가 나뉘고 정리가 어려워집니다.

프로젝트가 없으면 초기화 과정을 미리 확인합니다.

npx @cohesivity/init --dry-run

그런 다음 임시 프로젝트를 만듭니다.

npx @cohesivity/init

이 명령은 관리 키, 애플리케이션 키, 테넌트 ID, 수명 주기, 런타임 프로필, 만료 시각이 담긴 프로젝트 컨텍스트를 작성합니다. 초기 테넌트는 가입 없이 72시간 동안 유지됩니다. 이후 소유권 등록은 별도의 사람 동의 단계입니다.

각 제품의 현재 계약을 읽으세요

프로비저닝하기 전에 현재 Postgres 제품 계약처럼 해당 리소스의 최신 페이지를 가져오세요. Cohesivity에 직접 HTTP 요청을 보낼 때는 기본값이 아닌 User-Agent가 필요합니다.

curl -sS -A "MyCodingAgent/1.0" \
  https://cohesivity.ai/offerings/postgres

필수 본문, 고정 리전, 현재 한도, 인증 방식, 파괴적 작업, 검증 필드를 읽으세요. 모든 리소스에 반복합니다. 에이전트가 운영할 수 있는 백엔드 가이드는 상태와 정리가 계약에 포함되는 이유를 설명합니다.

데이터베이스를 먼저 프로비저닝하세요

현재 Postgres 계약에서는 다음과 같은 관리 영역 요청을 사용합니다.

curl -sS -A "MyCodingAgent/1.0" -X POST \
  https://cohesivity.ai/api/resources/postgres \
  -H "Authorization: Bearer <coh_management_key>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: provision-postgres-v1" \
  -d '{}'

Postgres는 단일 리전(싱가포르)에서 실행됩니다. 요청의 region 필드는 허용되지만 무시됩니다. 응답이 준비 완료 상태와 문서화된 엔드포인트를 반환해야 리소스가 준비된 것입니다. 요청이 200을 반환했다는 이유만으로 준비 상태를 추론하지 마세요.

서버 측 애플리케이션 코드에서 Postgres는 SQL 문 하나 또는 원자적 배치를 받습니다. PostgreSQL은 $1 플레이스홀더를 사용합니다.

curl -sS -A "MyAppServer/1.0" -X POST \
  "https://cohesivity.ai/edge/postgres?key=<coh_application_key>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-signups-schema-v1" \
  -d '{"query":"CREATE TABLE IF NOT EXISTS signups (id BIGSERIAL PRIMARY KEY, email TEXT UNIQUE NOT NULL)"}'

쿼리 문자열 자격 증명은 문서화된 대체 경로입니다. 서버는 애플리케이션 키를 수명이 짧은 엣지 세션 토큰으로 교환하고 bearer 인증을 대신 사용할 수 있습니다. 어느 자격 증명도 클라이언트 측 JavaScript에 넣어서는 안 됩니다.

모든 콜백 URL로 인증을 추가하세요

소셜 로그인 프로비저닝은 전체 콜백 URL 목록을 교체합니다. 개발 및 프로덕션 URL을 한 요청에 모두 포함하세요.

curl -sS -A "MyCodingAgent/1.0" -X POST \
  https://cohesivity.ai/api/resources/social-login \
  -H "Authorization: Bearer <coh_management_key>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: provision-social-login-v1" \
  -d '{"callback_urls":["http://localhost:3000/auth/done","https://example.cohesivity.app/auth/done"]}'

호스팅 과정에서 반환된 실제 배포 호스트 이름을 사용하세요. 나중에 URL 하나만 넣어 목록을 교체하면 빠진 콜백이 제거됩니다.

각 계약에 따라 스토리지와 호스팅을 프로비저닝하세요

오브젝트 스토리지 프로필, 업로드 동작, 호스팅 파일 형식, 환경 변수, 도메인, 준비 상태 검사는 각각 별도 제품 페이지에 있습니다. 사용 직전에 가져오세요. Cohesivity의 현재 기본 호스팅 경로는 Railway CLI, GitHub 연결, 테넌트 소유 Railway 자격 증명 없이 Railway 호스팅 API를 통해 파일을 업로드합니다.

서비스 하나를 프로비저닝하고 검증한 뒤 다음으로 넘어갑니다. 대량 요청은 절약하는 시간이 적고 어떤 계약이 실패했는지 찾기 어렵게 만듭니다.

전체 수명 주기를 검증하세요

설정 후 다음을 수행합니다.

관리 영역에서 리소스 상태를 조회합니다.
서버 측 애플리케이션 호출 하나를 실행합니다.
같은 멱등성 키로 쓰기 작업 하나를 반복해 효과가 하나인지 확인합니다.
브라우저 애셋, 로그, 버전 관리에 coh_* 값이 없는지 확인합니다.
테넌트 만료 시각과 소유권 등록 경계를 기록합니다.
각 일회용 리소스의 제거 방법을 문서화합니다.

아래 프롬프트는 코딩 에이전트에 최소 리소스 목록을 요청하고 아무것도 만들기 전에 멈춥니다.

AI 코딩 에이전트가 데이터베이스, 인증, 스토리지, 호스팅을 프로비저닝하는 방법