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:

# List Anthropic-managed Skills
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:

# Create a message with the PowerPoint Skill
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:

# Extract file ID from the code-execution tool result. The Skill might run
# its work through either the Python or bash code-execution tool, so check
# both result types.
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:
    # 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 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:

# List Anthropic-managed Skills
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:

# Create a message with the PowerPoint Skill
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

# Extract file ID from the code-execution tool result. The Skill might run
# its work through either the Python or bash code-execution tool, so check
# both result types.
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:
    # 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 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?