用途：本资料是 Glean Agent Toolkit 的工具构建指南，面向需要新增工具集成、用自定义 Glean API 调用扩展工具包，或创建新工具的开发者。
主要能力：工具以 Python 函数加 @tool_spec 装饰器定义。装饰器会从函数签名（经 Pydantic）提取输入 JSON Schema，生成 ToolSpec 数据类，注册到全局 Registry 单例，并附加 .as_openai_tool()、.as_langchain_tool()、.as_crewai_tool()、.as_adk_tool() 等适配方法。可用 typing.Annotated 与 pydantic.Field 添加描述、示例和约束；带默认值的参数在 schema 中为可选，无默认值为必填，GleanContext 参数自动排除。output_model 参数可挂接 Pydantic 模型以生成输出 schema。
实现模式：一是通过 run_tool() 的桩工具模式，把参数映射为 ToolsCallParameter 并调用 Glean tools.run/tools.execute 端点，常用 convert_to_tool_params、run_tool、arun_tool；二是直接 API 调用模式，用于有专用端点的场景，配合 run_with_error_handling、serialize_tool_result。错误处理辅助函数位于 glean.agent_toolkit.tools._common，包括 make_ok、make_error、_classify_error、ToolResult、ErrorType、SuggestedAction。
使用方式：创建工具模块后，在 src/glean/agent_toolkit/tools/init.py 的 _tool_modules 中加入模块名，并添加显式导入与 all 导出；导入时装饰器会自动注册。测试时通过 GleanContext 注入 mock 或 fake 客户端，不使用 unittest.mock.patch。
限制：资料未提供安装命令、版本要求、收费或平台支持信息；具体 API 行为与可用端点需以实际环境为准。