Guide / Every rule
Tool of an AI agent without a description
The check agents/tool-without-description, in the group AI agents.
Why it matters
The model chooses a tool from its name and its description, and the description is the documentation of the element. A tool with none is guessed at or never used.
How to fix it
Write what the tool does and when to use it in the documentation of the element.
Where you see it
The Problems tab of the BPMN editor lists it, the Agents tab shows it on the agent it belongs to, and penstock check reports it as agents/tool-without-description. It runs on .bpmn files and is free.
Rule details
| Id | agents/tool-without-description |
| Group | AI agents |
| Level | Advice: it works, and reads or runs better without it |
Read more: AI agents of Camunda 8. All rules: Every rule.