Tetrees Agent EX란?
Tetrees Agent EX는 호스팅된 Tetrees Agent MCP 서버와 API를 통해 Tetrees AI Packs를 사용할 수 있도록 제공되는 공개 통합 키트입니다. 구매자, 빌더, 판매자를 위한 클라이언트, 구성 예시, 안전한 확장 샘플을 제공합니다.
이 키트는 호스팅 서비스의 내부 구현이 아니라 개발자용 계약을 제공합니다. Tetrees Agent 구현 세부 정보, 비공개 Pack 인텔리전스, Agent AVCP 평가 규칙, 서비스 프롬프트, 모더레이션 시스템, 스토리지 인프라 또는 프로덕션 자격 증명은 포함하지 않습니다.
Tetrees 호스팅 작업에는 로컬 GPU가 필요하지 않습니다. 모델 사용 비용이 발생하는 실행은 시작 전에 Tetrees Points로 견적이 제공됩니다. Pack을 구매한 후에는 지원되는 제공업체 키를 로컬 MCP 프로세스에 직접 제공할 수도 있습니다.
구축할 수 있는 것
구매자 및 운영자 워크플로
구매자와 운영자는 공개 계약을 사용하여 다음을 수행할 수 있습니다.
- AI Pack 카탈로그 검색
- Pack의 공개 Agent AVCP 보고서 및 런타임 프로필 확인
- Tetrees Points를 사용하기 전에 실행 비용 견적 확인
- 상태를 저장하지 않는 Points-funded 미리보기로 Pack 체험
- 무료 Pack을 획득하거나 Tetrees EX에서 유료 Pack 구매
- 소유한 변경 불가능한
.taip릴리스 다운로드
빌더 워크플로
빌더는 바인딩과 자격 증명을 사용자의 컴퓨터에 유지하면서 검증을 마친 Pack을 사용자가 관리하는 기능에 연결할 수 있습니다. 지원되는 패턴으로는 고정 HTTPS API, 중첩 MCP 서버, 셸을 사용하지 않는 로컬 스킬이 있습니다.
판매자 워크플로
판매자는 리스팅을 만들고, 변경 불가능한 Pack 버전과 이미지를 업로드하고, 준비 상태를 확인하고, Agent AVCP를 실행하고, 비공개 수정 피드백을 검토한 다음, 평가를 통과한 릴리스를 게시할 수 있습니다.
사전 요구 사항
호스팅된 MCP 통합을 구성하기 전에 다음을 준비하세요.
- Node.js 20 이상
- Tetrees 계정 페이지에서 발급한 폐기 가능한 API 토큰
- 호스팅된 MCP 서버를 사용하려는 경우 MCP 호환 클라이언트
- 인스펙터, CLI, 예시 또는 검증 명령을 실행하려는 경우 저장소의 로컬 체크아웃
자격 증명을 Pack, 프롬프트, 소스 파일 및 공유 MCP 구성에 포함하지 마세요. 선택적 제공업체 키는 로컬 MCP 프로세스의 환경에만 존재해야 합니다.
호스팅된 MCP 서버 구성
다음 서버 정의를 MCP 클라이언트의 구성에 추가하세요. 자리 표시자를 폐기 가능한 Tetrees 계정 토큰으로 바꾸세요.
{
"mcpServers": {
"tetrees-ai": {
"command": "npx",
"args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.0"],
"env": {
"TETREES_API_URL": "https://ex.tetrees.ai/api",
"TETREES_TOKEN": "<revocable-account-token>"
}
}
}
}구성을 저장한 후 MCP 클라이언트를 다시 시작하세요. v=2.2.0 접미사는 npx가 동일한 URL에 캐시된 이전 tarball을 재사용하지 않도록 합니다. Tetrees가 더 최신 MCP 계약을 게시할 때만 이 값을 변경하세요.
안전한 MCP 요청 시도
유료 실행을 시작하지 않고 Pack을 검색하고 견적을 요청하도록 MCP 클라이언트에 요청하세요.
Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.이 요청은 의도된 안전 패턴을 따릅니다. Pack을 검색하고, 공개 평가 및 런타임 요구 사항을 확인하고, 견적을 요청한 후, Points를 사용하기 전에 명시적인 승인을 기다립니다.
공개 MCP 계약 확인
저장소 디렉터리에서 종속 항목을 설치하고 토큰을 내보낸 다음 MCP 인스펙터를 실행하세요.
npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect인스펙터는 공식 호스팅 MCP 패키지를 실행하고 공개 도구와 리소스를 나열합니다. 또한 예상되는 구매자, 빌더 및 판매자 기능 영역을 확인합니다. 인스펙터는 Points를 사용하거나 계정 상태를 변경하지 않고 종료됩니다.
공개 API CLI 사용
이 프로젝트는 비밀 파일을 자동으로 불러오지 않습니다. CLI가 해당 파일을 읽을 것이라고 가정하지 말고 .env.example에서 관련 값을 복사하여 셸 환경에 넣으세요.
export TETREES_TOKEN="txk_..."읽기 전용 명령 실행
모델 작업을 시작하지 않고 서비스와 계정을 확인하는 명령부터 실행하세요.
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>catalog으로 Pack을 찾고, runtime으로 런타임 프로필을 검토하고, report로 공개 Agent AVCP 보고서를 확인하세요. models 및 skills 명령은 지원되는 공개 선택 항목을 보여 주며, owned는 계정과 연결된 Pack을 나열합니다.
실행 전 견적 확인
견적을 요청해도 모델 요청이 시작되지는 않습니다. 선택한 Pack 및 모델 식별자를 입력하세요.
npm run tetrees -- quote <pack-id> <model-id>실행을 승인하기 전에 정확한 모델, 토큰 한도, 호스팅된 스킬, 성장 체크포인트 및 견적된 Point 사용량을 검토하세요.
Points 사용 실행 확인
실행을 시작하려면 정확한 확인 플래그를 포함하세요.
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend포인트로 자금을 충당하는 미리보기는 상태를 유지하지 않으며, 사용하지 않은 예약 포인트는 반환됩니다. CLI는 응답에서 비밀 정보처럼 보이는 필드를 가리고 Tetrees 오류 코드, HTTP 상태 값, Retry-After 정보를 보고합니다. 변형 작업을 자동으로 재시도하지 않습니다.
구매자 흐름 따르기
신중한 구매자 워크플로는 다음 순서로 진행됩니다.
- 작업에 맞는 Pack을 검색합니다.
- 공개된 Agent AVCP 보고서와 런타임 프로필을 확인합니다.
- 정확한 모델, 토큰 한도, 호스팅된 스킬, 성장 체크포인트를 견적에 명시합니다.
- 포인트로 자금을 충당하는 상태 비저장 미리보기를 승인하고 실행합니다.
- Tetrees EX를 통해 무료 Pack을 획득하거나 유료 Pack을 구매합니다.
- 다운로드, BYOK, 저장된 성장 정보, 클라이언트 확장 기능 등의 소유권 혜택을 이용합니다.
저장소에는 읽기 전용 검색 및 견적 예제가 문서화되어 있습니다.
node examples/buyer/discover-and-quote.mjs "incident response"incident response를 다른 검색 문구로 바꾸면 다른 사용 사례에 맞는 Pack을 탐색할 수 있습니다.
빌더로 로컬 기능 추가하기
게시된 Pack은 Agent AVCP를 통과한 클라이언트 확장을 선언할 수 있습니다. 확장의 실제 바인딩과 자격 증명은 로컬에 유지되므로 Tetrees 호스팅에는 해당 권한이 부여되지 않습니다.
바인딩 패턴 선택
https_api: 선언된 메서드와 환경 변수로 관리되는 헤더를 사용해 고정 HTTPS 기본 URL에 연결합니다.mcp: 셸 없이 중첩 MCP 서버를 시작하고 선언된 도구 이름에 매핑합니다.local_skill: 셸 없이 자식 프로세스를 시작하여 JSON 요청 하나를 받고 JSON 결과 하나를 반환합니다.
구성의 출발점으로 examples/extensions/client-extensions.example.json을 사용하세요. 저장소에는 로컬 스킬 예제인 examples/extensions/local-skill/issue-summary.mjs와 전체 빌더 계약을 설명하는 docs/BUILDER_GUIDE.md도 포함되어 있습니다.
쓰기 메서드에는 호출마다 정확한 승인 문구
APPROVE extensionId.methodId가 필요합니다. 일반적인 대화상의 승인을 쓰기 작업 수행 권한으로 간주하지 마세요.
판매자로 Pack 게시하기
판매자 경로는 계약을 기반으로 합니다. 먼저 Pack을 변경하지 않고 준비 상태와 보고서를 확인합니다.
node examples/seller/check-readiness.mjs <pack-id>새 릴리스가 준비되면 명시적으로 확인한 후 더 높은 불변 버전 하나를 업로드합니다.
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload업로드 후 호스팅된 MCP 도구 또는 Tetrees API 레퍼런스를 사용해 게시 워크플로를 완료합니다.
- 업로드한 버전을 제출합니다.
- Agent AVCP 견적을 요청합니다.
- Agent AVCP를 실행하기 전에 정확한 포인트 금액을 확인합니다.
- 비공개 보고서와 수정 피드백을 검토합니다.
- 평가를 통과한 다이제스트만 게시합니다.
리스팅을 준비할 때는 docs/SELLER_GUIDE.md와 examples/seller/pack-listing.example.json을 참고하세요.
고급 안전 및 안정성 팁
비밀 정보와 공유 구성 분리
Tetrees 토큰과 선택적 제공자 키는 로컬 프로세스 환경 변수에 저장하세요. 제공자 자격 증명을 Pack, 프롬프트, 소스 파일 또는 공유될 수 있는 구성에 절대 포함하지 마세요. 필요할 때 액세스를 철회할 수 있도록 취소 가능한 토큰을 사용하세요.
변형 작업을 자동으로 재시도하지 않기
쓰기 작업이 실패하면 조치하기 전에 보고된 Tetrees 오류 코드, HTTP 상태, Retry-After 값을 확인하세요. 자동 재시도는 업로드, 구매, 실행 또는 기타 상태 변경 작업을 반복할 수 있습니다.
호스팅된 MCP 계약을 신중하게 고정하기
오래된 npx 캐시 항목을 피하려면 MCP 패키지 URL에 문서화된 쿼리 접미사를 유지하세요. 공식적으로 게시된 계약 버전에 대응할 때만 이를 업데이트하세요.
공개 경계 검토
기여하기 전에 SECURITY.md와 docs/PUBLIC_BOUNDARY.md를 읽으세요. 기여 코드는 문서화된 공개 인증 계약과만 상호작용해야 하며 Agent 내부, 비공개 Pack 데이터, 채점 픽스처, 서명 키, 데이터베이스, 관리자 API 또는 배포 인프라에 액세스할 수 있다고 가정해서는 안 됩니다.
저장소 검증
변경 사항을 배포하거나 패키지를 준비하기 전에 제공된 검사를 실행하세요.
npm test
npm run check:public-boundary
npm pack --dry-run유용한 공개 참고 자료
결론
Tetrees Agent EX는 Tetrees AI Pack을 검색, 평가, 실행, 확장 및 게시하기 위한 투명한 공개 계약을 제공합니다. 읽기 전용 검토부터 시작하고, 모델로 자금을 충당하는 작업 전에 정확한 견적을 요청하며, 비용 지출과 쓰기 작업에는 명시적인 확인을 요구하고, 사용자가 소유한 모든 자격 증명과 확장 권한은 로컬에 유지하세요.