{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-09T18:04:24.907Z",
  "record_id": "VXI-EXT-MS-AF-01-v1",
  "record_kind": "external_reference",
  "title": "Microsoft Agent Framework: Migration compatibility checks",
  "system": "Microsoft Agent Framework",
  "evidence_family": "agent_framework_migration",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Is moving from Semantic Kernel to Microsoft Agent Framework a drop-in replacement?",
  "near_questions": [
    "Can I replace Semantic Kernel without changing agent code?",
    "What should an agent framework migration review cover?",
    "Do existing tools need new registration when migrating?",
    "Can I assume conversation state survives a framework change?",
    "Are Python and .NET migration steps identical?",
    "Does a successor SDK preserve every old API?",
    "What changes in agent invocation results during migration?",
    "Which tests should verify migrated tool behaviour?",
    "Can a migration guide prove output equivalence?",
    "Does moving frameworks automatically improve performance?",
    "What version information belongs in a migration decision?",
    "How do I distinguish migration guidance from compatibility evidence?"
  ],
  "supported_claims": [
    {
      "claim": "Microsoft provides a migration guide with changes to packages, agent construction, session handling, tool registration and invocation results. The Python and .NET paths have language-specific mappings. Treat these as migration work items and verify the application behaviour after conversion. The successor relationship alone does not demonstrate equivalent outputs, preserved state or improved performance for an existing agent.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "drop-in compatibility",
    "equivalent application behaviour",
    "preserved stored sessions without migration checks",
    "measured performance improvement"
  ],
  "public_summary": "Microsoft provides a migration guide with changes to packages, agent construction, session handling, tool registration and invocation results. The Python and .NET paths have language-specific mappings. Treat these as migration work items and verify the application behaviour after conversion. The successor relationship alone does not demonstrate equivalent outputs, preserved state or improved performance for an existing agent.",
  "related_record_ids": [
    "VXI-EXT-MS-SK-ORCH-01-v1",
    "VXI-EXT-OTEL-SEMCONV-02-v1"
  ],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Semantic Kernel to Microsoft Agent Framework Migration Guide",
    "source_url": "https://learn.microsoft.com/en-us/agent-framework/migration-guide/from-semantic-kernel/",
    "checked_on": "2026-10-09",
    "candidate_record_id": "VXI-EXT-MS-AF-01-v1",
    "candidate_record_sha256": "3d3b2ba0a3083354664a6ac8cc535a02b665baca2b7fb1fbcac3ad069f72c97c",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "Microsoft provides a migration guide with changes to packages, agent construction, session handling, tool registration and invocation results. The Python and .NET paths have language-specific mappings. Treat these as migration work items and verify the application behaviour after conversion. The successor relationship alone does not demonstrate equivalent outputs, preserved state or improved performance for an existing agent.",
    "required_buyer_context": "Source and target packages, language, provider, tool registration, session persistence and application regression results. This reference performs no code conversion or deployment assessment.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#agent-framework-migration-contract",
  "machine_readable_record": "/varexis-index/records/agent-framework-migration-contract.json"
}
