Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Este tutorial mostra como usar Agent Skills para criar uma apresentação do PowerPoint. Você aprenderá como habilitar Skills, fazer uma solicitação e acessar o arquivo gerado.
curl e jqAs Agent Skills pré-construídas estendem as capacidades do Claude com conhecimento especializado para tarefas como criar documentos, analisar dados e processar arquivos. A Anthropic fornece as seguintes Agent Skills pré-construídas na API:
Primeiro, verifique quais Skills estão disponíveis. Use a API de Skills para listar todas as Skills gerenciadas pela Anthropic. Cada aba de linguagem é um trecho de um script contínuo, com quaisquer imports e configuração do cliente no topo:
# Listar Skills gerenciadas pela Anthropic
ant beta:skills list --source anthropicVocê verá 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 determinar quais Skills estão disponíveis. Este é o primeiro nível de divulgação progressiva (progressive disclosure), em que Claude descobre as Skills sem ainda carregar suas instruções completas.
Use a Skill do PowerPoint para criar uma apresentação sobre energia renovável. Especifique as Skills usando o parâmetro container na API de Messages:
# Cria uma mensagem com a Skill de PowerPoint
response = client.beta.messages.create(
model="claude-opus-5",
max_tokens=16000,
betas=["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_20260521", "name": "code_execution"}],
)
print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")A solicitação inclui as seguintes partes:
model: Um modelo que suporta a ferramenta de execução de códigocontainer.skills: Especifica quais Skills Claude pode usartype: "anthropic": Indica que esta é uma Skill gerenciada pela Anthropicskill_id: "pptx": O identificador da Skill do PowerPointversion: "latest": A versão da Skill definida como a mais recentemente publicadatools: Habilita a execução de código (obrigatório para Skills)skills-2025-10-02Quando você faz essa solicitação, Claude automaticamente associa 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. Em seguida, Claude executa o código da Skill para criar sua apresentação.
A apresentação foi criada no contêiner de execução de código e salva como um arquivo. A response do Passo 2 inclui uma referência de arquivo com um ID de arquivo. Extraia o ID do arquivo e baixe o arquivo com a API de Files. O exemplo o salva no diretório temporário do seu sistema:
# Extrai o ID do arquivo. A ferramenta de execução de código roda o código da Skill
# por meio de sua subferramenta Bash, e os arquivos gerados aparecem como itens
# bash_code_execution_output dentro do bloco bash_code_execution_tool_result.
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:
# Baixa o arquivo e o salva
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}")Experimente estas variações:
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"}],
)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"}],
)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"}],
)Aprenda como escrever Skills eficazes que Claude pode descobrir e usar com sucesso.
Aprenda como usar Agent Skills para estender as capacidades do Claude por meio da API.
Envie suas próprias Skills para tarefas especializadas.
Saiba mais sobre Skills no Claude Code.
Explore exemplos de Skills e padrões de implementação.
Was this page helpful?