조합 가능한 프로젝트 템플릿

cargo adk new은 다음 세 가지 선택 사항을 바탕으로 작동하는 Rust 프로젝트를 생성합니다.

1. 템플릿은 에이전트 또는 워크플로의 형태를 정의합니다.
2. 애드온은 세션, MCP 또는 원격 측정과 같은 기능을 추가합니다.
3. 엔터프라이즈 패턴은 일반적인 제품 형태에 맞춰 템플릿과 검토된 애드온 그룹을 선택합니다.

사용자 지정 템플릿 디렉터리가 기본 제공 레지스트리를 확장하거나 대체할 수 있으므로, 설치된 CLI이(가) 기준이 됩니다.

cargo adk templates
cargo adk addons
cargo adk new --help

프로젝트 생성

# One LLM agent
cargo adk new support-agent --template llm

# A tool-using agent with operating capabilities
cargo adk new support-agent \
  --template tools \
  --addon sessions \
  --addon telemetry \
  --addon guardrails

# Preview generated files without writing them
cargo adk new support-agent --template graph --dry-run

basic은(는) llm의 별칭으로 계속 제공됩니다. 새 문서와 자동화에서는 명시적인 llm 이름을 사용하세요.

기본 제공 템플릿

기본 제공 레지스트리에는 현재 13개의 템플릿이 포함되어 있습니다.

먼저 실행 형태를 선택하세요. 워크플로를 결정하는 데 세션, MCP, 원격 측정 또는 기타 제품 기능을 사용하는 대신 나중에 추가하세요.

기능 추가 기능

기능을 구성하려면 --addon을 반복하세요. 생성기는 해당 기능의 기능 플래그, 가져오기, 초기화 조각, 환경 예시 및 생성된 파일을 안정적인 우선순위에 따라 확인합니다.

예시:

cargo adk new order-agent \
  --template tools \
  --addon mcp \
  --addon sessions \
  --addon server \
  --addon auth \
  --addon telemetry

생성된 기능 코드는 시작점입니다. 출시 전에 자리 표시자 엔드포인트, 자격 증명, 정책 및 메모리 내 서비스를 배포 소유 방식으로 교체하세요.

구성된 엔터프라이즈 패턴

패턴은 일반 템플릿과 동일한 --template 네임스페이스에 나타납니다. 별도의 --pattern 플래그는 없습니다.

a2a는 계속 a2a-server의 별칭으로 유지됩니다.

cargo adk new operations-agent --template production
cargo adk new research-team --template multi-agent --addon eval
cargo adk new public-specialist --template a2a-server --addon auth

공급자 및 모델 선택

템플릿에는 기본 공급자가 있지만, 실행 형태를 변경하지 않고도 CLI가 이를 재정의할 수 있습니다.

cargo adk new support-agent \
  --template tools \
  --provider openai \
  --model company-approved-model

선택 항목이 없을 때 프롬프트를 표시하는 대신 실패하도록 CI에서는 --non-interactive를 사용하세요. 다른 프로그램에서 생성 결과를 필요로 할 때는 --json-output를 사용하세요.

사용자 지정 템플릿

조직에서 기본 제공 레지스트리 이상의 재사용 가능한 시작점을 필요로 하는 경우 TOML 매니페스트가 있는 디렉터리를 전달하세요.

cargo adk new finance-agent \
  --template company-finance \
  --template-dir ./agent-templates

기본 제공 템플릿과 이름이 같은 사용자 지정 템플릿은 해당 CLI 호출에서 기본 제공 템플릿을 대체합니다. 매니페스트를 버전 관리에 보관하고 생성된 프로젝트를 CI에서 테스트하세요.

name = "company-finance"
description = "Company finance agent with approved defaults"
provider = "openai"
features = ["minimal", "tools"]
imports = ["use std::sync::Arc;"]

생성된 프로젝트 확인

cd support-agent
cargo adk build
cargo run

cargo adk build는 배포하지 않고 생성된 프로젝트를 컴파일하고 검증합니다. 생성된 소스 코드를 커밋하고, 활성화된 기능과 환경 요구 사항을 검토하며, 동일한 명령을 CI 게이트로 유지하세요.

자동화를 최신 상태로 유지

레지스트리의 내용은 릴리스 간에 변경될 수 있습니다. 자동화된 프로젝트 생성을 업그레이드하기 전에 다음을 수행하세요.

cargo adk templates
cargo adk addons
cargo adk new smoke-agent --template tools --addon mcp --dry-run

이를 통해 빌드 환경에 설치된 정확한 cargo-adk 바이너리를 기준으로 이름과 호환성을 확인할 수 있습니다.