設定

Astreusのドキュメントで設定について学び、エージェントシステムを構築するためのセットアップの手引き、APIのパターン、実践的な例を確認しましょう。信頼性の高いAstreusエージェントシステムを構築するために必要なセットアップのパターン、API、実践的な例を学びましょう。

Astreus エージェントプロジェクトの環境変数と設定オプションです。

環境設定

プロジェクトを作成したら、環境変数のサンプルファイルをコピーします。

cp .env.example .env

その後、.env を編集して設定を行います。

プロバイダー別の設定

生成される .env.example は、選択したプロバイダーによって異なります。

OpenAI

OPENAI_API_KEY=your-api-key-here

Anthropic

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini

GEMINI_API_KEY=your-api-key-here

Ollama

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

複数プロバイダー

# 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

完全な設定

本番環境へのデプロイでは、追加の設定が必要になる場合があります。

# ===== LLM PROVIDERS API KEYS =====

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here      # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key     # Optional

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here      # Optional

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here         # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key        # Optional

# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434

# ===== DATABASE CONFIGURATION =====

# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db

# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db

# ===== KNOWLEDGE/RAG SYSTEM =====

# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

# ===== APPLICATION SETTINGS =====

NODE_ENV=development       # development | production | test
LOG_LEVEL=info             # debug | info | warn | error | silent

# ===== DATABASE ENCRYPTION =====

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

データベース設定

SQLite(開発用)

開発向けのデフォルトで、追加設定は不要です。

DB_URL=sqlite://./astreus.db

PostgreSQL(本番用)

本番環境へのデプロイに推奨されます。

DB_URL=postgresql://user:password@localhost:5432/astreus_db

ナレッジデータベース

RAG 機能に必要です。pgvector を備えた PostgreSQL である必要があります。

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

pgvector のセットアップ

Docker を使う場合:

# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"

docker-compose up -d

セキュリティ

暗号化キー

安全な暗号化キーを生成します。

openssl rand -hex 32

環境変数に追加します。

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

本番環境チェックリスト

SQLite の代わりに PostgreSQL を使用する
暗号化を有効にする
NODE_ENV=production を設定する
LOG_LEVEL=warn または error を使用する
シークレットはファイルではなく環境変数に保存する
シークレットマネージャー(Vault、AWS Secrets など)を使用する

プロバイダーごとのデフォルトモデル

プロバイダー	デフォルトモデル
OpenAI	`gpt-4o`
Anthropic	`claude-sonnet-4-20250514`
Google	`gemini-2.0-flash`
Ollama	`llama3`

最終更新日: 2026年7月6日

このセクション内

はじめに

ベストプラクティスと適切なデフォルト設定で、新しい Astreus AI エージェントプロジェクトをスキャフォールドします。必要な機能を対話形式でエージェントに設定できます。信頼性の高いAstreusエージェントシステムを構築するために必要なセットアップのパターン、API、実践的な例を学びましょう。

クイックスタート

Astreusのドキュメントでクイックスタートについて学び、エージェントシステムを構築するためのセットアップの手引き、APIのパターン、実践的な例を確認しましょう。信頼性の高いAstreusエージェントシステムを構築するために必要なセットアップのパターン、API、実践的な例を学びましょう。

機能

Astreusのドキュメントで機能について学び、エージェントシステムを構築するためのセットアップの手引き、APIのパターン、実践的な例を確認しましょう。信頼性の高いAstreusエージェントシステムを構築するために必要なセットアップのパターン、API、実践的な例を学びましょう。

テンプレート