템플릿

Astreus 문서에서 템플릿에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

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

기본 프로젝트

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

npx create-astreus-agent my-agent

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

생성된 프로젝트 구조

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

Package.json 스크립트

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

일반적인 구성

기본 채팅 에이전트

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

? 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 지원 에이전트

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

? 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

전체 기능 에이전트

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

? 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:

OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)

기본 모델: claude-sonnet-4-20250514

생성되는 .env.example:

ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)

기본 모델: gemini-2.0-flash

생성되는 .env.example:

GEMINI_API_KEY=your-api-key-here

Ollama (로컬)

기본 모델: llama3

생성되는 .env.example:

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

멀티 프로바이더

생성되는 .env.example:

# 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	표준화된 도구 생태계

다음 단계

프로젝트를 생성한 후:

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

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

마지막 업데이트: 2026년 7월 6일

이 섹션에서

소개

모범 사례와 합리적인 기본값으로 새로운 Astreus AI 에이전트 프로젝트를 스캐폴딩하세요. 필요한 기능을 대화형으로 구성할 수 있습니다. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

빠른 시작

Astreus 문서에서 빠른 시작에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

기능

구성