vercel/aiは、TypeScriptでAIアプリケーションやエージェントを作るための「AI SDK」のモノレポです。OpenAI・Anthropic・Google Geminiなど複数のLLMプロバイダーを統一インターフェースで扱えるライブラリと、その公式ドキュメントサイト(apps/docs)を含んでいます。Next.js・React・Vue・Svelteなど複数フレームワークに対応する構成です。
提供された実ファイルはSDK本体(packages/以下)ではなく、CIとリリース基盤、ドキュメントサイトのコードが中心です。.changesetディレクトリと.github/workflows/actions/verify-changesetsは、packages/配下のコード変更に対してchangesetファイルの記載を強制する仕組みで、コミット単位でパッケージのバージョン管理をしています。.github/scripts/notify-releasedとupload-provenanceは、npm公開後にレジストリへの反映をポーリングで確認し、SLSA provenance(npmのSigstore署名)をGitHub Releaseの資産として再添付するスクリプトです。apps/docsはNext.js製のドキュメントサイトで、content/cookbook以下のMDXガイド(RAGエージェント、マルチモーダルエージェント、Slackbotなど)をバージョン別(v5・v6)に配信します。sync-content-utils.test.mjsからは、MDXの見出しやコードフェンス記法を変換してドキュメントサイトの表示形式に整える処理があることが分かります。
- STEP 01
npm installでaiパッケージと使いたいプロバイダーパッケージ(例 @ai-sdk/openai)を導入し、APIキーを環境変数に設定する必要があります。
- STEP 02
cookbookガイドに沿ってgenerateTextやstreamTextを呼び出すと、まずTypeScriptの型補完でパラメータ(model, prompt, messagesなど)が示されます。
- STEP 03
ストリーミング系の関数を使うと、テキストがチャンク単位で届く様子をターミナルやUIで確認できます。
- STEP 04
モノレポ全体を試す場合は、packages配下を変更するとverify-changesetsのCIが動き、.changeset配下にmdファイルを追加しないとPRチェックが失敗します。
- STEP 05
ドキュメントサイト(apps/docs)をローカルで動かすと、v5・v6のバージョン別ドキュメントとllms.txt形式のエンドポイントが生成される構成が見えます。
手に入るのは、複数のLLMプロバイダーを同じAPI(generateText, streamTextなど)で切り替えられるTypeScriptライブラリと、その周辺のリリース自動化・ドキュメント基盤です。実際にコードを書けば、プロバイダーごとの差異を意識せずにテキスト生成やストリーミングチャットを実装できる状態が得られます。
今回提示された実ファイルはCIスクリプトとドキュメントサイトのコードが中心で、packages/ai本体のsrcコード(generateTextなどの実装)は含まれていないため、コア機能の内部実装そのものは今回の資料だけでは検証できません。
README断片も.changeset用のテンプレート文言のみで、プロジェクト本体の説明文としては情報が限られています。
ファイルツリーの多くがapps/docsとGitHub Actions関連に偏っており、packages配下の各プロバイダー実装ファイルは一覧に出てきていません。
TypeScriptでLLMを使ったアプリやエージェントを作りたい開発者、特にNext.jsなどVercel系フレームワークと組み合わせたい人に向いています。changesetによる厳格なバージョン管理、npm公開後のprovenance添付、ドキュメントサイトのバージョン管理(v5・v6)など、リリース運用の作り込みは今回のファイルから明確に確認できました。一方でコア機能(generateTextなどの実装本体)は今回の資料に含まれていないため、その部分の品質判断はこのレビューの範囲外である点を踏まえて利用してください。