Reactive Agents — フレームワーク概要

エージェントの目的

このスキルを読み込むと、以下のことが分かります：(1) フレームワークが何をするか、(2) 標準的なビルダーチェーンパターン、(3) 手元のタスクに対してどの機能スキルを読み込むべきか。

フレームワーク概要

Reactive Agents は、TypeScript で自律型 AI エージェントを構築するための Effect-TS 層状ランタイムです。エージェントは流暢な ReactiveAgentBuilder で構成されます。各 .withX() 呼び出しでオプションの機能レイヤーを配線します。このランタイムは、推論、メモリ、ツール、MCP、ガードレール、アイデンティティ、オブザーバビリティ、オーケストレーション、コスト、検証、評価、A2A ネットワーキング、ウェブフレームワーク統合(React、Vue、Svelte)をカバーする 25 個のパッケージを備えています。

6 つの LLM プロバイダーがサポートされています：anthropic、openai、gemini、ollama、litellm、および test。

標準的なビルダーパターン

import { ReactiveAgents } from "@reactive-agents/runtime";

const agent = await ReactiveAgents.create()
  .withName("my-agent")
  .withProvider("anthropic")          // required
  .withModel("claude-sonnet-4-6")     // optional — uses provider default if omitted
  .withReasoning({ defaultStrategy: "adaptive", maxIterations: 10 })
  .withTools()                        // enables all built-in tools
  .withMemory({ tier: "enhanced", dbPath: "./agent.db" })
  .withObservability({ verbosity: "normal", live: true })
  .build();                           // always await — returns Promise<ReactiveAgent>

const result = await agent.run("Your task here");
console.log(result.output);
console.log(result.metadata.stepsCount, result.metadata.strategyUsed);

スキルのルーティング — 構築内容で選択

構築内容	読み込むスキル
任意のエージェント(ここから始める)	builder-api-reference
タスクエージェント(リサーチ、分析、コーディング)	reasoning-strategy-selection、tool-creation
シェルコマンドを実行するエージェント	shell-execution-sandbox
永続的なメモリを持つエージェント	memory-patterns、context-and-continuity
MCP ツールを使用するエージェント	mcp-tool-integration
常時稼働・スケジュール実行エージェント	gateway-persistent-agents
マルチエージェントワークフロー	multi-agent-orchestration
ウェブアプリに組み込まれたエージェント	ui-integration、interaction-autonomy
本番環境・マルチテナントエージェント	identity-and-guardrails、cost-budget-enforcement
出力品質保証付きエージェント	reasoning-strategy-selection、quality-assurance
エージェント間ネットワーキング	a2a-agent-networking
カスタムプロバイダー動作またはローカルモデル	provider-patterns

レシピスキル — 完全なリファレンス実装

レシピスキルを読み込んで、完全に動作する例を入手します：

レシピ	構築内容
recipe-research-agent	メモリ + 検証機能付きリサーチ・分析エージェント
recipe-code-assistant	コード生成 + サンドボックス化されたシェル実行
recipe-persistent-monitor	ゲートウェイ + クーロン経由の常時監視
recipe-orchestrated-workflow	マルチエージェントパイプライン、リード・ワーカーパターン
recipe-saas-agent	アイデンティティ + コスト制御付きマルチテナントエージェント
recipe-embedded-app-agent	React/Vue/Svelte のストリーミング UI 付きエージェント

ビルダーファクトリメソッド

ReactiveAgents.create()                      // blank builder
ReactiveAgents.fromConfig(config)            // from AgentConfig object
ReactiveAgents.fromJSON(json)                // from JSON string
ReactiveAgents.runOnce("task", builder)      // build + run + dispose in one call
builder.buildEffect()                        // returns Effect<ReactiveAgent> for Effect runtimes

よくある落とし穴

• .build() は非同期です。常に await してください。忘れると、サイレントに「agent is undefined」エラーが発生します
• .withProvider() は必須です。デフォルトプロバイダーはありません
• 引数なしの .withTools() は 5 つの標準ツール(web-search、http-get、file-read、file-write、code-execute)を有効にします。シェル実行は .withTerminalTools() 経由のみオプトインです。allowedTools で標準ツールを制限することができます
• ストラテジー名は "plan-execute-reflect" です。"plan-execute" ではありません(StrategyNotFoundError がスロー されます)
• メモリティアは "standard" と "enhanced" です。"1" と "2" ではありません(これらは廃止予定です)
• "groq" と "openrouter" は有効なプロバイダー名ではありません。プロキシ・ルータープロバイダーには "litellm" を使用してください