Create a Principled BSDF material with adjustable color, roughness, metallic, alpha, and emission, then assign it to an object directly.
新建 Principled BSDF 材质；alpha<1 自动切 BLENDED；assign_to 直接赋给对象。
| Name | Required | Description | Default |
|---|---|---|---|
| ior | No | ||
| name | Yes | ||
| alpha | No | ||
| metallic | No | ||
| assign_to | No | ||
| roughness | No | ||
| base_color | No | ||
| emission_color | No | ||
| emission_strength | No |
Changes observed during successful MCP inspections.
v0.1.0Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
没有注释，描述承担了行为披露的全部责任。它揭示了alpha<1时自动切换为BLENDED的关键行为，但未提及权限要求、是否破坏性、返回值或其他副作用。对于创建材质这类非破坏性操作，缺失的信息不多，但描述仍不够全面。
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?
描述仅有三句话，用分号分隔，简洁且重点突出。信息密度高，没有冗余，但可能因过于精简而遗漏了其他参数信息。结构合理，关键行为放在前面。
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?
工具涉及9个参数，但描述仅覆盖其中两个，也没有说明输出或返回值。尽管输出schema缺失，但考虑到参数众多，描述应提供更多参数用途和可能的行为说明。当前信息不足以让代理准确调用所有参数。
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?
描述仅说明了alpha和assign_to两个参数的行为，其余参数如ior、metallic、roughness、base_color等均未提及。参数schema描述覆盖率为0%，描述未能补偿，用户只能靠参数名猜测含义，缺乏必要的语义解释。
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?
描述明确了“新建 Principled BSDF 材质”，动词+资源具体，且通过alpha和assign_to的行为进一步区分了与其他材质创建工具的差异。与兄弟工具如create_pbr_material相比，它明确指出了BSDF类型，目的清晰。
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?
描述没有明确说明何时使用此工具而非其他材质创建工具，也没有提及替代方案或排除条件。alpha和assign_to的行为隐含了使用场景，但缺少明确的“当需要…时使用”或“当…时不用”的指导。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.