Claude Platform Docs
PesanSkills

Memulai dengan Agent Skills di API

Pelajari cara menggunakan Agent Skills untuk membuat dokumen dengan Claude API dalam waktu kurang dari 10 menit.

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.

Sebelum Anda memulai

Anda memerlukan SDK klien untuk bahasa Anda, atau curl dan jq, serta pemahaman dasar tentang cara membuat permintaan API.

  1. Buat akun Claude Console

    Daftar untuk akun Claude Console, atau masuk ke akun yang sudah Anda miliki.

  2. Pilih cara autentikasi

    Masuk dengan CLI direkomendasikan untuk pengembangan lokal.

    CLIKunci API
  1. Instal CLI

    brew install anthropics/tap/ant
  2. Masuk

    ant auth login

    Setelah login selesai, SDK dan CLI akan mengambil kredensial Anda secara otomatis.

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 menampilkan daftar semua Skills yang dikelola Anthropic. Contoh ini adalah kutipan dari satu skrip berkelanjutan, dengan semua impor dan penyiapan klien di bagian atas:

# Daftar Skill yang dikelola Anthropic
skills = client.skills.list(source="anthropic")

for skill in skills.data:
    print(f"{skill.id}: {skill.display_name}")

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

Pelajari cara menulis Skills yang efektif yang dapat ditemukan dan digunakan Claude dengan sukses.

Pelajari cara menggunakan Agent Skills untuk memperluas kemampuan Claude melalui API.

Unggah Skills Anda sendiri untuk tugas-tugas khusus.

Pelajari tentang Skills di Claude Code.

Jelajahi contoh Skills dan pola implementasi.

Apakah halaman ini membantu?