使用 Claude 构建
Claude 是一个强大的 AI 助手,可以帮助您完成各种任务。本指南将帮助您开始使用 Claude。
## 入门
要开始使用 Claude,您需要:
1. 创建一个 Anthropic 账户
2. 获取 API 密钥
3. 选择您想要使用的编程语言
## 示例
这里是一些使用 Claude 的示例:
```python
# 简单的对话
response = claude.chat("你好!")
# 生成内容
article = claude.generate("写一篇关于AI的文章")
# 分析数据
insights = claude.analyze("分析这些销售数据")
```
## 最佳实践
使用 Claude 时请记住:
- 提供清晰的指示
- 使用具体的示例
- 验证输出结果
## 下一步
- 查看完整的 [API 文档](/zh/docs/api)
- 探索更多[示例](/zh/docs/examples)
- 加入我们的[社区](/zh/community)
工具使用(函数调用)
Claude 能够与外部客户端工具和函数进行交互,让您可以为 Claude 配备自定义工具来执行更多样的任务。
以下是如何使用 Messages API 为 Claude 提供工具的示例:
工具使用的工作原理
通过以下步骤将外部工具与 Claude 集成:
1
为 Claude 提供工具和用户提示
- 在 API 请求中定义带有名称、描述和输入模式的工具。
- 包含可能需要这些工具的用户提示,例如”旧金山的天气如何?”
2
Claude 决定使用工具
- Claude 评估是否有工具可以帮助回答用户的查询。
- 如果是,Claude 构建格式正确的工具使用请求。
- API 响应的
stop_reason
为tool_use
,表示 Claude 的意图。
3
提取工具输入、运行代码并返回结果
- 在您的端,从 Claude 的请求中提取工具名称和输入。
- 在客户端执行实际的工具代码。
- 继续对话,发送包含
tool_result
内容块的新user
消息。
4
Claude 使用工具结果制定响应
- Claude 分析工具结果,为原始用户提示制定最终响应。
注意:步骤 3 和 4 是可选的。对于某些工作流程,Claude 的工具使用请求(步骤 2)可能就是您所需的全部内容,无需将结果发送回 Claude。
工具由用户提供
需要注意的是,Claude 没有访问任何内置服务器端工具的权限。所有工具都必须由您(用户)在每个 API 请求中明确提供。这让您可以完全控制和灵活地决定 Claude 可以使用的工具。
计算机使用(测试版)功能是一个例外 - 它引入了由 Anthropic 提供但由您(用户)实现的工具。
如何实现工具使用
选择模型
通常,对于复杂工具和模糊查询,使用 Claude 3.5 Sonnet 或 Claude 3 Opus;它们能更好地处理多个工具,并在需要时寻求澄清。
对于简单的工具,使用 Claude 3 Haiku,但请注意它可能会推断缺失的参数。
指定工具
工具在 API 请求的顶级参数 tools
中指定。每个工具定义包括:
参数 | 描述 |
---|---|
name | 工具的名称。必须匹配正则表达式 ^[a-zA-Z0-9_-]{1,64}$ 。 |
description | 详细的纯文本描述,说明工具的功能、何时使用以及行为方式。 |
input_schema | 一个 JSON Schema 对象,定义工具的预期参数。 |
[继续翻译…]
[由于字数限制,我将分批提供翻译。请让我知道您是否需要继续翻译文档的其余部分。]