템플릿

프로젝트 템플릿 및 일반적인 구성에 대한 정보입니다.

기본 프로젝트#

create-astreus-agent를 실행하면 선택 사항에 따라 프로젝트를 생성하는 대화형 설정을 받게 됩니다.

bash
npx create-astreus-agent my-agent

생성된 프로젝트에는 시작에 필요한 모든 것이 포함되어 있습니다.

생성된 프로젝트 구조#

text
my-agent/
├── src/
│   └── index.ts      # 에이전트 설정이 포함된 메인 진입점
├── package.json      # 의존성 및 스크립트
├── tsconfig.json     # TypeScript 설정 (TypeScript 선택 시)
├── .env.example      # 환경 변수 템플릿
├── .gitignore        # Git ignore 규칙
└── README.md         # 프로젝트 문서

Package.json 스크립트#

json
{
  "scripts": {
    "dev": "tsx src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

일반적인 구성#

기본 채팅 에이전트#

간단한 대화형 에이전트를 위해 메모리 기능만 선택하세요.

text
? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◯ Knowledge (RAG)
  ◯ Graph Workflows
  ◯ Sub-Agents
  ◯ Custom Plugins
  ◯ MCP Integration

RAG 지원 에이전트#

문서 인식 응답을 위해 메모리와 지식을 선택하세요.

text
? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◉ Knowledge (RAG) - Document ingestion and retrieval
  ◯ Graph Workflows
  ◯ Sub-Agents
  ◯ Custom Plugins
  ◯ MCP Integration

전체 기능 에이전트#

최대 성능을 위해 모든 기능을 선택하세요.

text
? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◉ Knowledge (RAG) - Document ingestion and retrieval
  ◉ Graph Workflows - DAG-based task orchestration
  ◉ Sub-Agents - Multi-agent coordination
  ◉ Custom Plugins - Extensible tool system
  ◉ MCP Integration - Model Context Protocol support

프로바이더별 설정#

OpenAI#

기본 모델: gpt-4o

생성되는 .env.example:

text
OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)#

기본 모델: claude-sonnet-5

생성되는 .env.example:

text
ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)#

기본 모델: gemini-2.0-flash

생성되는 .env.example:

text
GEMINI_API_KEY=your-api-key-here

Ollama (로컬)#

기본 모델: llama3

생성되는 .env.example:

text
# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434

멀티 프로바이더#

생성되는 .env.example:

text
# Add API keys for providers you want to use
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
GEMINI_API_KEY=your-gemini-key

기능 비교#

기능사용 사례
Memory사용자 선호도, 대화 기록 기억
Knowledge문서 Q&A, 리서치 어시스턴트
Graph다단계 워크플로우, 파이프라인
Sub-Agents전문 작업, 병렬 처리
Plugins커스텀 도구, API 연동
MCP표준화된 도구 생태계

다음 단계#

프로젝트를 생성한 후:

bash
cd my-agent
npm install
cp .env.example .env
# Edit .env with your API keys
npm run dev

자세한 환경 설정은 구성을 참고하세요.