Penstock

Guide / Every rule

Tool of an AI agent without a description

The check agents/tool-without-description, in the group AI agents.

Advice

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

Idagents/tool-without-description
GroupAI agents
LevelAdvice: it works, and reads or runs better without it

Read more: AI agents of Camunda 8. All rules: Every rule.