MessaggiSkill

Inizia con gli Agent Skills nell'API

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

Questo tutorial mostra come utilizzare gli Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare gli Skill, effettuare una semplice richiesta 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 degli Agent Skills

Gli Agent Skills predefiniti 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 i seguenti Agent Skills predefiniti 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 Skill personalizzati? Consulta l'Agent Skills Cookbook per esempi su come costruire i tuoi Skill con competenze specifiche di dominio.

Passaggio 1: Elenca gli Skill disponibili

Per prima cosa, verifica quali Skill sono disponibili. Usa la Skills API per elencare tutti gli Skill gestiti da Anthropic:

# Elenca le Skill gestite da Anthropic
ant beta:skills list --source anthropic

Vedrai i seguenti Skill: 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 Skill sono disponibili. Questo è il primo livello di progressive disclosure (divulgazione progressiva), in cui Claude scopre gli Skill senza ancora caricare le loro istruzioni complete.

Passaggio 2: Crea una presentazione

Ora usa lo Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica gli Skill utilizzando il parametro container nella Messages API:

# Crea un messaggio con la Skill PowerPoint
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Analizziamo cosa fa ciascuna parte:

container.skills: Specifica quali Skill Claude può utilizzare
type: "anthropic": Indica che si tratta di uno Skill gestito da Anthropic
skill_id: "pptx": L'identificatore dello Skill PowerPoint
version: "latest": La versione dello Skill impostata sulla più recente pubblicata
tools: Abilita l'esecuzione di codice (obbligatoria per gli Skill)
Header beta: code-execution-2025-08-25 e skills-2025-10-02

Gli esempi qui utilizzano la versione dello strumento code_execution_20250825 con il corrispondente header beta code-execution-2025-08-25. Gli Skill funzionano anche con le revisioni più recenti dello strumento di esecuzione del codice (code_execution_20260120 e successive); qualsiasi versione dello strumento di esecuzione del codice soddisfa il requisito degli Skill. Qualunque versione utilizzi, mantieni il type dello strumento e l'header beta coerenti con la pagina dello strumento di esecuzione del codice, e includi sempre skills-2025-10-02.

Quando effettui questa richiesta, Claude associa automaticamente il tuo compito allo Skill pertinente. Poiché hai chiesto una presentazione, Claude determina che lo Skill PowerPoint è pertinente e carica le sue istruzioni complete: il secondo livello di divulgazione progressiva. Quindi Claude esegue il codice dello Skill per creare la tua presentazione.

Passaggio 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 file e scaricalo utilizzando la Files API:

# Estrai l'ID del file dal risultato dello strumento di esecuzione codice. La Skill potrebbe
# eseguire il lavoro tramite lo strumento di esecuzione codice Python o bash, quindi
# controlla entrambi i tipi di risultato.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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:
    # Scarica il file e salvalo
    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 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 gli Skill, prova queste varianti:

Crea un foglio di calcolo

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

Crea un documento Word

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

Genera un PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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 gli Agent Skills predefiniti, puoi:

Guida API

Usa gli Skill con l'API di Claude

Crea Skill personalizzati

Carica i tuoi Skill per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skill efficaci

Usa gli Skill in Claude Code

Scopri di più sugli Skill in Claude Code

Agent Skills Cookbook

Esplora Skill di esempio e pattern di implementazione

Was this page helpful?

MessaggiSkill

Inizia con gli Agent Skills nell'API

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

Questo tutorial mostra come utilizzare gli Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare gli Skill, effettuare una semplice richiesta 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 degli 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 Skill personalizzati? Consulta l'Agent Skills Cookbook per esempi su come costruire i tuoi Skill con competenze specifiche di dominio.

Passaggio 1: Elenca gli Skill disponibili

Per prima cosa, verifica quali Skill sono disponibili. Usa la Skills API per elencare tutti gli Skill gestiti da Anthropic:

# Elenca le Skill gestite da Anthropic
ant beta:skills list --source anthropic

Vedrai i seguenti Skill: pptx, xlsx, docx e pdf.

Passaggio 2: Crea una presentazione

Ora usa lo Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica gli Skill utilizzando il parametro container nella Messages API:

# Crea un messaggio con la Skill PowerPoint
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Analizziamo cosa fa ciascuna parte:

container.skills: Specifica quali Skill Claude può utilizzare
type: "anthropic": Indica che si tratta di uno Skill gestito da Anthropic
skill_id: "pptx": L'identificatore dello Skill PowerPoint
version: "latest": La versione dello Skill impostata sulla più recente pubblicata
tools: Abilita l'esecuzione di codice (obbligatoria per gli Skill)
Header beta: code-execution-2025-08-25 e skills-2025-10-02

Passaggio 3: Scarica il file creato

# Estrai l'ID del file dal risultato dello strumento di esecuzione codice. La Skill potrebbe
# eseguire il lavoro tramite lo strumento di esecuzione codice Python o bash, quindi
# controlla entrambi i tipi di risultato.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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:
    # Scarica il file e salvalo
    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 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 gli Skill, prova queste varianti:

Crea un foglio di calcolo

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

Crea un documento Word

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

Genera un PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    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 gli Agent Skills predefiniti, puoi:

Guida API

Usa gli Skill con l'API di Claude

Crea Skill personalizzati

Carica i tuoi Skill per attività specializzate

Guida alla creazione

Scopri le best practice per scrivere Skill efficaci

Usa gli Skill in Claude Code

Scopri di più sugli Skill in Claude Code

Agent Skills Cookbook

Esplora Skill di esempio e pattern di implementazione

Was this page helpful?

Prerequisiti

Panoramica degli Agent Skills

Passaggio 1: Elenca gli Skill disponibili

Passaggio 2: Crea una presentazione

Passaggio 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Passaggi successivi

Prerequisiti

Panoramica degli Agent Skills

Passaggio 1: Elenca gli Skill disponibili

Passaggio 2: Crea una presentazione

Passaggio 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Passaggi successivi

Prerequisiti

Panoramica degli Agent Skills

Passaggio 1: Elenca gli Skill disponibili

Passaggio 2: Crea una presentazione

Passaggio 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Passaggi successivi

Prerequisiti

Panoramica degli Agent Skills

Passaggio 1: Elenca gli Skill disponibili

Passaggio 2: Crea una presentazione

Passaggio 3: Scarica il file creato

Prova altri esempi

Crea un foglio di calcolo

Crea un documento Word

Genera un PDF

Passaggi successivi