Skip to content

Documentation Gaps

When to Use

Use this guide when the official documentation doesn't match actual behavior. These gaps were identified by comparing official docs to source code in AI 1.3.0-rc2.

Core Module

Gap Covered In
ProviderProxy wrapping pattern Core Architecture
Guardrails system developer guide Guardrails System
Short-term memory plugin system Short-Term Memory
Prompt config entity system (ai.ai_prompt) Prompt System

ai_assistant_api

Gap Covered In
use_function_calling mode (tool calls vs JSON-in-prompt) AI Assistant API
AgentRunner path (assistant delegates to ai_agents) AI Agents
setVerboseMode(), setThrowException() AI Assistant API
AiAssistantPassContextToAgentEvent AI Assistant API

ai_chatbot

Gap Covered In
Full POST payload schema for /api/deepchat AI Chatbot
should_continue protocol for tool-call round-trips AI Chatbot
verbose_mode, show_copy_icon, show_structured_results block settings AI Chatbot
hook_deepchat_prepend_message AI Chatbot

ai_automators

Gap Covered In
AutomatorsTool entity and function-calling integration AI Automators
All 4 events (AutomatorConfigEvent, etc.) AI Automators
Full 52-plugin inventory AI Automators

ai_ckeditor

Gap Covered In
module_dependencies silencing mechanism AI CKEditor
AiAutomatorsCKEditor cross-module plugin AI CKEditor
Global ai_ckeditor.settings prompts config AI CKEditor
Gap Covered In
include_raw_embedding_vector feature AI Search
search_api_ai_get_chunks_result query option AI Search
AiVdbProviderSearchApiInterface requirements AI Search

ai_translate

Gap Covered In
Drush commands (ai:translate-entity, ai:translate-text) AI Translate
hook_ai_translate_translation_alter AI Translate
Layout Builder translation integration AI Translate

ai_observability

Gap Covered In
All config settings AI Observability
AiObservabilityUtils AI Observability

ai_validations

Gap Covered In
XTRUE/XFALSE protocol (critical) AI Validations
Image classification is deny-list (not allow-list) AI Validations

field_widget_actions

Gap Covered In
FieldWidgetFormActionBase modal pattern Field Widget Actions
FillEditorCommand/FillSimpleFieldCommand Field Widget Actions
Config Action for Recipes pattern Field Widget Actions

See Also

  • Reference: https://project.pages.drupalcode.org/ai/
  • Reference: https://git.drupalcode.org/project/ai