决策引擎裁决
act_decision_arbitration决策引擎裁决 用户要在多个方案/管线之间做取舍、要量化裁决 裁决结果与理由
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | 候选方案 | |
| criteria | No | 评价维度与权重 |
act_decision_arbitration决策引擎裁决 用户要在多个方案/管线之间做取舍、要量化裁决 裁决结果与理由
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | 候选方案 | |
| criteria | No | 评价维度与权重 |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=false, so the safety profile is covered by structured data. The description adds one genuinely useful behavioural fact — that the tool returns both a decision and its rationale — but says nothing about how weights are applied, what happens when options or criteria are omitted (all parameters are optional), or how ties are resolved.
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?
It is short and front-loaded, but the first fragment merely repeats the tool title, and the remaining clauses are telegraphic fragments joined without structure. Space that could have specified the nested option/criteria shape is instead spent restating the name.
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 two nested, entirely optional parameters, no output schema, and no annotation detail beyond read-only safety, the description should explain the option/criteria object shape and the result format. It mentions only that a decision and rationale come back, leaving an agent unable to construct a valid nested payload from the description alone.
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 applies; '候选方案' and '评价维度与权重' are restated by the description rather than expanded. This matters more than usual here because both parameters are nested (an array of free-form objects and a weights object) with no property definitions, and the description does not supply the expected shape or key names.
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 concrete verb (裁决 / arbitrate) over a concrete resource (多个方案/管线), and adds that the arbitration is quantified against evaluation dimensions. It does not, however, distinguish the tool from closely related siblings such as act_design_decision or study_design_advisor, so an agent cannot tell them apart from the description alone.
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?
It gives an implied trigger condition — 'when the user needs to choose among multiple options/pipelines' and 'needs quantified arbitration' — which is enough to recognise the situation. It names no alternative tool and no exclusions, so the agent gets no routing help when several decision-related siblings are plausible.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.