LangChain：Deep Agentを使ってドキュメントを自己テストさせた方法

すべての開発者がこの不満を知っています：公式ドキュメントからコード例をコピーして実行すると——動きません。APIが変更され、パラメーターが名前変更されましたが、ドキュメントは更新されていません。LangChainは自社のAIエージェントを使ってこの問題を解決することにしました。

ドキュメント自己テストシステムはどのように機能しますか？

LangChainはDeep Agentを使用します——.deepagents/skills/ディレクトリに整理された複数の専門スキルを持つAIエージェントです。システムはドキュメントを自動的に走査し、すべてのインラインコードスニペットを識別し、スタンドアロンのテストファイルに移行します。

抽出された各スニペットは、すべてのコミットでGitHub Actionsを通じて実行される実行可能テストになります。APIが変更されてテストが失敗した場合——システムはAPIの現在の状態を反映する検証済みのコードスニペットを自動的に再生成し、ドキュメントを更新します。

なぜこれはLangChain以外にも関連するのですか？

「テスト付きコードとしてのドキュメント」のアプローチは新しくありませんが、全サイクルを自動化するためにAIエージェントを使用することは新しいです。伝統的に、ドキュメントのテストは各例のテストを手動で書くことを必要とします——この作業は製品機能に直接影響を与えないため、ほとんどメンテナンスされません。

LangChainのアプローチは本番コードと同じ厳格さでドキュメントを扱います：すべての例はテストに合格しなければならず、すべてのテストは自動的に実行され、すべての失敗は自動的に修正されます。APIが毎週変わる高速な開発サイクルのプロジェクトにとって、これは機能するドキュメントと不満を生むドキュメントの違いです。

システムは、他のオープンソースプロジェクトが自分たちのニーズに合わせて適応できる参照実装として利用可能です。