Memulai dengan Agent Skills di API

Tutorial ini menunjukkan kepada Anda cara menggunakan Agent Skills untuk membuat presentasi PowerPoint. Anda akan mempelajari cara mengaktifkan Skills, membuat permintaan, dan mengakses file yang dihasilkan.

Prasyarat

• Sebuah kunci API Claude atau ant CLI yang sudah login
• Sebuah SDK klien untuk bahasa Anda, atau curl dan jq
• Pemahaman dasar tentang cara membuat permintaan API

Ikhtisar Agent Skills

Agent Skills bawaan memperluas kemampuan Claude dengan keahlian khusus untuk tugas-tugas seperti membuat dokumen, menganalisis data, dan memproses file. Anthropic menyediakan Agent Skills bawaan berikut di API:

• PowerPoint (pptx): Membuat dan mengedit presentasi
• Excel (xlsx): Membuat dan menganalisis spreadsheet
• Word (docx): Membuat dan mengedit dokumen
• PDF (pdf): Menghasilkan dokumen PDF

Langkah 1: Daftar Skills yang tersedia

Pertama, periksa Skills apa saja yang tersedia. Gunakan Skills API untuk mendaftar semua Skills yang dikelola Anthropic. Setiap tab bahasa merupakan kutipan dari satu skrip yang berkesinambungan, dengan semua import dan penyiapan klien di bagian atas:

# Daftar Skill yang dikelola Anthropic
ant skills list --source anthropic

Anda akan melihat Skills berikut: pptx, xlsx, docx, dan pdf.

API ini mengembalikan metadata setiap Skill: nama dan deskripsinya. Claude memuat metadata ini saat startup untuk menentukan Skills mana yang tersedia. Ini adalah tingkat pertama dari "progressive disclosure" (pengungkapan bertahap), di mana Claude menemukan Skills tanpa memuat instruksi lengkapnya terlebih dahulu.

Langkah 2: Buat presentasi

Gunakan Skill PowerPoint untuk membuat presentasi tentang energi terbarukan. Tentukan Skills menggunakan parameter container di Messages API:

# Buat pesan dengan Skill PowerPoint
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    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)}")

Permintaan ini mencakup bagian-bagian berikut:

• model: Sebuah model yang mendukung alat eksekusi kode
• container.skills: Menentukan Skills mana yang dapat digunakan Claude
• type: "anthropic": Menunjukkan bahwa ini adalah Skill yang dikelola Anthropic
• skill_id: "pptx": Pengidentifikasi Skill PowerPoint
• version: "latest": Versi Skill yang diatur ke versi terbaru yang dipublikasikan
• tools: Mengaktifkan eksekusi kode (diperlukan untuk Skills)

Saat Anda membuat permintaan ini, Claude secara otomatis mencocokkan tugas Anda dengan Skill yang relevan. Karena Anda meminta presentasi, Claude menentukan bahwa Skill PowerPoint relevan dan memuat instruksi lengkapnya: tingkat kedua dari pengungkapan bertahap. Kemudian Claude menjalankan kode Skill tersebut untuk membuat presentasi Anda.

Langkah 3: Unduh file yang dibuat

Presentasi dibuat di dalam container eksekusi kode dan disimpan sebagai file. response dari Langkah 2 menyertakan referensi file dengan ID file. Ekstrak ID file tersebut dan unduh file dengan Files API. Contoh ini menyimpannya ke direktori temp sistem Anda:

# Ekstrak ID file. Alat eksekusi kode menjalankan kode Skill melalui
# sub-alat Bash-nya, dan file yang dihasilkan muncul sebagai bash_code_execution_output
# di dalam blok 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:
    # Unduh file dan simpan
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Coba contoh lainnya

Coba variasi berikut:

Buat spreadsheet

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

Buat dokumen Word

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

Hasilkan PDF

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

Langkah selanjutnya