(Discuss) Improve the add/edit Agent UI to make it less overwhelming
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #3552140. -->
Reported by: [michaellander](https://www.drupal.org/user/636494)
>>>
<h3 id="summary-problem-motivation">Problem/Motivation</h3>
<p>The existing agent UI is pretty overwhelming(<a href="https://www.drupal.org/files/issues/2025-10-14/agent_form_before.png" title="Add/edit agent form before screenshot">see attached before image</a>) once you get into adding many tools and the tool input refinement forms that are appended down below. One step toward improving this would be to move the per-tool settings and the 'Add tool' behavior into a modal/tray/etc. </p>
<p>Some of the improvement for finding tools to add has been done in <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/ai/issues/3519692" title="Status: Closed (fixed)">#3519692: Create tools (function calls) plugin finder/browser</a></span>, though the changes to the main agent form might mean we need to add additional steps to configure the tool you are adding before going back to the agent form.</p>
<p>Additional conversation around how the tool configuration form should work is happening in <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/ai_agents/-/work_items/3552047" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/ai_agents/-/work_items/3552047</a></span>.</p>
<p>This issue will focus on the display of the agent form itself, with those issues supporting the per-tool add/edit experience.</p>
<h3 id="summary-proposed-resolution">Proposed resolution</h3>
<p>See attached screenshot for initial POC.<br>
<img src="https://www.drupal.org/files/issues/2025-10-14/agent_poc_1_after.png" alt="Add/edit Agent form UI POC 1"></p>
<p>We are still discussing steps to find the right language and level of detail and to make this user friendly for more user expertise levels.</p>
<h3 id="summary-remaining-tasks">Remaining tasks</h3>
<p>TBD</p>
<h3 id="summary-ui-changes">User interface changes</h3>
<p>Yes</p>
<h3 id="summary-api-changes">API changes</h3>
<p>TBD</p>
<h3 id="summary-data-model-changes">Data model changes</h3>
<p>TBD</p>
> Related issue: [Issue #3552047](https://www.drupal.org/node/3552047)
> Related issue: [Issue #3519692](https://www.drupal.org/node/3519692)
issue