{
  "format": "agent-article-v0",
  "article_id": "EA-272",
  "canonical_url": "/tools/ea-272-model-tool-health-check",
  "page_type": "reference",
  "claim_ids": [],
  "evidence_ids": [
    "EA-272-CURRENT-APPROVAL",
    "EA-272-CURRENT-BODY-READBACK"
  ],
  "unknown_ids": [
    "EA-272-UNKNOWN-01"
  ],
  "operational_object_ids": [],
  "provider": [],
  "models": [],
  "plans": [],
  "surfaces": [],
  "regions": [],
  "current_status": "CURRENT",
  "observation_status": "SPEC_ONLY",
  "freshness": "CURRENT",
  "last_verified": "2026-10-06",
  "supersedes": [],
  "superseded_by": [],
  "provenance": [
    "CANDIDATE-EA272-FIRST-20261006-C2-RESCUE20261014",
    "BODY-SHA256:0b6210bd850f45a98f318dcbfa122c68fd640fbe12bd678623200480e8117815"
  ],
  "article_sources": [
    {
      "id": "EA-272-CURRENT-APPROVAL",
      "evidence_class": "RESEARCH",
      "title": "現行本文の監査・revision対応",
      "supports": [
        "現行台帳のAUDIT_PASSと候補・revision・本文ハッシュの対応を確認しています。"
      ],
      "limit": "監査状態と来歴の記録です。外部根拠の最新性や本文の全主張を追加保証しません。",
      "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET",
      "source_or_experiment_ids": [
        "CANDIDATE-EA272-FIRST-20261006-C2-RESCUE20261014"
      ],
      "supporting_locators": [
        "1KqhJtiSb2S84rWmeYVwKcT_76dBwZ_B0ZZuAWQqH0rQ/EA_REVISION_LEDGER#ea_id=EA-272&revision_id=EA-272-FIRST-20261006&candidate_id=CANDIDATE-EA272-FIRST-20261006-C2-RESCUE20261014",
        "EA-272-FIRST-20261006"
      ],
      "provenance_status": "CURRENT_CANONICAL_APPROVAL_READBACK"
    },
    {
      "id": "EA-272-CURRENT-BODY-READBACK",
      "evidence_class": "IMPL",
      "title": "現行本文の収録照合",
      "supports": [
        "公開生成入力の本文SHA-256が、監査済み候補に結び付いたハッシュと一致しています。"
      ],
      "limit": "本文の同一性の検査です。外部システムの挙動や全主張の真偽を実証したものではありません。",
      "checked_at": "2026-10-24",
      "origin_class": "IMPLEMENTATION_READBACK",
      "source_or_experiment_ids": [
        "BODY-SHA256:0b6210bd850f45a98f318dcbfa122c68fd640fbe12bd678623200480e8117815"
      ],
      "supporting_locators": [
        "content/staging/EA-272.md",
        "0b6210bd850f45a98f318dcbfa122c68fd640fbe12bd678623200480e8117815",
        "EA-272-FIRST-20261006"
      ],
      "provenance_status": "CURRENT_APPROVED_BODY_HASH_MATCH"
    }
  ],
  "research_sections": [
    {
      "heading": "要点と前提",
      "text": "AI/Agent運用のhealth checkは、単一の「200 OK」や単発LLM応答で健全性を断定せず、少なくとも process liveness、traffic readiness、model endpoint、tool/dependency、end-to-end synthetic journey を別々の信号として扱う。"
    },
    {
      "heading": "設計原則",
      "text": "- livenessはプロセスが進行可能かを確認し、下流依存障害を理由に安易に再起動しない。readinessは必須依存を含め、実際に要求を受けられるかを判定する。\n- model healthはHTTP成功だけでなく、model ID、認証、rate-limit/5xx、TTFT/latency、stream完了、最小の応答契約を観測する。ただしsynthetic promptの成功を業務品質保証へ外挿しない。\n- tool healthは「到達可能」と「安全に正しい副作用を完了できる」を分ける。read-only probeを優先し、write probeが必要ならsandbox/idempotency/cleanup/readbackを明示する。\n- dependencyを一つのANDへ無条件集約しない。必須・任意・degraded-mode可能を分類し、optional dependency障害だけで全instanceをtrafficから除外しない。\n- health verdictには観測時刻、probe version、target/model/tool version、timeout、failure threshold、観測地点を残す。UNKNOWN/insufficient dataをhealthyへ暗黙変換しない。\n- probe自体の障害、資格情報失効、network partition、provider側障害、false positive/negativeをfailure envelopeへ含める。"
    },
    {
      "heading": "AI固有のprobe層",
      "text": "1. Provider/API: DNS/TLS/auth、HTTP/API status、rate limit、model availability。\n2. Model invocation: bounded synthetic request、TTFT/latency、stream termination、schema/minimum response contract。\n3. Retrieval/tool: permission-aware read、timeout、error class、result freshness。副作用toolは原則read-only healthと実write verificationを分離する。\n4. Agent journey: representativeだが低リスクなsynthetic taskでmodel→tool→policy→finalizationを確認する。\n5. Business SLI: synthetic healthとは独立に、実トラフィックのtask completion、tool correctness、policy violation、latency等を監視する。"
    },
    {
      "heading": "判定と自動化",
      "text": "health check結果を即座にrestart/failoverへ直結させず、連続失敗、複数観測地点、hysteresis/cooldown、dependency scopeを考慮する。failover先も同じshared dependencyを使う場合、切替は復旧にならない。自動remediationはblast radius、rate limit、rollback、readbackを持つ場合だけ許可する。"
    },
    {
      "heading": "SAFE_WORDING",
      "text": "「health checkが成功した」は、そのprobeが定義した時点・地点・契約を満たしたことだけを意味する。モデル品質、全tool、全tenant、end-to-end業務成功、将来の可用性を保証しない。"
    },
    {
      "heading": "OPEN_UNKNOWN",
      "text": "組織のcritical journey、必須/任意dependency、provider/model/version、tool権限、probe credential、sampling interval、timeout/threshold、failover topology、write-probe sandbox、data retention、PII/secret policy、tenant別挙動は導入環境で確認する。"
    }
  ],
  "human_url": "/tools/ea-272-model-tool-health-check",
  "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-272-model-tool-health-check",
  "json_url": "/agent/article.json?path=%2Ftools%2Fea-272-model-tool-health-check"
}