本教學將向您展示如何使用 Agent Skills 建立 PowerPoint 簡報。您將學習如何啟用 Skills、發出請求,以及存取生成的檔案。
curl 和 jq預建的 Agent Skills 以專業知識擴展 Claude 的能力,用於建立文件、分析資料和處理檔案等任務。Anthropic 在 API 中提供以下預建的 Agent Skills:
首先,查看有哪些可用的 Skills。使用 Skills API 列出所有由 Anthropic 管理的 Skills。每個語言分頁都是一個連續腳本的節錄,所有 import 和用戶端設定都在頂部:
# List Anthropic-managed Skills
ant skills list --source anthropic您會看到以下 Skills:pptx、xlsx、docx 和 pdf。
此 API 會回傳每個 Skill 的中繼資料:其名稱和描述。Claude 在啟動時載入這些中繼資料,以判斷哪些 Skills 可用。這是「progressive disclosure」(漸進式揭露)的第一層,Claude 在此階段發現 Skills,但尚未載入其完整指示。
使用 PowerPoint Skill 建立一份關於再生能源的簡報。在 Messages API 中使用 container 參數指定 Skills:
# Create a message with the PowerPoint Skill
response = client.messages.create(
model="claude-opus-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a presentation about renewable energy with 5 slides",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)
print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")此請求包含以下部分:
model: 一個支援程式碼執行工具的模型container.skills: 指定 Claude 可以使用哪些 Skillstype: "anthropic": 表示這是由 Anthropic 管理的 Skillskill_id: "pptx": PowerPoint Skill 的識別碼version: "latest": Skill 版本設定為最近發布的版本tools: 啟用程式碼執行(Skills 所必需)skills-2025-10-02當您發出此請求時,Claude 會自動將您的任務與相關的 Skill 配對。因為您要求建立簡報,Claude 判斷 PowerPoint Skill 是相關的,並載入其完整指示:這是漸進式揭露的第二層。然後 Claude 執行該 Skill 的程式碼來建立您的簡報。
簡報是在程式碼執行容器中建立並儲存為檔案的。步驟 2 的 response 包含一個帶有檔案 ID 的檔案參照。擷取檔案 ID 並使用 Files API 下載檔案。此範例會將其儲存到您系統的暫存目錄:
# Extract the file ID. The code execution tool runs the Skill's code through
# its Bash sub-tool, and generated files appear as bash_code_execution_output
# items inside the bash_code_execution_tool_result block.
file_id = None
for block in response.content:
if block.type == "bash_code_execution_tool_result":
if block.content.type == "bash_code_execution_result":
for output in block.content.content:
file_id = output.file_id
if file_id:
# Download the file and save it
output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
file_content = client.files.download(file_id=file_id)
file_content.write_to_file(output_path)
print(f"Presentation saved to {output_path}")試試這些變化:
response = client.beta.messages.create(
model="claude-opus-5",
max_tokens=16000,
betas=["skills-2025-10-02"],
container={
"skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a quarterly sales tracking spreadsheet with sample data",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)response = client.beta.messages.create(
model="claude-opus-5",
max_tokens=16000,
betas=["skills-2025-10-02"],
container={
"skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Write a 2-page report on the benefits of renewable energy",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)response = client.beta.messages.create(
model="claude-opus-5",
max_tokens=16000,
betas=["skills-2025-10-02"],
container={
"skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Generate a PDF invoice template",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)了解如何撰寫 Claude 能夠成功發現和使用的有效 Skills。
了解如何使用 Agent Skills 透過 API 擴展 Claude 的能力。
上傳您自己的 Skills 以執行專門任務。
了解 Claude Code 中的 Skills。
探索範例 Skills 和實作模式。
Was this page helpful?