СообщенияНавыки

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

Узнайте, как использовать Agent Skills для создания документов с помощью Claude API менее чем за 10 минут.

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

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

Ключ API Claude
Установленный Python 3.7+ или curl
Базовое знакомство с выполнением запросов к API

Обзор Agent Skills

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

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

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

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

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

# Вывести список навыков, управляемых Anthropic
ant beta:skills list --source anthropic

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

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

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

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

# Создать сообщение с навыком PowerPoint
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Разберём, что делает каждая часть:

container.skills: указывает, какие навыки может использовать Claude
type: "anthropic": указывает, что это навык, управляемый Anthropic
skill_id: "pptx": идентификатор навыка PowerPoint
version: "latest": версия навыка, установленная на последнюю опубликованную
tools: включает выполнение кода (требуется для навыков)
Бета-заголовки: code-execution-2025-08-25 и skills-2025-10-02

В приведённых здесь примерах используется версия инструмента code_execution_20250825 с соответствующим бета-заголовком code-execution-2025-08-25. Навыки также работают с более новыми версиями инструмента выполнения кода (code_execution_20260120 и более поздними); любая версия инструмента выполнения кода удовлетворяет требованию для навыков. Какую бы версию вы ни использовали, следите за тем, чтобы её type инструмента и бета-заголовок соответствовали странице инструмента выполнения кода, и всегда включайте skills-2025-10-02.

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

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

Презентация была создана в контейнере выполнения кода и сохранена как файл. Ответ содержит ссылку на файл с идентификатором файла. Извлеките идентификатор файла и скачайте его с помощью Files API:

# Извлечь ID файла из результата инструмента выполнения кода. Навык может выполнять
# свою работу через инструмент выполнения кода Python или bash, поэтому проверяем
# оба типа результатов.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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:
    # Скачать файл и сохранить его
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.beta.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-4-8",
    max_tokens=16000,
    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"}],
)

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

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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"}],
)

Генерация PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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"}],
)

Дальнейшие шаги

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

Руководство по API

Использовать навыки с Claude API

Создание собственных навыков

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

Руководство по созданию

Изучить лучшие практики написания эффективных навыков

Использование навыков в Claude Code

Узнать о навыках в Claude Code

Agent Skills Cookbook

Изучить примеры навыков и шаблоны реализации

Was this page helpful?

СообщенияНавыки

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

Узнайте, как использовать Agent Skills для создания документов с помощью Claude API менее чем за 10 минут.

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

Ключ API Claude
Установленный Python 3.7+ или curl
Базовое знакомство с выполнением запросов к API

Обзор Agent Skills

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

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

# Вывести список навыков, управляемых Anthropic
ant beta:skills list --source anthropic

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

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

# Создать сообщение с навыком PowerPoint
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Разберём, что делает каждая часть:

container.skills: указывает, какие навыки может использовать Claude
type: "anthropic": указывает, что это навык, управляемый Anthropic
skill_id: "pptx": идентификатор навыка PowerPoint
version: "latest": версия навыка, установленная на последнюю опубликованную
tools: включает выполнение кода (требуется для навыков)
Бета-заголовки: code-execution-2025-08-25 и skills-2025-10-02

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

# Извлечь ID файла из результата инструмента выполнения кода. Навык может выполнять
# свою работу через инструмент выполнения кода Python или bash, поэтому проверяем
# оба типа результатов.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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:
    # Скачать файл и сохранить его
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.beta.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-4-8",
    max_tokens=16000,
    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"}],
)

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

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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"}],
)

Генерация PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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"}],
)

Дальнейшие шаги

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

Руководство по API

Использовать навыки с Claude API

Создание собственных навыков

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

Руководство по созданию

Изучить лучшие практики написания эффективных навыков

Использование навыков в Claude Code

Узнать о навыках в Claude Code

Agent Skills Cookbook

Изучить примеры навыков и шаблоны реализации

Was this page helpful?

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

Обзор Agent Skills

Шаг 1. Получите список доступных навыков

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

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

Попробуйте другие примеры

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

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

Генерация PDF

Дальнейшие шаги

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

Обзор Agent Skills

Шаг 1. Получите список доступных навыков

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

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

Попробуйте другие примеры

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

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

Генерация PDF

Дальнейшие шаги

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

Обзор Agent Skills

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

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

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

Попробуйте другие примеры

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

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

Генерация PDF

Дальнейшие шаги

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

Обзор Agent Skills

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

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

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

Попробуйте другие примеры

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

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

Генерация PDF

Дальнейшие шаги