Subchapter 25.61

Schema Discover AI

references/shared/schema-discover-ai.mdMarkdown10 KBView on GitHub

Schema — ai-workload-profile.json

Why this file exists. ai-workload-profile.json is the artifact the entire AI track reads: clarify-ai.md, design-ai.md, , and all key off it. Without one written contract they drift on field names — the §13.3b class. This is the Azure port of gcp-to-aws’s , kept parallel so the downstream AI ports stay straight; the only changes are the source-provider swaps recorded in § Azure swaps.

Schema Discover AI · Azure To AWS · aws/agent-toolkit-for-aws · Skills Docs

estimate-ai.md

generate-artifacts-ai.md

schema-discover-ai.md

{
  "metadata": {
    "report_date": "<ISO 8601>",
    "project_directory": "<path>",
    "profile_source": "application_code", // application_code | iac_cognitive | merged
    "sources_analyzed": {
      "terraform": true,
      "application_code": false,
      "billing_data": false,
      "openai_usage_api": false
    }
  },
  "summary": {
    "overall_confidence": 0.0,
    "confidence_level": "high", // high | medium | low
    "total_models_detected": 0,
    "languages_found": [],
    "ai_source": "azure_openai", // azure_openai | openai | anthropic | both | other
    "inferred_from_iac": false
  },
  "models": [], // see § models[]; MAY be empty for iac_cognitive
  "integration": {}, // see § integration
  "infrastructure": [], // Azure AI Terraform resources; [] if no IaC
  "current_costs": {}, // ONLY if billing or usage-API ran — see § current_costs
  "detection_signals": [], // see § detection_signals[]
  "workloads": [], // ALWAYS present, [] if none — see § workloads[]
  "agentic_profile": null, // ONLY if is_agentic — see § agentic_profile
  "tool_manifest": [] // ONLY if agentic_profile exists — see § tool_manifest[]
}

{
  "model_id": "gpt-4o", // NOT model_name / name
  "service": "azure_openai", // NOT service_type / azure_service (see below)
  "detected_via": ["code"], // NOT detection_method — subset of code|terraform|billing
  "evidence": [{ "source": "code", "file": "app/llm.py", "line": 42, "pattern": "AzureOpenAI(" }],
  "capabilities_used": ["text_generation"], // NOT capabilities / features
  "usage_context": "chat completion endpoint" // NOT description / purpose
}

{
  "primary_sdk": "openai", // Azure OpenAI apps use the openai SDK; also @azure/openai, azure-ai-inference
  "sdk_version": "1.x",
  "frameworks": [],
  "languages": ["python"],
  "pattern": "direct_sdk", // direct_sdk | framework | rest_api | mixed | unknown
  "gateway_type": null, // llm_router | api_gateway | voice_platform | framework | direct | null
  "capabilities_summary": { // boolean map
    "text_generation": true,
    "streaming": false,
    "function_calling": false,
    "vision": false,
    "embeddings": false,
    "batch_processing": false
  }
}

{
  "workload_id": "wl_3a1f2c", // "wl_" + sha256(model_id + "|" + sdk_method + "|" + structured_flag)[:6]
  "model_id": "gpt-4o", // MUST be one of models[].model_id
  "sdk_method": "openai.chat.completions.create",
  "capability": "text_generation", // see enum below
  "capability_confidence": "high", // high | medium | low
  "structured_output": false,
  "call_sites": [{ "file": "app/llm.py", "line": 42 }] // non-empty, POSIX repo-relative
}

{
  "is_agentic": true,
  "framework": "langgraph", // langgraph|crewai|autogen|openai_agents|strands|custom|none
  "agents": [
    {
      "agent_id": "a1",
      "file": "...",
      "line": 0,
      "model_id": "gpt-4o",
      "tools": [],
      "memory_type": "conversation_buffer",
      "role": "..."
    }
  ],
  "orchestration_pattern": "single", // single|hierarchical|swarm|graph|sequential|unknown
  "agent_count": 1,
  "tool_count": 0,
  "has_human_in_loop": false,
  "has_memory": false,
  "memory_backend": "unknown" // redis|postgres|in_memory|vector_store|unknown
}

Location	gcp	azure
`summary.ai_source` enum	`gemini`	`azure_openai` (gemini dropped)
`metadata.profile_source` enum	`iac_vertex`	`iac_cognitive`
`models[].service` examples	`vertex_ai_*`	`azure_openai`, `cognitive_*`, `azure_ml`
`integration.primary_sdk` example	`google-cloud-aiplatform`	`openai` / `@azure/openai` / `azure-ai-inference`
`infrastructure[].type` examples	`google_vertex_ai_endpoint`	`azurerm_cognitive_account` etc.
`detection_signals[].method`	`live_gcloud`	`live_az`
`current_costs.breakdown[].provider`	`gcp`	`azure`
field-name rule	NOT `gcp_service`	NOT `azure_service` — the field is `service`

Schema Discover AI

Schema — ai-workload-profile.json

Schema Discover AI

Schema — ai-workload-profile.json

Shape

summary.ai_source — the routing key

models[]

integration

infrastructure[]

current_costs

detection_signals[]

workloads[]

agentic_profile

tool_manifest[]

Azure swaps (vs gcp-to-aws’s schema-discover-ai.md)

Validation Checklist

Status — build step 3 (contract)