Loading...
    • Construir
    • Admin
    • Modelos e preços
    • SDKs de cliente
    • Referência da API
    Search...
    ⌘K
    Primeiros passos
    Introdução ao ClaudeInício rápido
    Construindo com Claude
    Visão geral dos recursosUsando a API de MensagensTratando razões de parada
    Capacidades do modelo
    Pensamento estendidoPensamento adaptativoEsforçoModo rápido (beta: prévia de pesquisa)Saídas estruturadasCitaçõesMensagens em streamingProcessamento em loteResultados de pesquisaRecusas em streamingSuporte multilíngueEmbeddings
    Ferramentas
    Visão geralComo o uso de ferramentas funcionaFerramenta de busca na webFerramenta de busca webFerramenta de execução de códigoFerramenta de memóriaFerramenta BashFerramenta de uso do computadorFerramenta de edição de texto
    Infraestrutura de ferramentas
    Busca de ferramentasChamada programática de ferramentasStreaming refinado de ferramentas
    Gerenciamento de contexto
    Janelas de contextoCompactaçãoEdição de contextoCache de promptContagem de tokens
    Trabalhando com arquivos
    Files APISuporte a PDFImagens e visão
    Skills
    Visão geralInício rápidoMelhores práticasSkills para empresasSkills na API
    MCP
    Servidores MCP remotosConector MCP
    Engenharia de prompt
    Visão geralMelhores práticas de promptingFerramentas de prompting no Console
    Testar e avaliar
    Definir sucesso e criar avaliaçõesUsando a Ferramenta de Avaliação no ConsoleReduzindo latência
    Fortalecer guardrails
    Reduzir alucinaçõesAumentar consistência de saídaMitigar jailbreaksReduzir vazamento de prompt
    Recursos
    Glossário
    Notas de versão
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Skills

    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 os recursos 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 construção de 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:

    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 do PowerPoint para criar uma apresentação sobre energia renovável. Especifique Skills usando o parâmetro container na API de Mensagens:

    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 do 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 do 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:

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

    Tente mais exemplos

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

    Criar uma planilha

    Criar um documento Word

    Gerar um PDF

    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

    Was this page helpful?

    • Pré-requisitos
    • Visão geral do Agent Skills
    • Etapa 1: Listar Skills disponíveis
    • Etapa 2: Criar uma apresentação
    • Etapa 3: Baixar o arquivo criado
    • Tente mais exemplos
    • Criar uma planilha
    • Criar um documento Word
    • Gerar um PDF
    • Próximas etapas
    curl "https://api.anthropic.com/v1/skills?source=anthropic" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: skills-2025-10-02"
    curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "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"
    }]
  }'
    # Extract file_id from response (using jq)
FILE_ID=$(echo "$RESPONSE" | jq -r '.content[] | select(.type=="tool_use" and .name=="code_execution") | .content[] | select(.file_id) | .file_id')

# Download the file
curl "https://api.anthropic.com/v1/files/$FILE_ID/content" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  --output renewable_energy.pptx

echo "Presentation saved to renewable_energy.pptx"
    curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "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"
    }]
  }'
    curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "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"
    }]
  }'
    curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "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"
    }]
  }'
    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