为Agent定义经过校验的函数工具

目标

为Agent提供一个输入受限、可预测的工具。

步骤

1. 先写清工具要完成的单一任务，以及绝不允许的副作用。 [openai-tools]
2. 用 @function_tool 或 @tool 暴露窄范围函数；以Python类型提示/Pydantic BaseModel生成并校验参数schema。 [openai-tools]
3. 对数值使用 Field(ge=..., le=...)、对选项使用 Literal[...]；在handler入口再次执行业务边界校验。 [openai-tools]
4. 仅将该函数注册到需要它的Agent，并记录可见的工具描述。 [openai-tools]
5. 用合法、缺字段、越界三组输入验证schema及拒绝行为。 [openai-tools]

验证方式

确认生成的工具schema包含预期字段，非法输入不会触发函数副作用。

故障处理

若schema过宽，将工具拆成更窄的输入契约，并在函数入口再次校验。