site

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It explains that the tool describes the enquiry flow, that no purchase/payment/guarantee is involved, that the service is free, and that it returns 'who receives the details, the consent wording, and how the person confirms.' This is rich, honest behavioral context for a description tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences, front-loaded with the 'Read first' directive and the core purpose. The description efficiently covers what the tool does, what it does not do, and what it returns, with no filler or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameterless tool with no output schema, the description provides everything needed: the workflow position ('Read first'), the behavioral boundaries (free, no purchase, no guaranteed quote), and the return contents (recipient details, consent wording, confirmation method). An agent can confidently decide to invoke this tool and know what to expect.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and an empty schema, so schema description coverage is 100% and there is nothing to document. The baseline for 0 parameters is 4; the description appropriately focuses on return content rather than nonexistent parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it 'States plainly what submit_enquiry does' on Industrial Fridge Service. The title reinforces this by clarifying the user gets 'an ENQUIRY with a human' and explicitly ruling out 'a purchase, not a guaranteed quote.' This clearly differentiates it from the sibling tools submit_enquiry and enquiry_fields, which are the action and fields counterparts.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description opens with the directive 'Read first,' which explicitly tells the agent when to use this tool: before interacting with the enquiry process. It also contrasts the tool's subject with what it is not ('Nothing is bought, ordered or paid; no quote is guaranteed'), giving clear usage framing. Though it does not name sibling tools, the 'Read first' instruction and the naming of submit_enquiry make the intended sequencing unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It describes the content returned (field metadata) and implies a read-only lookup, but it does not explicitly state whether the operation is read-only, whether it makes any external calls, or what the exact response structure is. The description is informative but stops short of being fully transparent about the behavior beyond the data shape.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, tightly packed with essential information. The first sentence lists the data attributes, and the second explains the integration with submit_enquiry. No filler or repetition; everything earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description must convey what the tool returns, and it does: key, label, type, required, help text, and allowed options. It also explains the connection to submit_enquiry. However, it doesn't specify the exact format (e.g., array of objects, object keyed by field key) or mention how enquiry_describe relates, which leaves a small gap for an agent deciding between the sibling tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so the baseline is 4. The description adds contextual meaning by explaining that the field keys are meant to be used as keys when passing answers to submit_enquiry, which helps the agent understand the purpose of the returned keys even though there are no input parameters to document.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the resource ('every field of the Industrial Fridge Service enquiry') and enumerates exactly what is included (key, label, type, required, help text, allowed options). It also distinguishes itself from submit_enquiry by explaining how the output relates to that tool, though it doesn't explicitly mention enquiry_describe or use an action verb like 'returns'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The second sentence gives direct usage guidance: 'Pass answers to submit_enquiry keyed by field key.' This tells the agent when to use this tool (before submitting) and how the output should be consumed. It doesn't explicitly contrast with enquiry_describe, but it provides clear context for the primary intended workflow.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does so: it discloses that step 1 only validates and returns a summary/consent line/token, that nothing reaches providers until the person clicks an emailed link, that up to three engineers will receive the details, and the exact consent semantics. This is exactly the behavioral context an agent needs before mutating state.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The two-step flow is front-loaded and every clause is functional, but the consent wording is quoted verbatim in the description despite already appearing twice in the schema, which is mild redundancy. Otherwise it is dense and well-ordered rather than padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, and the description compensates by describing what each call returns (validated summary, consent line, confirmation token) and what the end user receives (an email with a click-through link). Nothing needed to invoke this tool correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds value the schema cannot: it maps parameters to steps (answers + consent in step 1, the same plus confirmation in step 2) and clarifies that confirmation is a token returned by the earlier call. It does not document value formats inside the nested answers object, which the schema also leaves open.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Submits an enquiry to Industrial Fridge Service') and immediately delimits what it is not ('NOT a purchase, NOT a guaranteed quote'). Combined with the sibling names enquiry_describe and enquiry_fields, an agent can identify this as the submission step without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit two-step protocol: step 1 with answers + consent to validate, step 2 only after the person approves the summary, adding the confirmation token. It also flags where the field keys come from (enquiry_fields), so when-to-use and sequencing are unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.