ai-agent-workflow

マルチエージェントワークフロー

再開可能なマルチエージェントワークフローを構築します。永続的な実行、ツールループ、クライアントの再接続時の自動ストリーム復旧に対応しています。

前提条件

以下のレシピを順番に完了してください。

better-env による型安全な環境設定

better-env の設定モジュールを使用して、サーバー／公開環境変数への型安全なアクセス、機能フラグ、いずれか一方の認証情報のみを許可する制約を設定します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/config-schema-setup

Neon + Drizzle のセットアップ

Drizzle ORM を使用して Next.js アプリを Neon Postgres に接続し、Vercel のサーバーレス関数向けに接続プーリングを最適化します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/neon-drizzle-setup

Better Auth のセットアップ

Drizzle ORM と Neon Postgres を使用して、Better Auth でユーザー認証を追加します。メールアドレス／パスワード認証の基本設定です。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/better-auth-setup

Neon による AI チャットの永続化

ツール、推論、ストリーミングを含む AI SDK メッセージパーツを完全にサポートし、AI チャットの会話を Neon Postgres に永続化します。時系列で並べ替え可能な ID には UUID v7 を使用します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/ai-chat-persistence

Pino ロギングのセットアップ

Pino で構造化ロギングを設定します。開発環境では人が読みやすいカラー表示のログを、本番環境ではログ集約サービス向けの構造化 JSON を出力します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/pino-logging-setup

クックブック - 以下のレシピを順番に完了してください

Workflow Development Kit のセットアップ

Workflow Development Kit をインストールして設定し、ステップ単位の永続化、ストリームの再開、エージェントのオーケストレーションに対応する、再開可能で永続的な AI エージェントワークフローを構築します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/workflow-setup

再開可能な AI レスポンスストリーム

WorkflowChatTransport、開始／再開 API エンドポイント、useResumableChat フックを使用して、AI チャットに自動ストリーム復旧を追加します。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/resumable-ai-streams

カスタム永続エージェント

streamText オプション、プロバイダー設定、ツールループを完全に制御できる、カスタムの永続的な AI エージェントを構築します。Workflow Development Kit と互換性があります。

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/custom-durable-agent

ワークフローのベストプラクティス

ステップ、ストリーミング、エージェント実行を含む永続的なワークフローを作成して実行します。ワークフローの開始、再開、結果の永続化について説明します。

bunx skills add andrelandgraf/fullstackrecipes/skills -s workflow-best-practices