Documentation Index
Fetch the complete documentation index at: https://docs.shannon.run/llms.txt
Use this file to discover all available pages before exploring further.
クイック診断
特定の問題に入る前に、これらのクイックチェックを実行してください:
# すべてのサービスが実行中であることを確認
docker compose ps
# すべてのサービスから最近のログを表示
docker compose logs --tail=50
# 特定のサービスヘルスを確認
curl http://localhost:8080/health
curl http://localhost:8000/health # LLM Service
インストール & セットアップの問題
Docker Composeが起動しない
症状:
- サービスが起動しない
- 終了コードエラー
- コンテナが即座にクラッシュ
一般的な原因と解決策:
- Dockerデーモンが実行されていない
docker info
# macOS: open -a Docker
# Linux: sudo systemctl start docker
- ポートの競合
lsof -i :8080 # Gateway
lsof -i :50051 # Agent Core
lsof -i :50052 # Orchestrator
- .envファイルが見つからない
make setup
# または
cp .env.example .env
echo "OPENAI_API_KEY=sk-..." >> .env
API & 接続の問題
401 Unauthorized
解決策1: 認証を無効化(開発環境)
# .envで
GATEWAY_SKIP_AUTH=1
docker compose restart gateway
タスクがRUNNINGまたはQUEUED状態のまま
一般的な原因:
- 無効なLLM APIキー
- LLMプロバイダーのレート制限
- ネットワーク接続の問題
docker compose logs llm-service | grep -i "api key\|unauthorized\|quota"
予算 & コストの問題
予算超過エラー
.envで予算制限を増やす:
MAX_COST_PER_REQUEST=1.00
MAX_TOKENS_PER_REQUEST=20000
docker compose restart orchestrator llm-service
パフォーマンスの問題
レスポンスが遅い
リソースを確認:
ワーカー並行性を調整:
# .envで
WORKER_ACT_CRITICAL=5
WORKER_WF_CRITICAL=3
TOOL_PARALLELISM=2
デバッグツール
ログの表示
# すべてのサービス
docker compose logs -f
# 特定のサービス
docker compose logs -f orchestrator
# エラーを検索
docker compose logs orchestrator | grep -i error
Temporal UI
http://localhost:8088 にアクセスしてWorkflowを確認
ヘルスチェック
curl http://localhost:8080/health
curl http://localhost:8000/health
ヘルプの取得
GitHub Issues
バグ報告や機能リクエスト