> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent prompt'larını düzenleme ve revizyonlar

> Bir agent'ın prompt'unu düzenlemeyi, araçlarını görmeyi, revizyon geçmişini, eski sürüme dönmeyi ve kararlı sürümü işaretlemeyi anlatır.

Her agent, AI asistanın o konudaki davranışını belirleyen bir prompt ile çalışır. Bu sayfada bir agent'ın prompt'unu nasıl düzenleyeceğinizi, değişiklik geçmişini nasıl inceleyeceğinizi ve eski bir sürüme nasıl döneceğinizi öğrenirsiniz. Agent'lara genel bakış için [Agentlar](/panel/sistem/agentlar) sayfasına bakın.

Ekran **Sistem Ayarları → Agentlar** menüsündedir. Gereken izinler (rol editöründe **Agent Prompt'ları** grubu altında):

| İzin | Ne yapmanızı sağlar |
| - | - |
| **Görüntüle** | **Agentlar** sayfasını, **AI Araçları** penceresini ve revizyonları görmek |
| **Oluştur** | **Yeni Agent** ile prompt oluşturmak |
| **Güncelle** | Prompt'u düzenlemek, eski sürümü geri yüklemek |
| **Sil** | Prompt'u silmek |
| **Versiyonu Stabil Olarak İşaretle** | Bir revizyonu kararlı sürüm olarak işaretlemek |

İzinleri rollere nasıl vereceğinizi [Roller](/panel/sistem/roller) sayfasında bulabilirsiniz.

## Prompt düzenleme

<Steps>
  <Step title="Agent'ı açın">
    **Sistem Ayarları → Agentlar** sayfasında **Akış** görünümünde düzenlemek istediğiniz agent'ın kartına tıklayın. **Liste** görünümünü kullanıyorsanız satıra tıklayın ya da satır menüsünden **Düzenle**'yi seçin. Sayfa **{Tip} Agentını Düzenle** başlığıyla açılır (örneğin **Destek Agentını Düzenle**).
  </Step>

  <Step title="Prompt metnini değiştirin">
    **Prompt Metni** alanı bir Markdown editörüdür. Araç çubuğundan kalın, italik, başlık, liste, tablo gibi biçimlendirmeleri ekleyebilir, **Önizle** ile sonucu görebilir, **Tam Ekran** ile geniş alanda çalışabilirsiniz. Metin Markdown olarak saklanır.
  </Step>

  <Step title="Gerekirse ayarları değiştirin">
    **Dil**, **LLM Modeli** ve **Aktif** alanlarını güncelleyin (aşağıdaki tabloya bakın).
  </Step>

  <Step title="Kaydedin">
    **Agent Güncelle**'ye tıklayın. **Agentlar** sayfasına dönersiniz.
  </Step>
</Steps>

Sayfanın üstündeki **Araçlar** düğmesi araç listesini, **Revizyonlar** düğmesi geçmişi açar, **Sil** prompt'u siler.

<Warning>
  Değişiklik yaptıktan sonra kaydetmeden sayfadan ayrılırsanız, **Vazgeç**'e tıklarsanız ya da sayfayı yenilerseniz **Kaydedilmemiş Değişiklikler** penceresi açılır: "Değişiklikleriniz kaydedilmedi. Kaydetmeden ayrılmak istiyor musunuz?" Değişiklikleri atmak için **Kaydetmeden Ayrıl**'ı seçin. Tarayıcı sekmesini kapatırsanız tarayıcının kendi uyarısını görürsünüz.
</Warning>

### Form alanları

| Alan | Zorunlu | Açıklama |
| - | - | - |
| **Agent Tipi** | Evet | Karşılama, Randevu, Bilgi, Destek, Yönlendirici gibi agent türü. Akıştan açtıysanız önceden seçilidir. |
| **Dil** | Evet | **Türkçe** veya **İngilizce**. Varsayılan **Türkçe**. Aynı agent tipi ve dil için yalnızca bir prompt aktif olabilir. |
| **LLM Modeli** | Hayır | Agent'ın kullanacağı model. Boş bırakırsanız **Sistem varsayılanı** kullanılır. Listede **Model ara...** ile arama yapabilirsiniz. |
| **Aktif** | — | Prompt'un kullanılıp kullanılmayacağını belirler. Yeni prompt'ta varsayılan olarak açıktır. |
| **Prompt Metni** | Evet | Agent'ın talimat metni. |

<Info>
  Aktif bir prompt'u kaydettiğinizde, aynı tip ve dildeki diğer aktif prompt otomatik olarak pasife alınır. Bir agent'ın aktif prompt'u yoksa AI asistan o konuda yönlendirme yapamaz. Örneğin **Randevu** prompt'unu pasife alırsanız AI asistan randevu oluşturamaz.
</Info>

## Yeni agent prompt'u oluşturma

**Akış** görünümünde **Yapılandırılmamış** bir agent kartına tıklarsanız ya da **Yeni Agent**'e basarsanız prompt oluşturma sayfası açılır.

<Steps>
  <Step title="Sayfayı açın">
    Karta tıkladıysanız **Agent Tipi** önceden seçilidir. **Yeni Agent** ile açtıysanız tipi kendiniz seçin.
  </Step>

  <Step title="Alanları doldurun">
    **Prompt Metni**'ni yazın. **Dil** varsayılan olarak **Türkçe**, **Aktif** varsayılan olarak açıktır.
  </Step>

  <Step title="Oluşturun">
    **Agent Oluştur**'a tıklayın.
  </Step>
</Steps>

Kliniğinizin mevcut akış modunda kullanılamayan bir agent tipini aktif olarak kaydetmeye çalışırsanız şu hatayı görürsünüz: "Bu agent tipi kliniğin mevcut akış modunda aktifleştirilemez. Agentı pasif olarak kaydedin." Bu durumda **Aktif** anahtarını kapatıp yeniden kaydedin. Örneğin **Ön Kayıt** agent'ı yalnızca ön kayıt modunda, **Randevu** agent'ı yalnızca standart modda kullanılabilir. Modu [sohbet ayarlarından](/panel/sistem/ayarlar/sohbet) değiştirebilirsiniz.

<Tip>
  Prompt içinde kliniğin adını elle yazmayın. `{{clinic_name}}` ifadesini kullanın; AI asistan çalışırken bu ifade kliniğinizin adıyla değiştirilir.
</Tip>

## Araçlar

Agent'lar mesajlara yanıt verirken belirli araçları kullanabilir. Hangi araçların olduğunu görmek için düzenleme veya oluşturma sayfasındaki **Araçlar** düğmesine tıklayın. **AI Araçları** penceresi açılır.

* **Araç ara...** kutusuyla araçları ada veya açıklamaya göre filtreleyebilirsiniz.
* Her satırda araç adı ve açıklaması bulunur. Bazı araçların açıklaması boş görünebilir.
* Araç adının yanındaki kopyala düğmesi adı panoya alır. Prompt içinde bir araca adıyla başvurmak için bu adı prompt metnine yapıştırın.

Bu pencere yalnızca listeler. Buradan araç ekleyemez, kaldıramaz veya çalıştıramazsınız.

## Revizyonlar

Prompt metnini her değiştirdiğinizde yeni bir revizyon kaydedilir. Yalnızca metin değişiklikleri revizyon oluşturur; **Dil**, **LLM Modeli** veya **Aktif** değişikliği oluşturmaz.

Revizyon geçmişini açmak için düzenleme sayfasında **Revizyonlar**'a tıklayın ya da **Liste** görünümünde satır menüsünden **Revizyonlar**'ı seçin. Sayfa **{Tip} Agentı — Revizyonlar** başlığıyla açılır.

| Bölüm | İçerik |
| - | - |
| **Sürümler** (sol liste) | Her sürümün tarihi ve saati, kaydeden kişinin adı (bilinmiyorsa **Bilinmeyen kullanıcı**). **Güncel** rozeti en son sürümü, **Stabil** rozeti kararlı sürümü gösterir. Daha eski sürümler için **Daha Fazla Göster**'e tıklayın. |
| **Değişiklikler** sekmesi | Seçili sürümün bir önceki sürümden farkı. Eklenen ve silinen satırlar sayılarıyla (**+N satır eklendi**, **-N satır silindi**) gösterilir. İlk sürümde karşılaştırılacak önceki sürüm olmadığı için fark görünmez. |
| **İçerik** sekmesi | Seçili sürümün metninin tamamı. |

Sayfanın altındaki **Önceki Sürüm** ve **Sonraki Sürüm** düğmeleriyle sürümler arasında gezinirsiniz. Başlıktaki **Agentı Düzenle** düğmesi düzenleme sayfasına döner.

## Eski sürüme dönme

<Steps>
  <Step title="Sürümü seçin">
    **Revizyonlar** sayfasında **Sürümler** listesinden dönmek istediğiniz sürümü seçin. **Değişiklikler** ve **İçerik** sekmeleriyle doğru sürüm olduğunu kontrol edin.
  </Step>

  <Step title="Geri yükleyin">
    **Bu Sürümü Geri Yükle**'ye tıklayın. Bu düğme yalnızca güncel olmayan sürümlerde görünür ve **Güncelle** izni gerektirir.
  </Step>

  <Step title="Onaylayın">
    **Sürümü Geri Yükle** penceresinde **Geri Yükle**'ye tıklayın. "Sürüm geri yüklendi" bildirimini görürsünüz.
  </Step>
</Steps>

<Note>
  Geri yükleme hiçbir şeyi silmez. Eski sürümün metni yeni bir revizyon olarak kaydedilir ve **Güncel** rozetini alır. Aradaki sürümler geçmişte durmaya devam eder.
</Note>

## Kararlı sürüm

Güvenle geri dönebileceğiniz bir sürümü **Stabil** olarak işaretleyebilirsiniz. Her agent prompt'unda aynı anda en fazla bir kararlı sürüm bulunur.

<Steps>
  <Step title="Sürümü seçin">
    **Revizyonlar** sayfasında işaretlemek istediğiniz sürümü seçin.
  </Step>

  <Step title="İşaretleyin">
    **Stabil Olarak İşaretle**'ye tıklayın. Bu işlem **Versiyonu Stabil Olarak İşaretle** izni gerektirir.
  </Step>

  <Step title="Onaylayın">
    Pencerede **Stabil Yap**'a tıklayın. "Sürüm stabil olarak işaretlendi" bildirimini görürsünüz.
  </Step>
</Steps>

Başka bir sürümü işaretlerseniz önceki kararlı sürümün işareti kalkar. İşareti kaldırmak için aynı sürümde **Stabil İşaretini Kaldır**'a, ardından **İşareti Kaldır**'a tıklayın.

<Warning>
  **Stabil** işareti yalnızca bir hatırlatmadır. AI asistanın hangi metni kullandığını değiştirmez; asistan her zaman aktif prompt'un güncel metnini kullanır. Kararlı sürüme dönmek için sürümü ayrıca geri yüklemeniz gerekir.
</Warning>

## Kurallar

* Aynı agent tipi ve dil için yalnızca bir prompt aktif olabilir. Yeni bir prompt'u aktif kaydettiğinizde önceki aktif prompt pasife alınır.
* Bir agent'ın aktif prompt'u yoksa AI asistan o agent'ı kullanamaz; konuşma kliniğinizin akış modundaki varsayılan agent'a düşer.
* Kliniğinizin akış modunda kullanılamayan bir agent tipi aktif kaydedilemez; pasif olarak kaydedebilirsiniz. Aktif olan bir prompt'u her zaman pasife alabilirsiniz.
* Dil olarak yalnızca **Türkçe** ve **İngilizce** seçilebilir.
* Kod tarafındaki güvenlik kuralları (randevu sınırları, boş saat doğrulaması gibi) prompt ile değiştirilemez.
* Prompt'u sildiğinizde **Geri Dönüşüm Kutusu**'ndan geri getiremezsiniz. Silmeden önce metni başka bir yere kopyalayın.
* Flextell varsayılan prompt'ları güncellediğinde kliniğinizin aktif prompt'u yeni metinle değişebilir. Önceki metin **Revizyonlar**'da durur ve geri yüklenebilir.

## İlgili sayfalar

<CardGroup cols={2}>
  <Card title="Agentlar" icon="workflow" href="/panel/sistem/agentlar">
    Akış ve liste görünümleri, agent türleri.
  </Card>

  <Card title="AI asistan" icon="bot" href="/panel/sohbetler/ai-asistan">
    AI asistanın sohbetlerde nasıl çalıştığı.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.