ai-integration

此技能为将 Anthropic 的 Claude API 集成到现代软件应用程序中提供了稳健的架构模式。它专为在 TypeScript 生态系统中构建 AI 功能的开发人员而设计，提供了标准化方法来处理请求生命周期管理、响应流式传输及复杂的函数调用。通过利用此技能，工程师可以快速构建对话界面、自动内容生成引擎以及需要确定性结构化输出的自适应工作流程。该模块通过提供 API 客户端初始化、消息处理以及集成 Zod schema 以确保从 AI 响应中解析出类型安全数据的清晰示例，强调了可维护性。

• 标准化的 Anthropic SDK 客户端设置，包含环境变量配置以确保 API 访问安全性。

• 灵活的聊天完成模式，支持基本的请求-响应循环以及通过 ReadableStream 进行的高效服务端事件流式传输。

• 先进的结构化输出生成，使用 Zod schema 进行验证，非常适合生成符合 JSON 标准的领域对象，例如健身计划或数据报告。

• 完整的工具调用 (Function Calling) 架构，允许 Claude 执行定义的动作（如日历更新或强度调整），并具备清晰的输入 schema 验证。

• 预定义的模型选择策略，将任务需求（快速、平衡或强大）映射到特定的 Claude 模型版本（例如 Haiku 或 Sonnet）。

• 最佳实践：务必包含系统提示词 (System Prompt) 以定义 AI 的角色、操作限制及预期的输出格式，以减少幻觉产生。

• 实用建议：使用工具调用时，为属性和需求提供详细的 schema 说明，以确保模型能可靠地预测正确的参数值。

• 限制：确保 ANTHROPIC_API_KEY 环境变量已正确注入执行环境，以避免客户端初始化错误。

• 用途：适用于需要高保真交互的应用程序，例如 AI 教练、个人助理或自动化文档处理流水线。

• 数据完整性：务必将生成方法的输出包装在 schema 验证逻辑中，以处理模型可能偏离严格 JSON 格式的情况。