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

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



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

• Ключ API Claude или авторизованный ant CLI
• Клиентский SDK для вашего языка, либо curl и jq
• Базовое знакомство с выполнением запросов к API



Обзор Agent Skills

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

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



Шаг 1: Получите список доступных Skills

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

# List Anthropic-managed Skills
ant skills list --source anthropic

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

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



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

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

# 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: Указывает, какие Skills может использовать Claude
• type: "anthropic": Указывает, что это Skill, управляемый Anthropic
• skill_id: "pptx": Идентификатор Skill PowerPoint
• version: "latest": Версия Skill, установленная на последнюю опубликованную
• tools: Включает выполнение кода (требуется для Skills)
• Бета-заголовок: skills-2025-10-02

Когда вы делаете этот запрос, Claude автоматически сопоставляет вашу задачу с соответствующим Skill. Поскольку вы запросили презентацию, Claude определяет, что Skill PowerPoint релевантен, и загружает его полные инструкции: это второй уровень постепенного раскрытия. Затем Claude запускает код Skill, чтобы создать вашу презентацию.



Шаг 3: Скачайте созданный файл

Презентация была создана в контейнере выполнения кода и сохранена как файл. Ответ response из шага 2 включает ссылку на файл с идентификатором файла. Извлеките идентификатор файла и скачайте файл с помощью 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"}],
)



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

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"}],
)



Сгенерируйте PDF

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"}],
)



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