Начало работы с Agent Skills в API

В этом руководстве показано, как использовать Agent Skills для создания презентации PowerPoint. Вы узнаете, как включить Skills, сделать простой запрос и получить доступ к созданному файлу.

Предварительные требования

Claude API key
Python 3.7+ или curl установлены
Базовое знакомство с выполнением API запросов

Обзор Agent Skills

Предварительно созданные Agent Skills расширяют возможности Claude специализированной экспертизой для задач, таких как создание документов, анализ данных и обработка файлов. Anthropic предоставляет следующие предварительно созданные Agent Skills в API:

PowerPoint (pptx): Создание и редактирование презентаций
Excel (xlsx): Создание и анализ электронных таблиц
Word (docx): Создание и редактирование документов
PDF (pdf): Создание PDF документов

Хотите создать пользовательские Skills? Смотрите Agent Skills Cookbook для примеров создания собственных Skills со специализированной экспертизой.

Шаг 1: Список доступных Skills

Сначала проверьте, какие Skills доступны. Используйте Skills API для списка всех управляемых Anthropic Skills:

Вы видите следующие Skills: pptx, xlsx, docx и pdf.

Этот API возвращает метаданные каждого Skill: его имя и описание. Claude загружает эти метаданные при запуске, чтобы знать, какие Skills доступны. Это первый уровень прогрессивного раскрытия, где Claude обнаруживает Skills без загрузки их полных инструкций.

Шаг 2: Создание презентации

Теперь используйте PowerPoint Skill для создания презентации об возобновляемой энергии. Укажите Skills, используя параметр container в Messages API:

Давайте разберемся, что делает каждая часть:

container.skills: Указывает, какие Skills может использовать Claude
type: "anthropic": Указывает, что это управляемый Anthropic Skill
skill_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:

Для полной информации о работе с созданными файлами см. документацию инструмента выполнения кода.

Попробуйте больше примеров

Теперь, когда вы создали свой первый документ с Skills, попробуйте эти варианты:

Создание электронной таблицы

Создание документа Word

Создание PDF

Следующие шаги

Теперь, когда вы использовали предварительно созданные Agent Skills, вы можете:

API Guide

Использование Skills с Claude API

Create Custom Skills

Загрузите свои собственные Skills для специализированных задач

import anthropic

client = anthropic.Anthropic()

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-7",
    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": "Create a presentation about renewable energy with 5 slides",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

print(response.content)

from typing import Any

response: Any = None
# Extract file ID from response
file_id = None
for block in response.content:
    if block.type == "tool_use" and block.name == "code_execution":
        # File ID is in the tool result
        for result_block in block.content:
            if hasattr(result_block, "file_id"):
                file_id = result_block.file_id
                break

if file_id:
    # Download the file
    file_content = client.beta.files.download(
        file_id=file_id, betas=["files-api-2025-04-14"]
    )

    # Save to disk
    with open("renewable_energy.pptx", "wb") as f:
        file_content.write_to_file(f.name)

    print(f"Presentation saved to renewable_energy.pptx")

response = client.beta.messages.create(
    model="claude-opus-4-7",
    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": "Create a quarterly sales tracking spreadsheet with sample data",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

response = client.beta.messages.create(
    model="claude-opus-4-7",
    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": "Write a 2-page report on the benefits of renewable energy",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

response = client.beta.messages.create(
    model="claude-opus-4-7",
    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": "Generate a PDF invoice template"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)