快速开始
学习如何在 10 分钟内使用 Claude API 的 Agent Skills 创建文档。
本教程向您展示如何使用 Agent Skills 创建 PowerPoint 演示文稿。您将学习如何启用 Skills、发出简单请求并访问生成的文件。
前提条件
- Anthropic API 密钥
- 安装 Python 3.7+ 或 curl
- 对发出 API 请求有基本了解
什么是 Agent Skills？
预置的 Agent Skills 通过专业知识扩展 Claude 的功能，用于创建文档、分析数据和处理文件等任务。Anthropic 在 API 中提供以下预置 Agent Skills：
- PowerPoint (pptx)：创建和编辑演示文稿
- Excel (xlsx)：创建和分析电子表格
- Word (docx)：创建和编辑文档
- PDF (pdf)：生成 PDF 文档
想创建自定义 Skills？请参阅 Agent Skills Cookbook 获取使用特定领域专业知识构建您自己的 Skills 的示例。
步骤 1：列出可用的 Skills
首先，让我们看看有哪些 Skills 可用。我们将使用 Skills API 列出所有 Anthropic 管理的 Skills：
import anthropic
client = anthropic.Anthropic()
# 列出 Anthropic 管理的 Skills
skills = client.beta.skills.list(
source="anthropic",
betas=["skills-2025-10-02"]
)
for skill in skills.data:
print(f"{skill.id}: {skill.display_title}")您将看到以下 Skills：pptx、xlsx、docx 和 pdf。
此 API 返回每个 Skill 的元数据：其名称和描述。Claude 在启动时加载此元数据以了解哪些 Skills 可用。这是渐进式披露的第一级，Claude 在不加载完整指令的情况下发现 Skills。
步骤 2：创建演示文稿
现在我们将使用 PowerPoint Skill 创建一个关于可再生能源的演示文稿。我们使用 Messages API 中的 container 参数指定 Skills：
import anthropic
client = anthropic.Anthropic()
# 使用 PowerPoint Skill 创建消息
response = client.beta.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
container={
"skills": [
{
"type": "anthropic",
"skill_id": "pptx",
"version": "latest"
}
]
},
messages=[{
"role": "user",
"content": "创建一个关于可再生能源的 5 张幻灯片的演示文稿"
}],
tools=[{
"type": "code_execution_20250825",
"name": "code_execution"
}]
)
print(response.content)让我们分解每个部分的作用：
container.skills：指定 Claude 可以使用哪些 Skillstype: "anthropic"：表示这是 Anthropic 管理的 Skillskill_id: "pptx"：PowerPoint Skill 标识符version: "latest"：设置为最新发布的 Skill 版本tools：启用代码执行（Skills 必需）- Beta headers：
code-execution-2025-08-25和skills-2025-10-02
当您发出此请求时，Claude 会自动将您的任务与相关 Skill 匹配。由于您要求创建演示文稿，Claude 确定 PowerPoint Skill 相关并加载其完整指令：这是渐进式披露的第二级。然后 Claude 执行 Skill 的代码来创建您的演示文稿。
步骤 3：下载创建的文件
演示文稿在代码执行容器中创建并保存为文件。响应包含带有文件 ID 的文件引用。提取文件 ID 并使用 Files API 下载它：
# 从响应中提取文件 ID
file_id = None
for block in response.content:
if block.type == 'tool_use' and block.name == 'code_execution':
# 文件 ID 在工具结果中
for result_block in block.content:
if hasattr(result_block, 'file_id'):
file_id = result_block.file_id
break
if file_id:
# 下载文件
file_content = client.beta.files.download(
file_id=file_id,
betas=["files-api-2025-04-14"]
)
# 保存到磁盘
with open("renewable_energy.pptx", "wb") as f:
file_content.write_to_file(f.name)
print(f"演示文稿已保存到 renewable_energy.pptx")有关使用生成文件的完整详细信息，请参阅 代码执行工具文档。
尝试更多示例
现在您已使用 Skills 创建了第一个文档，请尝试这些变体：
创建电子表格
response = client.beta.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
container={
"skills": [
{
"type": "anthropic",
"skill_id": "xlsx",
"version": "latest"
}
]
},
messages=[{
"role": "user",
"content": "创建一个带有示例数据的季度销售跟踪电子表格"
}],
tools=[{
"type": "code_execution_20250825",
"name": "code_execution"
}]
)创建 Word 文档
response = client.beta.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
container={
"skills": [
{
"type": "anthropic",
"skill_id": "docx",
"version": "latest"
}
]
},
messages=[{
"role": "user",
"content": "撰写一份关于可再生能源好处的 2 页报告"
}],
tools=[{
"type": "code_execution_20250825",
"name": "code_execution"
}]
)生成 PDF
response = client.beta.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
container={
"skills": [
{
"type": "anthropic",
"skill_id": "pdf",
"version": "latest"
}
]
},
messages=[{
"role": "user",
"content": "生成一个 PDF 发票模板"
}],
tools=[{
"type": "code_execution_20250825",
"name": "code_execution"
}]
)后续步骤
现在您已使用了预置的 Agent Skills，您可以：
- 在 Claude API 中使用 Skills - 完整 API 指南
- 创建自定义 Skills - 上传您自己的专业任务 Skills
- 最佳实践 - 学习编写有效 Skills 的最佳实践
- Agent Skills Cookbook - 探索示例 Skills 和实现模式