{ "format": "agent-article-v0", "article_id": "EA-172", "canonical_url": "/tools/ea-172-braintrust", "page_type": "reference", "claim_ids": [], "evidence_ids": [ "EVD-EA-172-URL-359449B4C288", "EVD-EA-172-URL-40D42717C665", "EVD-EA-172-URL-17F9A2F8D0F9", "EVD-EA-172-URL-431B52C30025", "EA-172-CURRENT-APPROVAL", "EA-172-CURRENT-BODY-READBACK" ], "unknown_ids": [ "EA-172-UNKNOWN-01" ], "operational_object_ids": [], "provider": [], "models": [], "plans": [], "surfaces": [], "regions": [], "current_status": "CURRENT", "observation_status": "SPEC_ONLY", "freshness": "CURRENT", "last_verified": "2026-09-14", "supersedes": [], "superseded_by": [], "provenance": [ "ORPHAN-RESCUE-EA172-20261019-C1", "SRC-EA-172-URL-359449B4C288", "SRC-EA-172-URL-40D42717C665", "SRC-EA-172-URL-17F9A2F8D0F9", "SRC-EA-172-URL-431B52C30025", "BODY-SHA256:f2f2d04efbde49562c8bccb9af5125acb5d5866495a7e582ce5b30e6670868d1" ], "article_sources": [ { "id": "EVD-EA-172-URL-359449B4C288", "evidence_class": "RESEARCH", "title": "Braintrust official product page, accessed 2026-10-19:", "href": "https://www.braintrust.dev/", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-172-URL-359449B4C288" ], "supporting_locators": [ "Source / provenance locator", "- Braintrust official product page, accessed 2026-10-19: https://www.braintrust.dev/" ], "scope": "Source / provenance locator", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EVD-EA-172-URL-40D42717C665", "evidence_class": "RESEARCH", "title": "Braintrust, “Our approach to hybrid deployment,” 2025-01-08, accessed 2026-10-19:", "href": "https://www.braintrust.dev/blog/hybrid-deployment", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-172-URL-40D42717C665" ], "supporting_locators": [ "Source / provenance locator", "- Braintrust, “Our approach to hybrid deployment,” 2025-01-08, accessed 2026-10-19: https://www.braintrust.dev/blog/hybrid-deployment" ], "scope": "Source / provenance locator", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EVD-EA-172-URL-17F9A2F8D0F9", "evidence_class": "RESEARCH", "title": "Braintrust, “Security is a choice: how Braintrust lets you decide where your AI data lives,” 2026-01-21, accessed 2026-10-19:", "href": "https://www.braintrust.dev/blog/security-data-control", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-172-URL-17F9A2F8D0F9" ], "supporting_locators": [ "Source / provenance locator", "- Braintrust, “Security is a choice: how Braintrust lets you decide where your AI data lives,” 2026-01-21, accessed 2026-10-19: https://www.braintrust.dev/blog/security-data-control" ], "scope": "Source / provenance locator", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EVD-EA-172-URL-431B52C30025", "evidence_class": "RESEARCH", "title": "Braintrust Data Processing Addendum, accessed 2026-10-19:", "href": "https://www.braintrust.dev/legal/dpa", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-172-URL-431B52C30025" ], "supporting_locators": [ "Source / provenance locator", "- Braintrust Data Processing Addendum, accessed 2026-10-19: https://www.braintrust.dev/legal/dpa" ], "scope": "Source / provenance locator", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EA-172-CURRENT-APPROVAL", "evidence_class": "RESEARCH", "title": "現行本文の監査・revision対応", "supports": [ "現行台帳のAUDIT_PASSと候補・revision・本文ハッシュの対応を確認しています。" ], "limit": "監査状態と来歴の記録です。外部根拠の最新性や本文の全主張を追加保証しません。", "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET", "source_or_experiment_ids": [ "ORPHAN-RESCUE-EA172-20261019-C1" ], "supporting_locators": [ "1KqhJtiSb2S84rWmeYVwKcT_76dBwZ_B0ZZuAWQqH0rQ/EA_REVISION_LEDGER#ea_id=EA-172&revision_id=EA-172-V21-LEGACY-MIGRATION-20261003-R1&candidate_id=ORPHAN-RESCUE-EA172-20261019-C1", "EA-172-V21-LEGACY-MIGRATION-20261003-R1" ], "provenance_status": "CURRENT_CANONICAL_APPROVAL_READBACK" }, { "id": "EA-172-CURRENT-BODY-READBACK", "evidence_class": "IMPL", "title": "現行本文の収録照合", "supports": [ "公開生成入力の本文SHA-256が、監査済み候補に結び付いたハッシュと一致しています。" ], "limit": "本文の同一性の検査です。外部システムの挙動や全主張の真偽を実証したものではありません。", "checked_at": "2026-10-19", "origin_class": "IMPLEMENTATION_READBACK", "source_or_experiment_ids": [ "BODY-SHA256:f2f2d04efbde49562c8bccb9af5125acb5d5866495a7e582ce5b30e6670868d1" ], "supporting_locators": [ "content/staging/EA-172.md", "f2f2d04efbde49562c8bccb9af5125acb5d5866495a7e582ce5b30e6670868d1", "EA-172-V21-LEGACY-MIGRATION-20261003-R1" ], "provenance_status": "CURRENT_APPROVED_BODY_HASH_MATCH" } ], "research_sections": [ { "heading": "要点と前提", "text": "CANDIDATE_ID: ORPHAN-RESCUE-EA172-20261019-C1" }, { "heading": "概要", "text": "Braintrustは、生成AI／エージェントの評価と本番観測を同じ品質改善ループへ接続するためのプラットフォームである。現在の公式情報では、実験・データセット・スコアリングに加え、本番トレース、ツール呼び出し、レイテンシ、コスト、品質指標を観測し、本番で見つかった失敗を評価データセットへ戻す運用を中心に据えている。Enterprise AI運用で重要なのは、単に「ログを集める製品」として扱うのではなく、評価基準・観測データ・リリース判断を同じ証拠連鎖へ接続できる点である。" }, { "heading": "運用上の意味", "text": "Braintrustを導入する場合、まず「何を良い出力とみなすか」を評価器、コード、LLM-as-a-judge、人手レビューなどで明示し、その基準を実験と本番観測の双方へ適用する。トレースにはプロンプト、モデル呼び出し、ツール呼び出し、エラー、トークン、コスト、レイテンシ等が含まれ得るため、障害解析だけでなく、品質回帰・コスト増・ツール失敗・特定経路の劣化を同じ単位で追跡できる。本番トレースを回帰テストへ戻す運用は、実際に発生した失敗を次回リリースの受入条件へ変換するために有効である。" }, { "heading": "具体的なcontrol / implementation implication", "text": "1. 評価器を「品質の真実」とみなさず、対象タスク、期待値、許容誤差、評価器のバージョン、入力集合を固定して再現可能にする。LLM-as-a-judgeを使う場合はjudge modelやprompt変更自体を評価対象として管理する。\n2. 本番トレースから回帰ケースを採取する際は、PII・機密情報・顧客データをそのまま評価データセットへ複製しない。マスキング、アクセス制御、保持期間、削除、エクスポート先を組織ポリシーに合わせる。\n3. 品質スコアだけでリリースを決めず、エラー率、レイテンシ、コスト、ツール失敗、セキュリティ上の拒否・逸脱など複数の運用指標と組み合わせる。平均値だけでなく失敗例をreadbackする。\n4. トレース計装の欠落を「正常」と誤認しない。重要なモデル呼び出し、検索、ツール、ルータ、後処理がspanとして捕捉されているかを検証し、trace completenessを監視する。\n5. SaaS、hybrid/self-hostedでデータ境界が異なるため、導入時にcontrol planeとdata planeの通信、保存対象、外向き通信、認証、暗号化、監査ログ、バックアップ／削除責任を構成図で固定する。" }, { "heading": "failure envelope", "text": "評価・観測基盤を入れても、評価器が実ユーザー価値を表していなければ高スコアのまま失敗できる。計装漏れ、sampling、非同期spanの欠落、遅延到着、モデル／prompt／tool versionの記録不足があれば原因追跡を誤る。LLM-as-a-judgeはモデル更新やprompt変更で判定分布が変わり得る。人手評価も評価者間差がある。さらに、トレースに機密情報を含めると、観測性の向上と引き換えに新しいデータ露出面を作る。\n\n\nHybrid構成ではdata planeを自組織環境へ置けるが、control planeとの分離を理由に「データが一切外部へ出ない」と一般化してはならない。公式説明ではdata planeに実験記録、ログ、dataset、prompt/completion、human review scores等を置き、control planeには組織・project等のmetadata、hashed API keys、暗号化されたprovider secrets等を置く。実際のネットワーク経路、telemetry、ブラウザ接続、認証サービス、組織固有設定は導入時に確認する必要がある。" }, { "heading": "適用境界", "text": "Braintrustの公式サイト／公式記事は製品機能と推奨運用の一次情報として有用だが、自社tenantでの可用性、plan差、SLA、DPA、data residency、保持設定、性能、trace loss率、評価器の妥当性を自動的に証明しない。製品比較記事に含まれる他社比較や優位性主張はvendor-authoredであり、独立比較として扱わない。" }, { "heading": "counterevidence / limitations", "text": "観測と評価が統合されても、評価設計そのものの妥当性は利用者側の責任として残る。公式のhybrid説明はデータ境界を具体化する一方、組織ごとのIAM、network policy、鍵管理、バックアップ、削除、監査証跡が適切に設定されていることまでは保証しない。公式privacy policyも完全なsecurityを保証しない旨を明記している。したがって「Braintrustを導入すれば品質・セキュリティ・コンプライアンスが保証される」という記述は不適切である。" }, { "heading": "OPEN_UNKNOWN", "text": "- 現在契約するplan／region／tenantで利用できる保持、export、SSO/RBAC、BAA、data residency等の正確な条件。\n- 自社workloadにおけるtrace欠落率、計装overhead、検索／集計性能、障害時の復旧特性。\n- 自社評価器が本番ユーザー価値や安全性をどの程度代表するか。\n- SDK、CLI、各integrationの現行versionごとの互換性とbreaking-change境界。\n- vendor-authored比較を超えた独立比較での相対的な評価有効性。" }, { "heading": "SAFE_WORDING", "text": "Braintrustは、生成AI／エージェントの実験・評価と本番トレースを接続し、品質、失敗、コスト、レイテンシ等を継続的に検証するための運用基盤として利用できる。導入効果は、評価設計、計装範囲、データ境界、tenant／plan設定、組織固有の運用統制に依存するため、製品機能の存在を品質保証やコンプライアンス保証へ外挿してはならない。" }, { "heading": "Source / provenance locator", "text": "- Canonical prior research: COMM-049-EA0172, legacy research source bundle Drive 1th35HsaM1ScfaviZGKJIRhS2WCWv7t9D, derived source SHA256 239aa867942a431600b8d90f9877dfa9ba8de25dd53b6a68c3325d1eec785dd8.\n- Quality supplement: EA-172_Braintrust_quality_supplement_2026-10-02 / libfile_8c00483dfb4881919344a6c542e01a0d (ledger locator).\n- Braintrust official product page, accessed 2026-10-19: https://www.braintrust.dev/ — observability, evals, production traces, trace-to-dataset workflow.\n- Braintrust, “Our approach to hybrid deployment,” 2025-01-08, accessed 2026-10-19: https://www.braintrust.dev/blog/hybrid-deployment — control/data plane separation, stored data classes, SDK routing and self-hosting boundary.\n- Braintrust, “Security is a choice: how Braintrust lets you decide where your AI data lives,” 2026-01-21, accessed 2026-10-19: https://www.braintrust.dev/blog/security-data-control — managed/hybrid security and masking claims; treat as vendor-authored product/security statement.\n- Braintrust Data Processing Addendum, accessed 2026-10-19: https://www.braintrust.dev/legal/dpa — formal definitions of control plane/data plane and processing/security obligations.\n- Braintrust Privacy Policy, accessed 2026-10-19 — security/retention limitation; exact contractual applicability must be checked against the current agreement/tenant." }, { "heading": "監査時の確認点", "text": "監査では、canonical topicがBraintrustのまま維持されていること、vendor-authored claimを独立比較へ昇格していないこと、hybridのdata/control plane境界を過剰一般化していないこと、評価器・計装・保持・tenant条件のUNKNOWNを残していることを確認する。" } ], "human_url": "/tools/ea-172-braintrust", "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-172-braintrust", "json_url": "/agent/article.json?path=%2Ftools%2Fea-172-braintrust" }