Skip to main content

Yükle

Desteklenen: pydantic-ai-slim 2.0 ila 3.0. 2.0, Agent(instrument=...) özelliğini kaldırmış ve bu adaptörün üzerine inşa edildiği yetenek protokolünü tanıtmıştır, bu nedenle 1.x bu şekilde enstrüman edilemez.

Enstrüman Edin

instrument() herhangi bir Agent oluşturmadan önce çalışmalıdır. Yetenek, oluşturma sırasında eklenir, bu nedenle daha önce oluşturulmuş bir aracı hiçbir şey kaydetmez ve hiçbir hata olmadığı için hata vermez. Bu, bu adaptörle boş bir izlemenin en yaygın nedenidir.
Modül kapsamındaki aracılar bunun sorun olduğu yerdir:
Başarılı olduğunu doğrulayın:
Pydantic AI, geçtiğiniz listeyi tek bir root_capability olarak birleştirir, bu nedenle okumanız için agent.capabilities özniteliği yoktur. Enstrüman edilirken oluşturulan Aracılar yeteneği tutar, bu nedenle onları yeniden oluşturmadan uninstrument() yapabilir ve yeniden enstrüman edebilirsiniz.

Kaydedilenleri

Burada hook çifti ve insan-döngü çifti yoktur. Pydantic AI’ın köşeli parantez koymak için düğüm veya adım sınırı yoktur ve yerleşik insan duraklaması yoktur, bu nedenle eşleştirilecek hiçbir şey yoktur. İkisini de oluşturursanız, olayları kendiniz yayın — Özel aracılar bölümüne bakın. output_type, izlemeyi etkilemez. Yazılı bir çalışma ve bir dize çalışması aynı olayları üretir.

Örnek

İzlemede, restock_eta bir hata taşıyan tool_result olarak görünür, ardından modelin bunu geçiştiği başka bir model çağrısı gelir ve çalışma yine de success ile biter. Her iki gerçek de kaydedilir.

Hatalar, yeniden denemeler ve kontrol akışı

Pydantic AI üç farklı şey için istisna atar ve adaptör bunları ayırır: ModelRetry kasıtlı olarak ilk grupta yer almaktadır. Bu, bir denemesi gerçekten başarısız olduğu ve modelin yeniden denemeyi yapması istendiği anlamına gelir; bu, bir araç aralığının hata alanı için kullanılacak şeydir. Bunu kontrol akışı olarak sınıflandırmak, gerçek araç hatalarını yeşil bir çalışmanın arkasına gizlerdi.

Aralıklarınızı adlandırın

Pydantic AI’ın kendi çalışma aralığı agent olarak adlandırılır. Çağrıyı seçtiğiniz bir etiketle vermek için sarın:
Çerçevenin aralığı, inventory altında yuvalanır ve model ile araç olayları buraya bağlanır. agent_id düşük kardinalite tutun. Her pano yüzeyinde birincil cephe olduğu için, bir rol adı kullanın, asla bir UUID veya çalışma başına dize kullanmayın.

Oturumu Kontrol Edin

Bu sırayla çözülür, ilk eşleşme kazanır:
  1. instrument("pydantic_ai", session_id=...)
  2. Çevreleyen failproofai_sdk.session() kapsamı
  3. Çalışmanın conversation_id, ardından run_id
  4. Oluşturulan bir uuid4().hex

Seçenekler

Yaygın Sorunlar

Agent instrument() çalıştırılmadan önce oluşturuldu. Yukarıdaki uyarıya bakın ve agent.root_capability.capabilities öğesini kontrol edin.
Bare raise yayılır; bu Pydantic AI’ın tasarımıdır. Modelin bunu geçişitmesine izin vermek için, üzerine hareket edebileceği bir iletiyle ModelRetry yükseltin. Hata her iki şekilde de kaydedilir.
O çocuk Pydantic AI’ın kendi çalışma aralığı ve model ile araç olaylarının bulunduğu yerdir. Tek bir aralık istiyorsanız kendi kapsamınızı bırakın, özel ad maliyetine katlanın.
Pydantic AI’ın async grafik yığını, yük alanı sınırından daha uzundur ve yığın izinin son satırı özel olarak hata kendisidir. Bu alan, arkasından ziyade ön tarafından kırpılır, bu nedenle ihtiyacınız olan satır hayatta kalır.

Sonraki

Nasıl Çalışır

Çiftler, kimlikler, oturum yaşam döngüsü ve teslim.

İzleme Oku

Yeni yakaladığınız oturum aracılığıyla nedenselliği izleyin.

Diğer Çerçeveler

LangGraph, CrewAI, LlamaIndex ve özel aracılar.