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

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

Узнайте, как использовать Agent Skills для расширения возможностей Claude через API.

Agent Skills расширяют возможности Claude с помощью организованных папок с инструкциями, скриптами и ресурсами. В этом руководстве показано, как использовать с Claude API как готовые, так и пользовательские навыки (Skills).

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

Узнайте, как писать эффективные навыки, которые Claude сможет обнаруживать и успешно использовать.

Обзор

Навыки интегрируются с Messages API через инструмент выполнения кода. Независимо от того, используете ли вы готовые навыки, управляемые Anthropic, или загруженные вами пользовательские навыки, схема интеграции одинакова: оба варианта требуют выполнения кода и используют одну и ту же структуру container.

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

Навыки интегрируются в Messages API одинаково независимо от источника. Вы указываете навыки в параметре container с помощью skill_id, type и необязательного version, и они выполняются в среде выполнения кода.

Вы можете использовать навыки из двух источников:

АспектНавыки AnthropicПользовательские навыки
Значение typeanthropiccustom
ID навыковКороткие имена: pptx, xlsx, docx, pdfГенерируемые: skill_01AbCdEfGhIjKlMnOpQrStUv
Формат версииНа основе даты: 20251013 или latestID версии: skver_01AbCdEfGhIjKlMnOpQrStUv или latest
УправлениеГотовые и поддерживаемые AnthropicЗагрузка и управление через Skills APIДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.
ДоступностьДоступны всем пользователямПриватны для вашего рабочего пространства

Навыки из обоих источников возвращаются эндпоинтом List SkillsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. (для фильтрации используйте параметр source). Схема интеграции и среда выполнения идентичны. Единственное различие — откуда берутся навыки и как ими управляют.

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

Для использования навыков вам понадобятся:

  1. Ключ API Claude из Claude Console
  2. Инструмент выполнения кода, включённый в ваших запросах

Навыкам требуется инструмент выполнения кода, поэтому используйте модель, указанную в его разделе о поддержке API.


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

Параметр container

Навыки указываются с помощью параметра container в Messages API. В каждый запрос можно включить до 20 навыков.

Структура одинакова как для навыков Anthropic, так и для пользовательских навыков. Укажите обязательные type и skill_id и при необходимости добавьте version, чтобы закрепить конкретную версию:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[
        {"role": "user", "content": "Create a presentation about renewable energy"}
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Скачивание созданных файлов

Когда навыки создают документы (Excel, PowerPoint, PDF, Word), они возвращают в ответе атрибуты file_id. Для скачивания этих файлов необходимо использовать Files API.

Как это работает:

  1. Навыки создают файлы во время выполнения кода.
  2. Ответ включает file_id для каждого созданного файла внутри блоков результатов инструмента выполнения кода (см. Формат ответа).
  3. Используйте Files API для скачивания фактического содержимого файла.
  4. Сохраните локально или обработайте по мере необходимости.

Чтобы предоставить навыкам входные файлы для работы, загрузите их с помощью Files API и сошлитесь на них в запросе с помощью блока загрузки в контейнер.

Пример: создание и скачивание файла Excel

client = anthropic.Anthropic()

# Шаг 1: используйте Skill для создания файла
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create an Excel file with a simple budget spreadsheet",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)


# Шаг 2: извлеките идентификаторы файлов из ответа
def extract_file_ids(response):
    file_ids = []
    for item in response.content:
        if item.type == "bash_code_execution_tool_result":
            content_item = item.content
            if content_item.type == "bash_code_execution_result":
                # каждый элемент content — это блок bash_code_execution_output с file_id
                for file in content_item.content:
                    file_ids.append(file.file_id)
    return file_ids


# Шаг 3: скачайте файл с помощью Files API
for file_id in extract_file_ids(response):
    file_metadata = client.files.retrieve_metadata(file_id=file_id)
    file_content = client.files.download(file_id=file_id)

    # Шаг 4: сохраните на диск
    file_content.write_to_file(file_metadata.filename)
    print(f"Downloaded: {file_metadata.filename}")

Дополнительные операции Files API:

client = anthropic.Anthropic()
file_id = "file_011CNha8iCJcU1wXNR6q4V8w"
# Получить метаданные файла
file_info = client.files.retrieve_metadata(file_id=file_id)
print(f"Filename: {file_info.filename}, Size: {file_info.size_bytes} bytes")

# Вывести список всех файлов
for file in client.files.list():
    print(f"{file.filename} - {file.created_at}")

# Удалить файл
client.files.delete(file_id=file_id)

Многоходовые диалоги

Объект container в ответе содержит id контейнера и временную метку expires_at (подробнее о времени жизни см. Повторное использование контейнера). Чтобы повторно использовать один и тот же контейнер в нескольких сообщениях, укажите ID контейнера:

client = anthropic.Anthropic()

# Первый запрос создаёт контейнер
response1 = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[
        {"role": "user", "content": "Create a sample sales dataset and analyze it"}
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

# Продолжаем диалог с тем же контейнером
messages = [
    {"role": "user", "content": "Create a sample sales dataset and analyze it"},
    {
        # Передаём текст ассистента дальше; container.id хранит состояние выполнения
        "role": "assistant",
        "content": "\n".join(
            block.text for block in response1.content if block.type == "text"
        ),
    },
    {"role": "user", "content": "What was the total revenue?"},
]

response2 = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "id": response1.container.id,  # Reuse container
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}],
    },
    messages=messages,
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Длительные операции

Навыки могут выполнять операции, требующие нескольких ходов. Обрабатывайте причины остановки pause_turn:

client = anthropic.Anthropic()

messages = [{"role": "user", "content": "Generate and process a large sample dataset"}]
max_retries = 10

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                "version": "latest",
            }
        ]
    },
    messages=messages,
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

# Обработка pause_turn для длительных операций
for _ in range(max_retries):
    if response.stop_reason != "pause_turn":
        break

    messages.append({"role": "assistant", "content": response.content})
    response = client.messages.create(
        model="claude-opus-5-5",
        max_tokens=4096,
        container={
            "id": response.container.id,
            "skills": [
                {
                    "type": "custom",
                    "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                    "version": "latest",
                }
            ],
        },
        messages=messages,
        tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
    )

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

Объединяйте несколько навыков в одном запросе для выполнения сложных рабочих процессов:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "latest"},
            {"type": "anthropic", "skill_id": "pptx", "version": "latest"},
            {
                "type": "custom",
                "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                "version": "latest",
            },
        ]
    },
    messages=[
        {"role": "user", "content": "Analyze sales data and create a presentation"}
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Управление пользовательскими навыками

Создание навыка

Пакет навыка — это каталог, содержащий на верхнем уровне файл SKILL.md с YAML-frontmatter name и description, а также любые вспомогательные скрипты или ресурсы. Чтобы создать навык, см. Лучшие практики создания навыков, а полный список ограничений — в перечне Требования после примеров.

Загрузите свой пользовательский навык, чтобы сделать его доступным в рабочем пространстве. Можно загрузить zip-архив или отдельные файловые объекты. Python SDK также предоставляет вспомогательную функцию files_from_dir, принимающую путь к каталогу, а команда CLI ant apply загружает сам каталог.

Файлы идентифицируются по прикреплённому имени файла (суффикс ;filename= в примере cURL и аргументы с именами файлов в примерах SDK). Для навыка из пошагового руководства создайте zip-архив командой zip -r financial_skill.zip financial_skill/ и подставьте его вместо заполнителя example_skill.zip в вариантах загрузки zip-архива.

ant apply financial_skill
financial_skill/SKILL.md
---
name: financial-skill
description: Docs example skill.
---
financial_skill/analyze.py
print("financial analysis helper")

Требования:

  • Должен содержать файл SKILL.md в корне загрузки (или на верхнем уровне единственной вложенной папки)
  • display_name необязателен: если он не указан, он берётся из name в SKILL.md; явно заданное значение может содержать до 255 символов и не обязано быть уникальным в пределах рабочего пространства
  • Общий размер загрузки должен быть меньше 30 MB (в несжатом виде)
  • Требования к YAML-frontmatter:
    • name: не более 64 символов, только строчные буквы/цифры/дефисы, без XML-тегов, без зарезервированных слов (anthropic, claude)
    • description: не более 1 024 символов, непустое, без XML-тегов

Полные схемы запросов и ответов см. в справочнике API Создать навыкДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..

Получение списка навыков

Получите все навыки, доступные вашему рабочему пространству, включая как готовые навыки Anthropic, так и ваши пользовательские навыки. Используйте параметр source для фильтрации по типу навыка:

client = anthropic.Anthropic()

# Вывести список всех Skills
for skill in client.skills.list():
    print(f"{skill.id}: {skill.display_name} (source: {skill.source.type})")

# Вывести только пользовательские Skills
custom_skills = client.skills.list(source="custom")

Параметры пагинации и фильтрации см. в справочнике API «Список навыков»Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..

Получение навыка

Получите сведения о конкретном навыке:

client = anthropic.Anthropic()

skill = client.skills.retrieve(skill_id="skill_01AbCdEfGhIjKlMnOpQrStUv")

print(f"Skill: {skill.display_name}")
print(f"Latest version: {skill.latest_version_id}")
print(f"Created: {skill.created_at}")

Удаление навыка

При удалении навыка также удаляются все его версии.

client = anthropic.Anthropic()

client.skills.delete(skill_id="skill_01AbCdEfGhIjKlMnOpQrStUv")

Управление версиями

Навыки поддерживают «versioning» (управление версиями) для безопасного внесения обновлений:

Навыки Anthropic:

  • Версии используют формат даты: 20251013
  • Новые версии выпускаются по мере внесения обновлений
  • Указывайте точные версии для стабильности

Пользовательские навыки:

  • Автоматически генерируемые ID версий: skver_01AbCdEfGhIjKlMnOpQrStUv
  • Используйте "latest", чтобы всегда получать самую свежую версию
  • Создавайте новые версии при обновлении файлов навыка

Новая версия — это полный снимок, а не разница: каждый раз загружайте полный набор файлов навыка. Файлы, которые вы не включили, не переносятся, а name в SKILL.md новой версии должно совпадать с существующим именем навыка. В следующих примерах повторно загружается полный пакет financial_skill/ из раздела Создание навыка.

from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

# Создать новую версию

new_version = client.skills.versions.create(
    skill_id="skill_01AbCdEfGhIjKlMnOpQrStUv",
    files=files_from_dir("financial_skill"),
)

# Использовать конкретную версию
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                "version": new_version.id,
            }
        ]
    },
    messages=[{"role": "user", "content": "Use updated Skill"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

# Использовать последнюю версию
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                "version": "latest",
            }
        ]
    },
    messages=[{"role": "user", "content": "Use latest Skill version"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Полные сведения см. в справочнике API «Создать версию навыка»Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..


Как загружаются навыки

Когда вы указываете навыки в контейнере:

  1. Обнаружение метаданных: Claude получает метаданные каждого навыка (имя, описание) в «system prompt» (системная подсказка).
  2. Загрузка файлов: файлы навыка копируются в контейнер по пути /skills/{skill-name}/. Имя каталога — это имя навыка (pptx для навыка Anthropic, name из SKILL.md для пользовательского навыка), а не его ID вида skill_01....
  3. Автоматическое использование: Claude автоматически загружает и использует навыки, когда они релевантны вашему запросу.
  4. Композиция: несколько навыков объединяются для выполнения сложных рабочих процессов.

Claude загружает полные инструкции навыка только тогда, когда они нужны.


Сценарии использования

Навыки подходят как для работы организаций, так и для личной работы. Организации используют их для применения фирменного оформления к документам, структурирования заметок и отчётов по корпоративным шаблонам, а также для выполнения специфичных для компании аналитических процедур. Частные пользователи применяют их для собственных шаблонов документов, специализированных конвейеров обработки данных и соглашений по генерации или развёртыванию кода.

Пример: финансовое моделирование

Объедините навык Excel и пользовательский навык DCF-анализа. Сначала создайте пользовательский навык DCF-анализа:

ant apply dcf_skill

Затем используйте его вместе с навыком Excel для создания финансовой модели. Передайте ID созданного навыка в качестве skill_id пользовательского навыка:

client = anthropic.Anthropic()

# Пользовательский Skill для DCF-анализа (ID из ответа Skills API на создание)
dcf_skill_id = "skill_01AbCdEfGhIjKlMnOpQrStUv"

# Используйте с Excel для создания финансовой модели
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "latest"},
            {"type": "custom", "skill_id": dcf_skill_id, "version": "latest"},
        ]
    },
    messages=[
        {
            "role": "user",
            "content": "Build a DCF valuation model for a SaaS company",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)
print(response)

Ограничения

Ограничения запросов

  • Максимальное число навыков в одном запросе: 20
  • Максимальный размер загружаемого навыка: 30 MB (все файлы вместе, в несжатом виде)
  • Требования к YAML-frontmatter:
    • name: не более 64 символов, только строчные буквы/цифры/дефисы, без XML-тегов, без зарезервированных слов (anthropic, claude)
    • description: не более 1 024 символов, непустое, без XML-тегов

Ограничения среды

Навыки выполняются в контейнере выполнения кода со следующими ограничениями:

  • Нет доступа к сети: невозможно выполнять внешние вызовы API
  • Нельзя устанавливать пакеты во время выполнения: доступны только предустановленные пакеты
  • Изолированная среда: создаётся новый контейнер, если вы не укажете ID существующего контейнера

Доступные пакеты см. в разделе Инструмент выполнения кода.


Рекомендации

Когда использовать несколько навыков

Объединяйте навыки, когда задачи охватывают несколько типов документов или предметных областей:

Подходящие сценарии:

  • Анализ данных (Excel) + создание презентации (PowerPoint)
  • Создание отчёта (Word) + экспорт в PDF
  • Пользовательская предметная логика + генерация документов

Избегайте:

  • Включения неиспользуемых навыков (влияет на производительность)

Стратегия управления версиями

На вкладках SDK в этом разделе показано значение container, которое нужно включить в запрос Messages. На вкладках cURL и CLI показан полный запрос.

Для продакшена: закрепляйте конкретную версию, чтобы обновления навыков никогда не меняли поведение развёрнутой системы. Если вы не указываете version или задаёте значение "latest", запросы используют самую новую версию навыка, поэтому версия, загруженная кем угодно в рабочем пространстве, немедленно меняет то, что выполняют ваши агенты в продакшене. ID версии берётся из ответа на создание версии в разделе Управление версиями или из API «Список версий навыка»Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. ID всегда является строкой, поэтому заключайте его в кавычки в JSON или YAML, даже если он выглядит как число.

# Закрепите конкретные версии для стабильности
container = {
    "skills": [
        {
            "type": "custom",
            "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
            "version": "skver_01AbCdEfGhIjKlMnOpQrStUv",
        }
    ]
}

Для разработки: используйте latest, чтобы автоматически получать самую новую версию по мере итераций.

# Используйте latest при активной разработке
container = {
    "skills": [
        {
            "type": "custom",
            "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
            "version": "latest",
        }
    ]
}

Особенности кэширования подсказок

Если вы используете «prompt caching» (кэширование подсказок), изменение списка навыков в контейнере нарушает кэш. Навыки отображаются в системной подсказке в фиксированном порядке, поэтому один и тот же список даёт один и тот же кэшируемый префикс:

client = anthropic.Anthropic()

# Skills попадают в системную подсказку в фиксированном порядке, удобном для кэширования
response1 = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[{"role": "user", "content": "Analyze sales data"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

# Изменение списка Skills ([xlsx] против [xlsx, pptx]) меняет префикс: промах кэша, а идентичный список — попадание в кэш
response2 = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "latest"},
            {
                "type": "anthropic",
                "skill_id": "pptx",
                "version": "latest",
            },  # prefix change: cache miss
        ]
    },
    messages=[{"role": "user", "content": "Create a presentation"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Для наилучшей эффективности кэширования сохраняйте список навыков, включая их порядок, неизменным от запроса к запросу. Закрепление версий пользовательских навыков также помогает: при использовании "latest" публикация новой версии может сделать кэшированный префикс недействительным, если она меняет описание навыка.

Обработка ошибок

Корректно обрабатывайте ошибки, связанные с навыками:

client = anthropic.Anthropic()

try:
    response = client.messages.create(
        model="claude-opus-5-5",
        max_tokens=4096,
        container={
            "skills": [
                {
                    "type": "custom",
                    "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
                    "version": "latest",
                }
            ]
        },
        messages=[{"role": "user", "content": "Process data"}],
        tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
    )
except anthropic.BadRequestError as e:
    if "skill" in str(e):
        print(f"Skill error: {e}")
        # Обработка ошибок, специфичных для навыков
    else:
        raise

Миграция с skills-2025-10-02

Skills API вышел из бета-версии и не требует бета-заголовка. Миграция с skills-2025-10-02 необязательна: запросы, которые его отправляют, продолжают работать и продолжают возвращать формы ответов бета-версии, поэтому существующая интеграция продолжает работать, пока вы её не измените. Удаление заголовка переключает эти запросы на формы, описанные на этой странице:

С skills-2025-10-02Без заголовка
Метка навыкаdisplay_title (до 64 символов, уникальна в рабочем пространстве)display_name (до 255 символов, не уникальна); выводится из name в SKILL.md, если опущена
Указатель на новейшую версиюlatest_version, строка с микросекундами эпохи, например "1759178010641129"latest_version_id, идентификатор версии, например "skver_01AbCdEfGhIjKlMnOpQrStUv"; GET /v1/skills/{skill_id}/versions/latest разрешает его за один вызов
Идентификатор версии в URLСтрока с микросекундами эпохиИдентификатор версии (skver_...). Идентификаторы, полученные в бета-версии с префиксом skill_version_, принимаются в качестве входных данных.
Объект версииВключает directory (всегда равен name навыка)Нет поля directory
sourceСтрока, "custom" или "anthropic"Объект, например {"type": "custom"}; значение для каталога примеров — "anthropic_example"
Ответы со списками{ data, has_more, next_page }{ data, next_page }; limit от 1 до 1 000 (по умолчанию 20)
Порядок списка версийСначала самые старыеСначала самые новые, limit по умолчанию 20. Курсоры страниц одной формы недействительны для другой.
Удаление навыкаВозвращает ошибку 400, пока существует хотя бы одна версияУдаляет навык и все его версии
Удаление единственной версии навыкаРазрешено, оставляет навык без версийВозвращает ошибку 400; сначала загрузите версию на замену или удалите навык
Структура загрузкиФайлы должны находиться внутри каталога верхнего уровня, имя которого совпадает с name навыкаSKILL.md может находиться в корне загрузки; сохраняемые пути одинаковы в обоих случаях
Типы ответовCreateSkillResponse, GetSkillResponse и по одному типу на операциюSkill, SkillVersion, DeletedSkill, DeletedSkillVersion

Для миграции:

  1. Удалите бета-заголовок. Уберите anthropic-beta: skills-2025-10-02 из своих запросов. При работе с SDK вызывайте client.skills вместо client.beta.skills; сохранение client.beta.skills работает только в выпусках SDK, которые больше не отправляют этот заголовок. Более ранние выпуски отправляют его из client.beta.skills, даже если вы не передаёте имена бета-функций.
  2. Переименуйте поля в своём коде: display_title в display_name и latest_version в latest_version_id. Считывайте source.type вместо сравнения source со строкой.
  3. Используйте идентификаторы версий. Везде, где вы хранили версию в микросекундах эпохи, храните вместо неё id версии или используйте latest. Ссылки на навыки в запросах Messages принимают идентификатор версии, latest или (для навыков Anthropic) версию каталога.
  4. Проверьте вызовы удаления. DELETE /v1/skills/{skill_id} теперь удаляет все версии вместе со Skill. Если вы полагались на отказ бета-версии как на защитный механизм, добавьте собственную проверку.

Навык, все версии которого были удалены в бета-версии, не имеет текущей версии для возврата: GET /v1/skills/{skill_id} возвращает ошибку 400, и навык исключается из ответов со списками, пока вы не загрузите в него версию. Вы по-прежнему можете его удалить.

Пространство имён beta в SDK

Начиная с Python SDK 1.2.0, TypeScript SDK 0.122.0, Go SDK 1.68.0, Java SDK 2.59.0, PHP SDK 0.45.0, Ruby SDK 1.67.0 и C# SDK 12.44.0, client.beta.skills больше не отправляет skills-2025-10-02 и возвращает те же форматы, что и client.skills, с бета-именами типов (BetaSkill, BetaSkillVersion, BetaDeletedSkill, BetaDeletedSkillVersion). Он принимает имена бета-функций через betas для функций Skills, находящихся в бета-версии. В бета-типах Messages тип ссылки на Skill контейнера переименован с BetaSkill на BetaContainerSkill (те же поля: type, skill_id, version); BetaSkill теперь обозначает ресурс Skill, что соответствует Skill и ContainerSkill в небета-типах. Более ранние выпуски SDK типизированы под бета-форматы; если вы зависите от этих типов, оставайтесь на более раннем выпуске, пока не выполните миграцию.

Хранение данных

На Agent Skills не распространяются соглашения о «zero data retention» (нулевом хранении данных), или ZDR. Определения Skills и данные их выполнения хранятся в соответствии со стандартной политикой хранения данных Anthropic.

Сведения о соответствии требованиям ZDR для всех функций см. в разделе API и хранение данных.

Журнал аудита

Если в вашей организации включён Compliance API, его лента активности записывает создание и удаление Skills и версий Skills, выполненные с помощью ключа API Claude или из Claude Console. Операции, выполненные при отключённом Compliance API, не записываются и не могут быть восстановлены позже, поэтому настройте Compliance API, прежде чем полагаться на этот журнал аудита.

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

Полный справочник по API со всеми эндпоинтами

Узнайте, как писать эффективные Skills, которые Claude может обнаруживать и успешно использовать.

Запускайте код на Python и Bash в изолированном контейнере, чтобы анализировать данные, создавать файлы и итеративно улучшать решения.

Эта страница была полезной?