### **Environment** | **Item** | **Value** | |----------|-----------| | Drupal | 11.4.6 | | PHP | 8.4 | | `drupal/ai` | 1.4.8 | | `drupal/ai_agents` | 1.3.5 (the same `execute()` is present on the `1.4.x` branch / `1.4.0-beta1`) | | Provider / model | OpenAI `gpt-5.4` (via `ai_provider_openai` 1.2.5) | | Tool | `ai_agent:content_entity_seeder` → `Drupal\ai_agents\Plugin\AiFunctionCall\ContentEntitySeeder` | --- ### **Description** `ContextDefinitionNormalizer` wraps the `ContentEntitySeeder`'s `entity_array` parameter in one extra array level (`multiple` + `ComplexToolItems` applied together). The JSON Schema advertised to the LLM becomes `array<array<object>>`, but `ContentEntitySeeder::execute()` reads `array<object>`. Every tool call that is well-formed according to the schema results in `Warning: Undefined array key "field_name"` and then `InvalidArgumentException: Field is unknown.` The `ContentEntitySeeder` plugin declares the `entity_array` context with **two** markers at the same time: ``` // web/modules/contrib/ai_agents/src/Plugin/AiFunctionCall/ContentEntitySeeder.php 'entity_array' => new ContextDefinition( data_type: 'map', label: new TranslatableMarkup("Entity Array"), description: new TranslatableMarkup("The entity array to seed the entity with."), required: TRUE, multiple: TRUE, // (1) constraints: [ 'ComplexToolItems' => ContentEntityFieldValuesList::class, // (2) ], ), ``` In `Drupal\ai\Utility\ContextDefinitionNormalizer::normalize()` these two paths are independent and **both** are applied: ``` // Complex lists. if (isset($constraints['ComplexToolItems'])) { $property->setType('array'); // (2) already becomes an array of objects $sub_item = $this->getFunctionCallPluginManager()->getFunctionCallFromClass($constraints['ComplexToolItems']); $normalized = $sub_item->normalize()->renderFunctionArray(); $property->setItems($normalized['parameters'] ?? []); } // ... // If multiple, wrap in array. if ($definition->isMultiple()) { $array_property = new ToolsPropertyInput($key); $array_property->setType('array'); // (1) wraps it AGAIN $array_property->setItems($property->renderPropertyArray()); $properties[] = $array_property; } ``` Result: `entity_array` is advertised as an **array of array of object**. The same double wrap recurses one level down into `field_values` (which is also `map` + `multiple` + `ComplexToolItems`) and into `values` (`list` + `multiple`). The plugin's own `execute()`, however, iterates `entity_array` as a **flat** list of field objects: ``` // ContentEntitySeeder::execute() — lines ~156-164 foreach ($entity_array as $lists) { $field_name = $lists['field_name']; // line 158 $values = []; foreach ($lists['field_values'] as $field_value) { // line 160 $values[$field_value['value_name']] = $field_value['values'][0]; } $data[$field_name][] = $values; } // ... foreach ($data as $field_name => $value) { // ... $entity->set($field_name, $value); // $entity->set('', ...) } ``` When the model follows the advertised (over-nested) schema, each `$lists` is the spurious inner array, so `$lists['field_name']` and `$lists['field_values']` are undefined → `$field_name = NULL`, `foreach` over `NULL`. `$data` ends up with the empty key `''`, and `$entity->set('', ...)` throws `InvalidArgumentException: Field is unknown.` (caught in `ai_chatbot/src/Form/ChatForm.php::submitForm()` by `catch (\Exception)`), so the chatbot returns no usable answer and no content is created. #### **JSON Schema actually generated for the tool (abridged)** ``` entity_array : array items : array ◄── extra level items : object field_name : string field_values : array items : array ◄── extra level items : object value_name : string values : array items : array ◄── extra level items : string ``` `execute()` actually expects: ``` entity_array : array items : object { field_name:string, field_values: array< object{ value_name:string, values: array<string> } > } ``` --- ### **Steps to reproduce** #### **A. Deterministic, no LLM (proof of the schema × execute mismatch)** `ddev drush php:script <file>` with: ``` <?php $switcher = \Drupal::service('account_switcher'); $switcher->switchTo(\Drupal::entityTypeManager()->getStorage('user')->load(1)); $m = \Drupal::service('plugin.manager.ai.function_calls'); function run($label, array $entity_array) { $tool = \Drupal::service('plugin.manager.ai.function_calls') ->createInstance('ai_agent:content_entity_seeder'); $tool->setContextValue('entity_type', 'node'); $tool->setContextValue('bundle', 'article'); $tool->setContextValue('label', "Seeder shape test $label"); $tool->setContextValue('entity_array', $entity_array); try { $tool->execute(); print "[$label] OK -> " . $tool->getReadableOutput() . "\n"; } catch (\Throwable $e) { print "[$label] " . get_class($e) . ': ' . $e->getMessage() . "\n"; } } // (1) the shape execute() consumes: run('FLAT', [ ['field_name' => 'field_body', 'field_values' => [ ['value_name' => 'value', 'values' => ['<p>Flat.</p>']], ['value_name' => 'format', 'values' => ['basic_html']], ]], ]); // (2) the shape the JSON Schema advertises (one extra array at every level): run('SCHEMA-SHAPED', [ [ ['field_name' => 'field_body', 'field_values' => [ [ ['value_name' => 'value', 'values' => [['<p>Nested.</p>']]], ['value_name' => 'format', 'values' => [['basic_html']]], ], ]], ], ]); $switcher->switchBack(); ``` Output obtained: ``` [FLAT] OK -> Entity of type node created with id: 14 View link: /node/14 Edit link: /node/14/edit [warning] Undefined array key "field_name" ContentEntitySeeder.php:158 [warning] Undefined array key "field_values" ContentEntitySeeder.php:160 [warning] foreach() argument must be of type array|object, null given ContentEntitySeeder.php:160 [SCHEMA-SHAPED] InvalidArgumentException: Field is unknown. ``` #### **B. Through the chatbot UI (real user flow)** 1. Have an orchestration `ai_agent` with the `ai_agent:content_entity_seeder` tool enabled, wired to an `ai_assistant` + chatbot block (here: assistant `content_manager`, block `olivero_aichatbot_manager`). 2. Log in as a user who can run the assistant **and** has `create article content` (here: user `chatbot_tester`, role `content_editor`). 3. Open a page carrying the chatbot (e.g. `/node/5`) and send: _"Create a new unpublished article titled "Bug repro article" with body "\<p\>Reproducing the seeder bug.\</p\>". Do it now."_ 4. Reply **confirm** when the assistant asks for confirmation. Result: no node is created; three PHP `Warning`s are written to _Reports → Recent log messages_, all pointing at `ContentEntitySeeder.php` lines 158/160; the assistant's reply bubble **spins forever** (the streamed response is interrupted by the exception) or comes back empty. --- ### **Expected behavior** * The JSON Schema advertised for the `entity_array` parameter (and for `field_values` / `values`) must match what `ContentEntitySeeder::execute()` consumes: a **flat** list of objects `{ field_name, field_values:[ { value_name, values:[…] } ] }`. * A tool call that is well-formed per the schema creates/edits the entity and the assistant replies with the `/node/<id>` link. ### **Actual behavior** * The schema has one extra array level at every point that combines `multiple: TRUE` with `SimpleToolItems` / `ComplexToolItems`. * A call that follows the schema → `Warning: Undefined array key "field_name"` + `Warning: Undefined array key "field_values"` + `Warning: foreach() argument must be of type array|object, null given` (`ContentEntitySeeder.php:158` and `:160`) → `$entity->set('', …)` → `InvalidArgumentException: Field is unknown.` * The exception is caught in `ChatForm::submitForm()`; for the end user the chatbot **does not create the content and gives no usable answer**. Search and publish/unpublish through the same assistant keep working. ### **Backtrace (from the Drupal log)** ``` Warning: Undefined array key "field_name" in Drupal\ai_agents\Plugin\AiFunctionCall\ContentEntitySeeder->execute() (line 158 of .../ai_agents/src/Plugin/AiFunctionCall/ContentEntitySeeder.php) #2 ContentEntitySeeder->execute() #3 Drupal\ai_agents\PluginBase\AiAgentEntityWrapper->executeTool() (line 1606) #4 Drupal\ai_agents\PluginBase\AiAgentEntityWrapper->determineSolvability() (line 556) #5 Drupal\ai_assistant_api\Service\AgentRunner->runAsAgent() (line 124) #6 Drupal\ai_assistant_api\AiAssistantApiRunner->process() (line 329) #7 Drupal\ai_chatbot\Form\ChatForm->submitForm() (line 171) ``` --- ### **Evidence (screenshots)** | **File** | **What it shows** | |----------|-------------------| | {width="225" height="600"} | "Content Manager" chatbot: create request → asks for confirmation → after `confirm` the reply stays stuck loading. No node created. | | {width="822" height="600"} | _Reports → Recent log messages_: three PHP `Warning`s (`foreach()…null`, `Undefined array key "field_values"`, `Undefined array key "field_name"`) logged by user `chatbot_tester` in the same minute as the conversation. | | {width="365" height="600"} | Log event detail: `Undefined array key "field_name"` in `ContentEntitySeeder->execute()` line 158, `Location: /node/5`, with the full backtrace up to `ChatForm->submitForm()`. |