# Sorun Giderme

> Yaygın PentAGI sorunlarına yönelik düzeltmeler — ilk model çağrısında başarısız olan bir flow, tool-call parser hataları, macOS yükleyici uyarıları ve takılı kalan küçük modeller.

Bir bağlantının her iki tarafının da günlük kayıtlarıyla başlayın: PentAGI için `docker compose logs -f pentagi` ve model arka ucunuzun veya vekil sunucunuzun günlük kayıtları.

## [Bir flow "failed to select primary docker image via llm call" hatasıyla başarısız oluyor](https://pentagi.com/tr/docs/deployment/troubleshooting/#a-flow-fails-with-failed-to-select-primary-docker-image-via-llm-call)

Bir [flow](https://pentagi.com/tr/docs/glossary/#flow)'un yaptığı ilk şey, `simple` [agent type](https://pentagi.com/tr/docs/glossary/#agent-type) aracılığıyla modelden bir Docker imajı seçmesini istemektir. Bu hata neredeyse her zaman Docker'ı değil, model arka ucunu işaret eder:

1. PentAGI günlüklerini ve model arka ucunuzun günlüklerini kontrol edin.
2. Temel URL'nin, API anahtarının ve model adının doğru olduğunu ve kapsayıcıdan erişilebilir olduğunu doğrulayın.
3. Bu çağrı hiçbir [tool](https://pentagi.com/tr/docs/glossary/#tool) göndermez, bu nedenle hata tool calling üzerinde değil; bağlantı, anahtar veya model üzerinde ortaya çıkar: `simple` [agent](https://pentagi.com/tr/docs/glossary/#agent)'ın modelinin düz bir sohbet isteğine yanıt verdiğini kontrol edin. Eksik bir tool-call parser, agent'lar tool çağırmaya başladığında daha sonra belirgin hale gelir.

## [Kendi kendine barındırılan modellerde tool-call parser hataları](https://pentagi.com/tr/docs/deployment/troubleshooting/#tool-call-parser-errors-with-self-hosted-models)

PentAGI agents'ı [tool calls](https://pentagi.com/tr/docs/glossary/#tool-call)'la çalıştırır; bu nedenle özel bir arka uç, geçerli OpenAI tarzı tool-call JSON'u döndürmelidir. Eksik veya uyumsuz bir parser'ın belirtileri arasında `Failed to parse tool call arguments as JSON`, birkaç adımdan sonra duran flows ve sonuca ulaşmadan döngüye giren tool calls yer alır.

* llama.cpp, SGLang veya vLLM'de sunduğunuz model için önerilen tool-call parser'ı ve chat template'i etkinleştirin.
* Tam bir flow çalıştırmadan önce [provider](https://pentagi.com/tr/docs/glossary/#provider)'ı `ctester` yardımcı programıyla doğrulayın.
* PentAGI'yi güncelleyin: son sürümler, hatalı biçimlendirilmiş argümanları düzeltir, böylece tek bir hatalı yanıt artık bir flow'u durdurmaz.

## [macOS yükleyiciyi işaretliyor](https://pentagi.com/tr/docs/deployment/troubleshooting/#macos-flags-the-installer)

macOS yapıları imzalanmış ve onaylanmıştır. macOS yükleyici hakkında hâlâ uyarı veriyorsa, **Yine de Aç** ile bunu geçersiz kılmayın: dosyayı silin ve işlemciniz için arşivi resmi bağlantılardan yeniden indirin — Intel için `darwin/amd64`, Apple silicon için `darwin/arm64`. Resmi olmayan bir kaynaktan gelen bir arşivi asla yeniden kullanmayın.

## [Daha küçük modeller takılıp kalıyor](https://pentagi.com/tr/docs/deployment/troubleshooting/#smaller-models-get-stuck)

[Yürütme izleme ve task planlamayı](https://pentagi.com/tr/docs/concepts/agents/#safeguards) etkinleştirin ve `adviser` agent'a daha güçlü bir model veya daha yüksek bir akıl yürütme ayarı verin.

## [Hâlâ takılı mı kaldınız?](https://pentagi.com/tr/docs/deployment/troubleshooting/#still-stuck)

[Discord](https://discord.gg/2xrMh7qX6m) topluluğunda sorun veya ilgili günlük satırlarıyla birlikte [bir sorun bildirin](https://github.com/vxcontrol/pentagi/issues).