テンプレート

プロジェクトテンプレートと一般的な構成についての情報です。

デフォルトプロジェクト#

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 の無視ルール
└── README.md         # プロジェクトドキュメント

Package.json のスクリプト#

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

一般的な構成#

基本的なチャットエージェント#

シンプルな会話型エージェントには Memory 機能のみを選択します。

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 対応エージェント#

ドキュメントを踏まえた応答には Memory と Knowledge を選択します。

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

詳細な環境設定については 設定 を参照してください。