Início rápido

ConstruirSkills

Comece com Agent Skills na API

Aprenda como usar Agent Skills para criar documentos com a Claude API em menos de 10 minutos.

Este tutorial mostra como usar Agent Skills para criar uma apresentação em PowerPoint. Você aprenderá como ativar Skills, fazer uma solicitação simples e acessar o arquivo gerado.

Pré-requisitos

Chave da API Claude
Python 3.7+ ou curl instalado
Familiaridade básica com solicitações de API

Visão geral do Agent Skills

Agent Skills pré-construídas estendem as capacidades do Claude com expertise especializada para tarefas como criar documentos, analisar dados e processar arquivos. A Anthropic fornece as seguintes Agent Skills pré-construídas na API:

PowerPoint (pptx): Criar e editar apresentações
Excel (xlsx): Criar e analisar planilhas
Word (docx): Criar e editar documentos
PDF (pdf): Gerar documentos PDF

Quer criar Skills personalizadas? Veja o Agent Skills Cookbook para exemplos de como construir suas próprias Skills com expertise específica do domínio.

Etapa 1: Listar Skills disponíveis

Primeiro, verifique quais Skills estão disponíveis. Use a API de Skills para listar todas as Skills gerenciadas pela Anthropic:

ant beta:skills list --source anthropic

Você vê as seguintes Skills: pptx, xlsx, docx e pdf.

Esta API retorna os metadados de cada Skill: seu nome e descrição. Claude carrega esses metadados na inicialização para saber quais Skills estão disponíveis. Este é o primeiro nível de divulgação progressiva, onde Claude descobre Skills sem carregar suas instruções completas ainda.

Etapa 2: Criar uma apresentação

Agora use a Skill de PowerPoint para criar uma apresentação sobre energia renovável. Especifique Skills usando o parâmetro container na API de Mensagens:

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)

Vamos decompor o que cada parte faz:

container.skills: Especifica quais Skills o Claude pode usar
type: "anthropic": Indica que esta é uma Skill gerenciada pela Anthropic
skill_id: "pptx": O identificador da Skill de PowerPoint
version: "latest": A versão da Skill definida como a mais recentemente publicada
tools: Ativa a execução de código (necessária para Skills)
Cabeçalhos Beta: code-execution-2025-08-25 e skills-2025-10-02

Quando você faz essa solicitação, Claude automaticamente corresponde sua tarefa à Skill relevante. Como você pediu uma apresentação, Claude determina que a Skill de PowerPoint é relevante e carrega suas instruções completas: o segundo nível de divulgação progressiva. Então Claude executa o código da Skill para criar sua apresentação.

Etapa 3: Baixar o arquivo criado

A apresentação foi criada no contêiner de execução de código e salva como um arquivo. A resposta inclui uma referência de arquivo com um ID de arquivo. Extraia o ID do arquivo e baixe-o usando a API de Arquivos:

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")

Para detalhes completos sobre como trabalhar com arquivos gerados, veja a documentação da ferramenta de execução de código.

Experimente mais exemplos

Agora que você criou seu primeiro documento com Skills, experimente estas variações:

Criar uma planilha

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

Criar um documento Word

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

Gerar um PDF

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

Próximas etapas

Agora que você usou Agent Skills pré-construídas, você pode:

Guia da API

Use Skills com a Claude API

Criar Skills Personalizadas

Envie suas próprias Skills para tarefas especializadas

Guia de Autoria

Aprenda as melhores práticas para escrever Skills eficazes

Usar Skills no Claude Code

Saiba mais sobre Skills no Claude Code

Agent Skills Cookbook

Explore Skills de exemplo e padrões de implementação

Was this page helpful?

ConstruirSkills

Comece com Agent Skills na API

Aprenda como usar Agent Skills para criar documentos com a Claude API em menos de 10 minutos.

Este tutorial mostra como usar Agent Skills para criar uma apresentação em PowerPoint. Você aprenderá como ativar Skills, fazer uma solicitação simples e acessar o arquivo gerado.

Pré-requisitos

Chave da API Claude
Python 3.7+ ou curl instalado
Familiaridade básica com solicitações de API

Visão geral do Agent Skills

PowerPoint (pptx): Criar e editar apresentações
Excel (xlsx): Criar e analisar planilhas
Word (docx): Criar e editar documentos
PDF (pdf): Gerar documentos PDF

Quer criar Skills personalizadas? Veja o Agent Skills Cookbook para exemplos de como construir suas próprias Skills com expertise específica do domínio.

Etapa 1: Listar Skills disponíveis

Primeiro, verifique quais Skills estão disponíveis. Use a API de Skills para listar todas as Skills gerenciadas pela Anthropic:

ant beta:skills list --source anthropic

Você vê as seguintes Skills: pptx, xlsx, docx e pdf.

Etapa 2: Criar uma apresentação

Agora use a Skill de PowerPoint para criar uma apresentação sobre energia renovável. Especifique Skills usando o parâmetro container na API de Mensagens:

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)

Vamos decompor o que cada parte faz:

container.skills: Especifica quais Skills o Claude pode usar
type: "anthropic": Indica que esta é uma Skill gerenciada pela Anthropic
skill_id: "pptx": O identificador da Skill de PowerPoint
version: "latest": A versão da Skill definida como a mais recentemente publicada
tools: Ativa a execução de código (necessária para Skills)
Cabeçalhos Beta: code-execution-2025-08-25 e skills-2025-10-02

Etapa 3: Baixar o arquivo criado

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")

Para detalhes completos sobre como trabalhar com arquivos gerados, veja a documentação da ferramenta de execução de código.

Experimente mais exemplos

Agora que você criou seu primeiro documento com Skills, experimente estas variações:

Criar uma planilha

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

Criar um documento Word

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

Gerar um PDF

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

Próximas etapas

Agora que você usou Agent Skills pré-construídas, você pode:

Guia da API

Use Skills com a Claude API

Criar Skills Personalizadas

Envie suas próprias Skills para tarefas especializadas

Guia de Autoria

Aprenda as melhores práticas para escrever Skills eficazes

Usar Skills no Claude Code

Saiba mais sobre Skills no Claude Code

Agent Skills Cookbook

Explore Skills de exemplo e padrões de implementação

Was this page helpful?