act_pkpd_simulate
【PK/PD 模拟】 用户要模拟给药方案的浓度-效应过程 返回:模拟曲线与参数 (真实算法引擎执行,非大模型生成)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| drug_name | Yes | 药物名 | |
| pd_params | No | 药效参数 | |
| pk_params | No | 药代参数 |
【PK/PD 模拟】 用户要模拟给药方案的浓度-效应过程 返回:模拟曲线与参数 (真实算法引擎执行,非大模型生成)
| Name | Required | Description | Default |
|---|---|---|---|
| drug_name | Yes | 药物名 | |
| pd_params | No | 药效参数 | |
| pk_params | No | 药代参数 |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The annotations already state readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered and the bar is lower. The description does add real context with '真实算法引擎执行,非大模型生成' (deterministic engine, not LLM-generated) and a brief statement of what is returned. It is silent, however, on behavior when pk_params or pd_params are omitted, on units/conventions, and on validation failures.
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 short sentences plus a return note; the purpose is front-loaded in the bracketed label and nothing is redundant. The cost is that its brevity leaves real omissions rather than verbosity, which is a completeness problem rather than a structure one.
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 does mention returns (模拟曲线与参数), which helps. But for a tool with two opaque nested-object parameters and a near-identical sibling (act_pkpd_eval), the definition leaves the agent without disambiguation or parameter shape, so it is only minimally sufficient.
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 description coverage is reported at 100%, which sets the baseline at 3, and the description adds nothing about drug_name, pk_params, or pd_params. The gap is that both *_params are free-form nested objects with no defined sub-properties, so an agent gets no guidance on which keys inside them are expected.
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 names a specific verb and resource: simulating the concentration-effect process of a dosing regimen (模拟给药方案的浓度-效应过程). That is concrete and actionable. It does not, however, separate this tool from the very similar sibling act_pkpd_eval, so an agent must guess which of the two does simulation versus evaluation.
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 phrase '用户要模拟给药方案...' implies the usage context, so the when-to-use condition is indirectly clear. But there are no explicit exclusions, no mention of when to prefer act_pkpd_eval, and no preconditions such as whether PK/PD parameters must be supplied or can be looked up from the drug name alone.
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.