AI Decision

AI Decision adds a shared Decision API to the Drupal AI module. Ask typed questions about text or structured data and receive answers with probabilities that your application can use for classification, scoring, and workflow decisions.

The API is provider-independent: providers implement a common contract, while site builders and developers control the criteria, thresholds, and actions.

Features

• Yes/no questions: Get the probability that a condition is met, such as whether a support request concerns billing.
• Choice questions: Select from defined options and receive a probability for each option.
• Score questions: Evaluate content against descriptive levels and receive a probability-weighted score.
• Multiple questions per request: Ask related, independent questions about the same input.
• Typed response validation: Reject incomplete or invalid answers before application code uses them.
• Decision guardrails: Apply configured regular-expression, character-length, and moderation checks to Decision requests, with support for custom checks.

Included modules

• AI Decision: The shared operation, typed inputs and outputs,
  validation, and guardrail integration.
• AI Decision Explorer: An optional AI API Explorer integration for experimenting with questions, inspecting probabilities, and generating PHP examples.
• AI Decision Automators: Optional AI Automators rules for populating Boolean, list, integer, decimal, and float fields. Supports single-choice and multi-select lists.

Example uses

• Classify support requests into configured categories.
• Flag content for editorial review.
• Score relevance, urgency, or sentiment against your own criteria.
• Populate structured fields from unstructured content.

Your application determines how answers affect its workflow. Probabilities and confidence measures help define thresholds; they do not guarantee correctness.

Requirements

• Drupal 10.5+ or Drupal 11.2+.
• Drupal AI 1.4.9 or later within the 1.x series, including AI 1.5.
• A configured AI provider implementing the Decision operation to make inference calls. li>

TypeSafe AI Provider implements the Decision API. Other providers can implement the same interfaces and use the shared Explorer and Automators integrations.

The optional Explorer requires AI API Explorer. The optional Automators integration requires AI Automators and its dependencies.

For developers

Use the Drupal AI provider manager to submit a DecisionInput and receive normalized, typed answers. Provider implementations handle their service-specific request and response formats. See the project README for API examples, provider implementation guidance, and supported guardrail behavior.