Pytestに着想を得た、RAG、エージェント、チャットボット、音声エージェントなどの指標を備える、LLMアプリ向けオープンソースPythonテストフレームワーク。
braintrustdata/autoevals
LLM-as-a-judge、ヒューリスティック、統計的な評価器でAIモデルの出力を採点するPython・TypeScriptライブラリ。
- スター
- 1,073
- フォーク
- 100
- 未解決の Issue
- 59
- 最終コミット
- 7 日前
これは何?
Autoevalsは、AIモデルの出力を自動評価するためのライブラリです。入力、出力、期待値を渡すと、組み込みのさまざまな評価器のいずれかが0〜1のスコアを返す、統一されたインターフェースを提供します。
このライブラリには3種類の評価手法が含まれています。事実性、安全性、要約、SQL、翻訳などのタスクでLLMを評価者として使うモデル採点型の評価、Levenshtein距離、完全一致、JSON diffなどのヒューリスティックなチェック、そしてBLEUなどの統計的指標です。さらに、faithfulness、context recall、answer relevancy向けのRAG専用スコアラーや、埋め込みベクトルの類似度評価も備えています。
選択肢ごとのスコアを設定できるカスタムプロンプトテンプレートや、Scoreオブジェクトを返す通常の関数を使って、独自の評価を作成できます。デフォルトではOPENAI_API_KEYで認証し、Braintrust AI Gatewayを含むOpenAI互換エンドポイントを指定できます。評価結果は任意でBraintrustに記録できます。
主な機能
- 01Factuality、Closed QA、Moderation、SQLなどのモデル採点型評価器
- 02Levenshtein距離、完全一致、JSON diffなどのヒューリスティックなスコアラー
- 03faithfulness、context recall、answer relevancy向けのRAGスコアラー
- 04カスタムプロンプトテンプレートと、独自のPythonまたはTypeScript採点関数
- 05同期・非同期呼び出しに対応し、あらゆるOpenAI互換APIで動作
ユースケース
- LLMの回答が参照回答と事実関係で一致しているかを確認する
- 開発中にRAGパイプラインの検索結果と回答品質を採点する
- テストスイートで一貫した指標を使い、プロンプトやモデルのバージョンを比較する
- 既存の評価ワークフローに、LLMによる評価やルールベースのチェックを追加する
クイックスタート
- 1
pipでPythonパッケージをインストールする
pip install autoevals - 2
環境変数OPENAI_API_KEYを設定する(デフォルトの認証方法)
- 3
PythonからFactuality評価を実行する
使う前に知っておきたいこと
- LLMベースの評価器にはAPIキーが必要で、デフォルトでは有料のモデル呼び出しが発生します。ただし、Braintrust Gatewayはベータ期間中無料です。
収録されている特集
トピック
よくある質問
- autoevals とは?
- LLM-as-a-judge、ヒューリスティック、統計的な評価器でAIモデルの出力を採点するPython・TypeScriptライブラリ。 Autoevalsは、AIモデルの出力を自動評価するためのライブラリです。入力、出力、期待値を渡すと、組み込みのさまざまな評価器のいずれかが0〜1のスコアを返す、統一されたインターフェースを提供します。
- autoevals は無料で使えますか?ライセンスは?
- autoevals は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- autoevals は今もメンテナンスされていますか?
- 活発にメンテナンス中。autoevals の最終コミットは 2026年10月30日 です。
- autoevals は何に使えますか?
- LLMの回答が参照回答と事実関係で一致しているかを確認する 開発中にRAGパイプラインの検索結果と回答品質を採点する テストスイートで一貫した指標を使い、プロンプトやモデルのバージョンを比較する 既存の評価ワークフローに、LLMによる評価やルールベースのチェックを追加する
- autoevals のインストール方法は?
- pipでPythonパッケージをインストールする: pip install autoevals 環境変数OPENAI_API_KEYを設定する(デフォルトの認証方法) PythonからFactuality評価を実行する
- autoevals はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/braintrustdata/autoevals
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
LLMアプリケーションの出力をテストするための、事前構築済み・カスタマイズ可能な評価器を備えたPythonおよびTypeScriptライブラリ。LLM-as-judgeによるスコアリングにも対応。
ホスト型またはローカルのJev系判定モデルを使ってエージェントの評価とガードレールを実行するPythonライブラリ。トレース内のすべてのチェックを1回のリクエストにまとめます。
Azure AI Evaluate SDKとOpenAIベースの評価器を使って、RAGチャットアプリを評価するスクリプトとツール。
LLMアプリやエージェントのトレース、評価、デバッグに使えるオープンソースのセルフホスト型AIオブザーバビリティ基盤。
MCPサーバー、MCPアプリ、ChatGPTアプリの検査、チャット、デバッグに使える、オープンソースのテスト・評価プラットフォームです。