Pengaturan awal

Dalam contoh ini, kita akan meminta Claude untuk menulis fungsi Python yang memeriksa apakah sebuah string adalah palindrom.

​

Prasyarat

Yang Anda butuhkan:

• Akun Console Anthropic
• Kunci API
• Python 3.7+ atau TypeScript 4.5+

Anthropic menyediakan SDK Python dan TypeScript, meskipun Anda dapat membuat permintaan HTTP langsung ke API.

​

Mulai dengan Workbench

Setiap panggilan API yang Anda buat—terlepas dari tugas spesifiknya—mengirimkan prompt yang dikonfigurasi dengan baik ke API Anthropic. Saat Anda belajar untuk memaksimalkan Claude, kami sarankan Anda memulai proses pengembangan di Workbench, antarmuka berbasis web untuk Claude.

Masuk ke Anthropic Console dan klik Workbench.

Di bagian tengah, di bawah User, mari kita ajukan pertanyaan kepada Claude.

Mengapa laut asin?

Klik Run. Di sisi kanan, Anda akan melihat output seperti

Laut asin karena beberapa faktor:

1. Pelapukan batuan: Selama jutaan tahun, hujan, sungai, dan aliran air telah mengikis batuan yang mengandung garam mineral. Garam ini terbawa ke laut oleh limpasan air.
2. Aktivitas vulkanik: Gunung berapi bawah laut dan ventilasi hidrotermal melepaskan mineral, termasuk garam, ke dalam air laut.
3. Deposisi atmosfer: Partikel garam dari semprotan laut dapat dibawa oleh angin dan diendapkan kembali ke laut.
4. Penguapan: Saat air menguap dari permukaan laut, ia meninggalkan garam terlarut, meningkatkan konsentrasi garam dalam air yang tersisa.
5. Proses biologis: Beberapa organisme laut berkontribusi pada kadar garam laut dengan melepaskan senyawa garam sebagai hasil sampingan dari metabolisme mereka.

Seiring waktu, proses-proses ini terus menambahkan garam ke laut, sementara penguapan menghilangkan air murni, menyebabkan tingkat salinitas laut saat ini. Penting untuk dicatat bahwa jumlah total garam di laut tetap relatif stabil karena masuknya garam seimbang dengan hilangnya garam melalui proses seperti pembentukan endapan evaporit.

Ini adalah jawaban yang bagus, tapi misalkan kita ingin mengontrol jenis jawaban yang tepat yang diberikan Claude. Misalnya, hanya mengizinkan Claude merespons pertanyaan dengan puisi. Kita dapat mengontrol format, nada, dan kepribadian respons dengan menambahkan System Prompt.

Anda adalah penyair kelas dunia. Respons hanya dengan puisi pendek.

Klik Run lagi.

Air laut yang asin,
Kisah waktu dan unsur berpadu.
Batuan dan hujan, erosi perlahan,
Mineral terlarut dalam larutan.
Zaman berlalu, garam tetap ada,
Di alam perairan abadi yang luas.

Lihat bagaimana respons Claude telah berubah? LLM merespons dengan baik terhadap instruksi yang jelas dan langsung. Anda dapat menempatkan instruksi peran baik dalam system prompt atau pesan pengguna. Kami sarankan untuk menguji untuk melihat cara mana yang memberikan hasil terbaik untuk kasus penggunaan Anda.

Setelah Anda menyesuaikan input sehingga Anda puas dengan output—dan memiliki pemahaman yang baik tentang cara menggunakan Claude—ubah Workbench Anda menjadi integrasi.

​

Instal SDK

Anthropic menyediakan SDK untuk Python (3.7+) dan TypeScript (4.5+).

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Atur kunci API Anda

Setiap panggilan API memerlukan kunci API yang valid. SDK dirancang untuk mengambil kunci API dari variabel lingkungan ANTHROPIC_API_KEY. Anda juga dapat menyediakan kunci ke klien Anthropic saat menginisialisasinya.

• macOS and Linux
• Windows

export ANTHROPIC_API_KEY='your-api-key-here'

​

Panggil API

Panggil API dengan meneruskan parameter yang tepat ke endpoint /messages/create.

Perhatikan bahwa kode yang disediakan oleh Workbench mengatur kunci API dalam konstruktor. Jika Anda mengatur kunci API sebagai variabel lingkungan, Anda dapat menghilangkan baris tersebut seperti di bawah ini.

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="Anda adalah penyair kelas dunia. Respons hanya dengan puisi pendek.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Mengapa laut asin?"
                }
            ]
        }
    ]
)
print(message.content)

Jalankan kode menggunakan python3 claude_quickstart.py atau node claude_quickstart.js.

[TextBlock(text="Air laut yang asin,\nKisah waktu dan rancangan.\nBatuan dan sungai, mineralnya terlepas,\nTerakumulasi di dasar lautan.\nPenguapan meninggalkan garam di belakang,\nDi perairan luas, selamanya tersimpan.", type='text')]

Quickstart ini menunjukkan cara mengembangkan aplikasi bertenaga Claude yang dasar, namun fungsional menggunakan Console, Workbench, dan API. Anda dapat menggunakan alur kerja yang sama ini sebagai fondasi untuk kasus penggunaan yang jauh lebih kuat.

​

Langkah selanjutnya

Sekarang setelah Anda membuat permintaan API Anthropic pertama Anda, saatnya untuk mengeksplorasi apa lagi yang mungkin: