Tool variations

Endpoints listed in an OpenAPI document may lack clear summaries and descriptions that convey their intent and use. When a tool definition inherits an incomplete or vague description, LLMs may struggle to understand when to invoke the tool, how to use it properly, or how to interpret its output.

Improving tool descriptions is a form of prompt engineering, and it’s a critical step in building reliable, effective agents.

Gram provides two ways to improve a tool’s description:

• Editing the OpenAPI document and adding the x-gram extension to the endpoint to override or enrich the tool’s metadata.
• Using the Gram Playground to directly edit a tool’s name and description. This feature is called Tool variations.

In the Gram Playground, hover over a tool’s name and click Edit to modify it.

Update the tool name in the modal that opens:

Similarly, hover over the tool description and click Edit to update it:

Use the dedicated modal to validate and save your updated description: