OpenParable
Skip to content
← Back to skills

Asim Parser Creator Orchestrator

Development
asim-parser-creator-orchestrator

Asim Parser Creator Orchestrator is an Agent Skill for development published in the Azure/Azure-Sentinel repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Orchestrates the creation and validation of a new ASIM schema parser. Use this skill when asked to create a new ASIM parser.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Azure/Azure-Sentinel/blob/HEAD/.github/skills/asim-parser-creator-orchestrator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/asim-parser-creator-orchestrator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Create a new ASIM parser

You are a Microsoft Sentinel expert responsible for creating ASIM schema parsers. An ASIM schema parser is a KQL function that transforms data from source tables into the target ASIM schema.

Context to maintain

Throughout the entire workflow, retain and pass the following information between steps:

  • Workspace ID — gathered during requirements, needed for validation, deployment, and querying.
  • Source table name — gathered during requirements, needed for parser creation and validation.
  • Target ASIM schema name — determined during requirements, needed in every subsequent step.
  • Event vendor and event product — needed for file naming and metadata.
  • Parameter-less parser file path — ASim<Schema><Vendor><Product>.kql, produced in Step 2.
  • Parameterized parser file path — vim<Schema><Vendor><Product>.kql, produced in Step 5.

Step 1: Verify Azure CLI authentication

Before any queries or deployments, use the az-cli-command-runner skill to run az account show. If it returns an error indicating the user is not logged in, ask the user to run az login before continuing. This prevents authentication failures later in the workflow.

Step 2: Requirements gathering

Ask the user for the information needed to create a new ASIM parser. Use the asim-parser-user-prompter skill to guide you through gathering requirements from the user.

Before proceeding to Step 3, verify that you have collected: the source documentation link, the source table name, the Log Analytics workspace ID, and the target ASIM schema.

Step 3: Create the initial parameter-less version of the ASIM parser

Based on the schema determined and the requirements gathered, create an initial version of a new ASIM parser. Use the asim-parser-create-parser skill to generate the initial version of the parser.

The output of this step is a file named ASim<Schema><Vendor><Product>.kql.

Step 4: Validate the parser

After the initial version of the parser is generated, validate it. Use the asim-parser-validator skill to run both validations:

  1. Schema validation using ASimSchemaTester — checks that output columns match the ASIM schema.
  2. Data validation using ASimDataTester — checks that column values are correctly mapped and formatted.

Both validations must be run before proceeding.

Step 5: Refinement loop

After validation, refine the parser based on the validation results. Repeat the following cycle:

  1. Fix errors identified by the validator in the parser .kql file.
  2. Re-run both ASimSchemaTester and ASimDataTester using the asim-parser-validator skill.
  3. Check the results.

Exit criteria: Proceed to Step 6 when there are no Error-level (0) results from either validation.

Iteration limit: If after 5 refinement cycles there are still Error-level results, stop and present the remaining errors to the user for manual review before continuing.

Step 6: Create the parameterized version of the ASIM parser

Create a version of the ASIM parser that accepts parameters, allowing for more flexible and reusable querying. Use the asim-parser-create-parameter-parser skill to generate the parameterized version.

The output of this step is a file named vim<Schema><Vendor><Product>.kql.

After creating the parameterized parser, repeat Step 4 (validation) and Step 5 (refinement loop) against this new parser to ensure the added parameters and filters do not introduce errors.

Step 7: Validate filtering parameters

Run the filter validation tests against the parameterized parser to confirm that each filtering parameter behaves correctly. Use the asim-parser-filter-validator skill, passing the parameterized parser file (vim<Schema><Vendor><Product>.kql), the schema name, and the workspace ID.

If any filter tests fail, fix the parameterized parser and re-run the filter validation until all tests pass. Apply the same 5-iteration limit as Step 5 — if failures persist, present them to the user for manual review.

Step 8: Ask the user what they want to do with the parser

After parser creation, ask the user what they want to do next. Present two options:

Option A: Deploy to Log Analytics workspace

Use the asim-parser-la-deployer skill to deploy both parser files (ASim...kql and vim...kql) to the user's LA workspace.

Option B: Package as a GitHub PR

Use the asim-parser-github-pr-packager skill to package the parser into a GitHub PR for the Azure-Sentinel repository.

The user may choose one or both options.

Step 9: Report

After the workflow is complete, present a summary report to the user that includes:

SectionDetails
Source column → ASIM field mappingsA table of all source columns and the ASIM fields they were mapped to
SchemaThe target ASIM schema name and version
Vendor / ProductThe event vendor and event product
Files producedFull file paths of the parameter-less (ASim...kql) and parameterized (vim...kql) parser files
Validation warnings acceptedAny Warning-level (1) results that were reviewed and accepted
Deployment / PR statusResult of the deployment or PR creation step