Şablonlar
Proje şablonları ve yaygın yapılandırmalar hakkında bilgi.
Varsayılan Proje#
create-astreus-agent komutunu çalıştırdığınızda, seçimlerinize göre bir proje oluşturan interaktif bir kurulum elde edersiniz.
npx create-astreus-agent my-agentOluşturulan proje, başlamak için ihtiyacınız olan her şeyi içerir.
Oluşturulan Proje Yapısı#
my-agent/
├── src/
│ └── index.ts # Main entry point with agent setup
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration (if TypeScript selected)
├── .env.example # Environment variables template
├── .gitignore # Git ignore rules
└── README.md # Project documentationPackage.json Script'leri#
{
"scripts": {
"dev": "tsx src/index.ts",
"build": "tsc",
"start": "node dist/index.js"
}
}Yaygın Yapılandırmalar#
Temel Sohbet Agent'ı#
Basit bir konuşma agent'ı için sadece Memory özelliğini seçin:
? Which features do you want to include?
◉ Memory - Persistent agent memory with vector search
◯ Knowledge (RAG)
◯ Graph Workflows
◯ Sub-Agents
◯ Custom Plugins
◯ MCP IntegrationRAG Destekli Agent#
Dokümana duyarlı yanıtlar için Memory ve Knowledge'ı seçin:
? 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 IntegrationTam Özellikli Agent#
Maksimum yetenekler için tüm özellikleri seçin:
? 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 supportSağlayıcıya Özel Kurulum#
OpenAI#
Varsayılan model: gpt-4o
Oluşturulan .env.example:
OPENAI_API_KEY=your-api-key-hereAnthropic (Claude)#
Varsayılan model: claude-sonnet-5
Oluşturulan .env.example:
ANTHROPIC_API_KEY=your-api-key-hereGoogle (Gemini)#
Varsayılan model: gemini-2.0-flash
Oluşturulan .env.example:
GEMINI_API_KEY=your-api-key-hereOllama (Yerel)#
Varsayılan model: llama3
Oluşturulan .env.example:
# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434Çoklu Sağlayıcılar#
Oluşturulan .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Özellik Karşılaştırması#
| Özellik | Kullanım Senaryosu |
|---|---|
| Memory | Kullanıcı tercihlerini, konuşma geçmişini hatırlama |
| Knowledge | Dokümantasyon soru-cevap, araştırma asistanları |
| Graph | Çok adımlı iş akışları, pipeline'lar |
| Sub-Agents | Uzmanlaşmış görevler, paralel işleme |
| Plugins | Özel araçlar, API entegrasyonları |
| MCP | Standartlaştırılmış araç ekosistemi |
Sonraki Adımlar#
Projenizi oluşturduktan sonra:
cd my-agent
npm install
cp .env.example .env
# Edit .env with your API keys
npm run devAyrıntılı ortam kurulumu için Yapılandırma sayfasına bakın.