Make it possible to override tool descriptions for a specific agent
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #3544182. -->
Reported by: [marcus_johansson](https://www.drupal.org/user/385947)
Related to !179
>>>
<p>--- AI TRACKER METADATA ---<br>
<strong>Update Summary: </strong>This will increase the accuracy of the AI Agent picking the right tool and passing it the right information. Needed for XB agents showcase.<br>
<strong>Check-in Date: </strong>MM/DD/YYYY (US format) [When we should see progress/get an update]<br>
<strong>Due Date:</strong> MM/DD/YYYY (US format) [When the issue should be fully completed]<br>
<strong>Blocked by:</strong> [#XXXXXX] (New issues on new lines)<br>
<strong>Additional Collaborators:</strong> @username1, @username2<br>
AI Tracker found here: <a href="https://www.drupalstarforge.ai/" title="AI Tracker">https://www.drupalstarforge.ai/</a><br>
--- END METADATA ---</p>
<h3 id="summary-problem-motivation">Problem/Motivation</h3>
<p>One thing we noticed with <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/ai_agents/issues/3528726" title="Status: Closed (fixed)">#3528726: Add artifacts to agents</a></span> is that it works a lot better with the description that the prompt input should take the artifact id.</p>
<p>Sometimes the general description on how to use a tool is not enough for the agent, so we need a way to override this.</p>
<p>Also tool descriptions have thought of as having higher success rate then the system prompts, see:<br>
<a href="https://arxiv.org/abs/2505.18135">https://arxiv.org/abs/2505.18135</a><br>
<a href="https://arxiv.org/abs/2308.00675">https://arxiv.org/abs/2308.00675</a></p>
<h3 id="summary-proposed-resolution">Proposed resolution</h3>
<p>Add a field under the tool settings where you can add a tool description.<br>
Add a field under the tool settings where you can override any input description.<br>
Use these descriptions if they are not empty.</p>
issue