Competenze

Iniziare con Agent Skills nell'API

Scopri come utilizzare Agent Skills per creare documenti con l'API Claude in meno di 10 minuti.

Questo tutorial ti mostra come utilizzare Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare Skills, fare una semplice richiesta e accedere al file generato.

Prerequisiti

Chiave API Claude
Python 3.7+ o curl installato
Familiarità di base con le richieste API

Panoramica di Agent Skills

Le Agent Skills pre-costruite estendono le capacità di Claude con competenze specializzate per attività come la creazione di documenti, l'analisi dei dati e l'elaborazione di file. Anthropic fornisce le seguenti Agent Skills pre-costruite nell'API:

PowerPoint (pptx): Crea e modifica presentazioni
Excel (xlsx): Crea e analizza fogli di calcolo
Word (docx): Crea e modifica documenti
PDF (pdf): Genera documenti PDF

Vuoi creare Skills personalizzate? Consulta il Agent Skills Cookbook per esempi di creazione delle tue Skills con competenze specifiche del dominio.

Passaggio 1: Elencare le Skills disponibili

Per prima cosa, controlla quali Skills sono disponibili. Utilizza l'API Skills per elencare tutte le Skills gestite da Anthropic:

ant beta:skills list --source anthropic

Vedrai le seguenti Skills: pptx, xlsx, docx e pdf.

Questa API restituisce i metadati di ogni Skill: il suo nome e la descrizione. Claude carica questi metadati all'avvio per sapere quali Skills sono disponibili. Questo è il primo livello di progressive disclosure, dove Claude scopre le Skills senza caricare ancora le loro istruzioni complete.

Passaggio 2: Creare una presentazione

Ora utilizza la Skill PowerPoint per creare una presentazione sull'energia rinnovabile. Specifica le Skills utilizzando il parametro container nell'API Messages:

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)

Analizziamo cosa fa ogni parte:

container.skills: Specifica quali Skills Claude può utilizzare
type: "anthropic": Indica che questa è una Skill gestita da Anthropic
skill_id: "pptx": L'identificatore della Skill PowerPoint
version: "latest": La versione della Skill impostata sulla più recente pubblicata
tools: Abilita l'esecuzione del codice (richiesta per le Skills)
Header beta: code-execution-2025-08-25 e skills-2025-10-02

Quando fai questa richiesta, Claude abbina automaticamente il tuo compito alla Skill rilevante. Poiché hai chiesto una presentazione, Claude determina che la Skill PowerPoint è rilevante e carica le sue istruzioni complete: il secondo livello di progressive disclosure. Quindi Claude esegue il codice della Skill per creare la tua presentazione.

Passaggio 3: Scaricare il file creato

La presentazione è stata creata nel contenitore di esecuzione del codice e salvata come file. La risposta include un riferimento al file con un ID file. Estrai l'ID file e scaricalo utilizzando l'API Files:

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

Per dettagli completi su come lavorare con i file generati, consulta la documentazione dello strumento di esecuzione del codice.

Prova altri esempi

Ora che hai creato il tuo primo documento con Skills, prova queste variazioni:

Creare un foglio di calcolo

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

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

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

Passaggi successivi

Ora che hai utilizzato le Agent Skills pre-costruite, puoi:

Guida API

Utilizza Skills con l'API Claude

Creare Skills personalizzate

Carica le tue Skills per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skills efficaci

Utilizza Skills in Claude Code

Scopri le Skills in Claude Code

Agent Skills Cookbook

Esplora le Skills di esempio e i modelli di implementazione

Was this page helpful?

Competenze

Iniziare con Agent Skills nell'API

Scopri come utilizzare Agent Skills per creare documenti con l'API Claude in meno di 10 minuti.

Questo tutorial ti mostra come utilizzare Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare Skills, fare una semplice richiesta e accedere al file generato.

Prerequisiti

Chiave API Claude
Python 3.7+ o curl installato
Familiarità di base con le richieste API

Panoramica di Agent Skills

PowerPoint (pptx): Crea e modifica presentazioni
Excel (xlsx): Crea e analizza fogli di calcolo
Word (docx): Crea e modifica documenti
PDF (pdf): Genera documenti PDF

Vuoi creare Skills personalizzate? Consulta il Agent Skills Cookbook per esempi di creazione delle tue Skills con competenze specifiche del dominio.

Passaggio 1: Elencare le Skills disponibili

Per prima cosa, controlla quali Skills sono disponibili. Utilizza l'API Skills per elencare tutte le Skills gestite da Anthropic:

ant beta:skills list --source anthropic

Vedrai le seguenti Skills: pptx, xlsx, docx e pdf.

Passaggio 2: Creare una presentazione

Ora utilizza la Skill PowerPoint per creare una presentazione sull'energia rinnovabile. Specifica le Skills utilizzando il parametro container nell'API Messages:

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)

Analizziamo cosa fa ogni parte:

container.skills: Specifica quali Skills Claude può utilizzare
type: "anthropic": Indica che questa è una Skill gestita da Anthropic
skill_id: "pptx": L'identificatore della Skill PowerPoint
version: "latest": La versione della Skill impostata sulla più recente pubblicata
tools: Abilita l'esecuzione del codice (richiesta per le Skills)
Header beta: code-execution-2025-08-25 e skills-2025-10-02

Passaggio 3: Scaricare il file creato

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

Per dettagli completi su come lavorare con i file generati, consulta la documentazione dello strumento di esecuzione del codice.

Prova altri esempi

Ora che hai creato il tuo primo documento con Skills, prova queste variazioni:

Creare un foglio di calcolo

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

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

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

Passaggi successivi

Ora che hai utilizzato le Agent Skills pre-costruite, puoi:

Guida API

Utilizza Skills con l'API Claude

Creare Skills personalizzate

Carica le tue Skills per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skills efficaci

Utilizza Skills in Claude Code

Scopri le Skills in Claude Code

Agent Skills Cookbook

Esplora le Skills di esempio e i modelli di implementazione

Was this page helpful?