Installation/configuration resilience (ai_translate) (#3498757) · Issues · project / ai

Installation/configuration resilience (ai_translate)

>>> [!note] Migrated issue   Reported by: [dunx](https://www.drupal.org/user/445642) Related to !406 >>> I experienced this error when re-testing an ai_translate issue, so this is a new issue raised from that testing covered under <a href="https://www.drupal.org/project/ai/issues/3494285#comment-15930348">https://www.drupal.org/project/ai/issues/3494285#comment-15930348</a> The issues may be related to ai_translate specifically, or they may be a symptom of wider issues with AI Core. <h3 id="summary-problem-motivation">Problem/Motivation</h3> When installing and configuring AI Translate, you can encounter a number of unhelpful errors and messages if you do not undertake that correctly. <h4 id="summary-steps-reproduce">Steps to reproduce</h4> Using D11 Umami with just the following core and modules enabled: <ul> <li>Drupal Core 11.1.1 - long list</li> <li>Admin Toolbar 3.5.1 - toolbar and extras</li> <li>AI (Artificial Intelligence) 1.0.0-beta7 - AI Core and AI Translate</li> <li>Key 8.x-1.19</li> </ul> I'm logged in as the admin account. I haven't configured anything yet, which is the cause of my woes. I created an article and then clicked on the Translate tab. I see the following errors: <ul> <li>Error message - Please set a default chat provider & model in the AI module settings.</li> <li>Error message - Warning: Undefined array key 1 in Drupal\ai_translate\Form\AiTranslateForm->buildForm() (line 116 of modules/contrib/ai/modules/ai_translate/src/Form/AiTranslateForm.php).</li> </ul> The first error is useful. I should not get the second error. The stack trace is: <pre>TypeError: Drupal\Component\Utility\Html::escape(): Argument #1 ($text) must be of type string, null given, called in /var/www/html/web/core/lib/Drupal/Component/Render/FormattableMarkup.php on line 238 in Drupal\Component\Utility\Html::escape() (line 431 of core/lib/Drupal/Component/Utility/Html.php). Drupal\Component\Render\FormattableMarkup::placeholderEscape() (Line: 187) Drupal\Component\Render\FormattableMarkup::placeholderFormat() (Line: 195) Drupal\Core\StringTranslation\TranslatableMarkup->render() (Line: 15) Drupal\Core\StringTranslation\TranslatableMarkup->__toString() (Line: 203) Drupal\Core\Utility\LinkGenerator->doGenerate() (Line: 180) Drupal\Core\Utility\LinkGenerator->generate() (Line: 164) Drupal\Core\Link->toString() (Line: 128) Drupal\ai_translate\Form\AiTranslateForm->buildForm() call_user_func_array() (Line: 528) Drupal\Core\Form\FormBuilder->retrieveForm() (Line: 279) Drupal\Core\Form\FormBuilder->buildForm() (Line: 219) Drupal\Core\Form\FormBuilder->getForm() (Line: 19) Drupal\ai_translate\Controller\ContentTranslationControllerOverride->overview() call_user_func_array() (Line: 123) Drupal\Core\EventSubscriber\EarlyRenderingControllerWrapperSubscriber->Drupal\Core\EventSubscriber\{closure}() (Line: 593) Drupal\Core\Render\Renderer->executeInRenderContext() (Line: 121) Drupal\Core\EventSubscriber\EarlyRenderingControllerWrapperSubscriber->wrapControllerExecutionInRenderContext() (Line: 97) Drupal\Core\EventSubscriber\EarlyRenderingControllerWrapperSubscriber->Drupal\Core\EventSubscriber\{closure}() (Line: 183) Symfony\Component\HttpKernel\HttpKernel->handleRaw() (Line: 76) Symfony\Component\HttpKernel\HttpKernel->handle() (Line: 53) Drupal\Core\StackMiddleware\Session->handle() (Line: 48) Drupal\Core\StackMiddleware\KernelPreHandle->handle() (Line: 28) Drupal\Core\StackMiddleware\ContentLength->handle() (Line: 32) Drupal\big_pipe\StackMiddleware\ContentLength->handle() (Line: 116) Drupal\page_cache\StackMiddleware\PageCache->pass() (Line: 90) Drupal\page_cache\StackMiddleware\PageCache->handle() (Line: 48) Drupal\Core\StackMiddleware\ReverseProxyMiddleware->handle() (Line: 51) Drupal\Core\StackMiddleware\NegotiationMiddleware->handle() (Line: 36) Drupal\Core\StackMiddleware\AjaxPageState->handle() (Line: 51) Drupal\Core\StackMiddleware\StackedHttpKernel->handle() (Line: 709) Drupal\Core\DrupalKernel->handle() (Line: 19)</pre>I want to use Open AI, but visiting the link displayed by the module under "Default providers" at /en/admin/config/ai/settings to /en/admin/config/ai/providers gives me an access denied error. I am admin and shouldn't see an access denied error and the cause of the issue is not clear to me. Ooops... so I'd missed the ai_provider_openai module. I installed and enabled that module. I added my Open AI key via /en/admin/config/system/keys and configured ai_provider_openai to use that key at /en/admin/config/ai/providers/openai That access denied error has gone away :) I click on the Translate tab again. Same two errors :( Ooops... I haven't configured AI Translate to use Open AI yet. Dropdown at /en/admin/config/ai/ai-translate says to use the "Default from AI Module (chat)", which is just as well as there's no AI option under "Translate Text" at AI settings (/en/admin/config/ai/settings) which is what I was expecting to have to configure. So I configure the Chat at that same URL to use Open AI and gpt-3.5-turbo. I click the Translate tab again. Hoorah, no errors. I click on "Translate using gpt-3.5-turbo" to create a Spanish translation. That works. <h3 id="summary-proposed-resolution">Proposed resolution</h3> Make the module more resilient to misconfiguration, perhaps providing more helpful messages to guide users to a successful installation. --UPDATE-- Ticket scope reduced to deal with the PHP error, not the Access Denied error that occurs afterwards, which I will raise as a separate issue.

issue