MessagesSkill

Inizia a usare le Agent Skills nell'API

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

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

Prerequisiti

Chiave API di Claude
Python 3.7+ o curl installato
Familiarità di base con l'esecuzione di richieste API

Panoramica delle Agent Skills

Le Agent Skills predefinite estendono le capacità di Claude con competenze specializzate per attività come la creazione di documenti, l'analisi di dati e l'elaborazione di file. Anthropic fornisce le seguenti Agent Skills predefinite 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 l'Agent Skills Cookbook per esempi su come costruire le tue Skills con competenze specifiche di dominio.

Passo 1: Elenca le Skills disponibili

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

# List Anthropic-managed Skills
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 sua descrizione. Claude carica questi metadati all'avvio per sapere quali Skills sono disponibili. Questo è il primo livello di progressive disclosure (divulgazione progressiva), in cui Claude scopre le Skills senza caricarne ancora le istruzioni complete.

Passo 2: Crea una presentazione

Ora usa la Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica le Skills usando il parametro container nella Messages API:

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    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)}")

Analizziamo cosa fa ogni parte:

container.skills: Specifica quali Skills Claude può usare
type: "anthropic": Indica che si tratta di una Skill gestita da Anthropic
skill_id: "pptx": L'identificatore della Skill PowerPoint
version: "latest": La versione della Skill impostata su quella pubblicata più di recente
tools: Abilita l'esecuzione di codice (richiesta per le Skills)
Header beta: skills-2025-10-02

Gli esempi qui riportati usano la versione dello strumento code_execution_20260521, che è generalmente disponibile e non richiede alcun header beta per l'esecuzione di codice. Le Skills funzionano anche con versioni precedenti dello strumento di esecuzione del codice (come code_execution_20250825); qualsiasi versione dello strumento di esecuzione del codice soddisfa il requisito delle Skills. Qualunque versione tu usi, mantieni il suo type dello strumento e qualsiasi header beta coerenti con la pagina dello strumento di esecuzione del codice, e includi sempre skills-2025-10-02.

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

Passo 3: Scarica il file creato

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

# Extract the file ID. The code execution tool runs the Skill's code through
# its Bash sub-tool, and generated files appear as bash_code_execution_output
# items inside the bash_code_execution_tool_result block.
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:
    # Download the file and save it
    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}")

Per i 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 le Skills, prova queste varianti:

Crea un foglio di calcolo

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Crea un documento Word

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Genera un PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Prossimi passi

Ora che hai usato le Agent Skills predefinite, puoi:

Guida API

Usa le Skills con l'API di Claude

Crea Skills personalizzate

Carica le tue Skills per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skills efficaci

Usa le Skills in Claude Code

Scopri le Skills in Claude Code

Agent Skills Cookbook

Esplora esempi di Skills e pattern di implementazione

Was this page helpful?

MessagesSkill

Inizia a usare le Agent Skills nell'API

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

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

Prerequisiti

Chiave API di Claude
Python 3.7+ o curl installato
Familiarità di base con l'esecuzione di richieste API

Panoramica delle 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 l'Agent Skills Cookbook per esempi su come costruire le tue Skills con competenze specifiche di dominio.

Passo 1: Elenca le Skills disponibili

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

# List Anthropic-managed Skills
ant beta:skills list --source anthropic

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

Passo 2: Crea una presentazione

Ora usa la Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica le Skills usando il parametro container nella Messages API:

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    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)}")

Analizziamo cosa fa ogni parte:

container.skills: Specifica quali Skills Claude può usare
type: "anthropic": Indica che si tratta di una Skill gestita da Anthropic
skill_id: "pptx": L'identificatore della Skill PowerPoint
version: "latest": La versione della Skill impostata su quella pubblicata più di recente
tools: Abilita l'esecuzione di codice (richiesta per le Skills)
Header beta: skills-2025-10-02

Passo 3: Scarica il file creato

# Extract the file ID. The code execution tool runs the Skill's code through
# its Bash sub-tool, and generated files appear as bash_code_execution_output
# items inside the bash_code_execution_tool_result block.
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:
    # Download the file and save it
    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}")

Per i 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 le Skills, prova queste varianti:

Crea un foglio di calcolo

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Crea un documento Word

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Genera un PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Prossimi passi

Ora che hai usato le Agent Skills predefinite, puoi:

Guida API

Usa le Skills con l'API di Claude

Crea Skills personalizzate

Carica le tue Skills per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skills efficaci

Usa le Skills in Claude Code

Scopri le Skills in Claude Code

Agent Skills Cookbook

Esplora esempi di Skills e pattern di implementazione

Was this page helpful?

Prerequisiti

Panoramica delle Agent Skills

Passo 1: Elenca le Skills disponibili

Passo 2: Crea una presentazione

Passo 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Prossimi passi

Prerequisiti

Panoramica delle Agent Skills

Passo 1: Elenca le Skills disponibili

Passo 2: Crea una presentazione

Passo 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Prossimi passi

Prerequisiti

Panoramica delle Agent Skills

Passo 1: Elenca le Skills disponibili

Passo 2: Crea una presentazione

Passo 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Prossimi passi

Prerequisiti

Panoramica delle Agent Skills

Passo 1: Elenca le Skills disponibili

Passo 2: Crea una presentazione

Passo 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Prossimi passi