Müfredat 250 dersinden 115. · Gerçek bir LLM Çağırma
Gerçek bir LLM Çağırma

Messages Payload'u Oluştur

Bir chat modeline yapılan her çağrı, JSON gövdesi taşıyan bir HTTP isteğidir ve bu gövdeyi doğru oluşturmak gerçek kodun yaptığı ilk şeydir. Bu modül boyunca Anthropic API'sinin tükettiği ve döndürdüğü sözlükleri ve listeleri, elinle, düz Python ile oluşturacaksın -> böylece her şey çevrimdışı çalışacak ve notlandırılabilecek. Her ders ayrıca kendi makinenizde bir API anahtarı ile çalıştıracağınız o tek gerçek satırı da gösterir. Burada oluşturduğun yapılar, kablo üzerinden geçen yapılardır.

SDK yüklendiğinde, bir mesaj göndermek şuna benzer (sadece örnektir -> burada ağı çağırmıyoruz):

import anthropic
client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="You are a terse assistant.",
    messages=[{"role": "user", "content": "Hello"}],
)

Şekle dikkat et: system kendi üst düzey alanıdır (bir mesaj DEĞİLDİR) ve messages her biri bir role ve content içeren birer sözlükten oluşan hamleler listesidir. messages içindeki tek geçerli roller "user" ve "assistant"'dir, bunlar bir konuşma gibi sırayla gider. Yaygın bir hata, bazı diğer API'lerin yaptığı gibi messages başında bir {"role": "system", ...} hamlesine talimatları koymaktır. Anthropic API ilk mesaj olarak bir sistem hamlesini reddeder: sistem isteminin kendi üst düzey yuvası vardır. (Son Claude modelleri, yolun ortasında gelen bir talimat için konuşmanın ilerleyen kısımlarında bir sistem mesajını kabul eder, ancak bu gelişmiş bir özelliktir; bu kurs her zaman üst düzey yuvasını kullanır, bu yüzden build_request her türlü sistem hamlesini reddeder.)

build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) inşa ediyorsun. İstek sözlüğünü döndürüyor:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • model ve max_tokens değerlerini olduğu gibi kopyala ve system değerini kendi anahtarına koy.
  • messages içindeki her dönüş için, rolün tam olarak "user" veya "assistant" olduğunu doğrula. Başka herhangi bir şey (bir "system" dönüşü, "User" gibi bir yazım hatası veya eksik rol) ValueError hatası vermelidir -> API'ye ulaşmadan ve bir tur boşa harcamadan önce açıkça hata ver.
  • messages içindeki turları değiştirmeden döndür (aynı sıra, aynı içerik).

İşte az önce oluşturduğun dict ile yapacağın gerçek çağrı; **, dict içeriğini keyword arguments olarak açar:

resp = client.messages.create(**build_request("Be brief.", history))

İki farklı (system, messages) çiftinin iki farklı request dict üretmesini sağla ve user veya assistant dışındaki bir role içeren bir turn hata fırlatsın.

Senin sıran

Anthropic-shape request dict {"model", "max_tokens", "system", "messages"} döndüren build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) yaz. messages bir {"role", "content"} turn listesidir. Her role değerinin tam olarak "user" veya "assistant" olduğunu doğrula ve başka bir şeyde (gizlenmiş bir "system" turn dahil) ValueError fırlat. Turnleri değiştirmeden döndür.

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.