Upload folder using huggingface_hub

README.md

@@ -0,0 +1,162 @@
+# Pharmacy Prompt Serialization Format (PPSF) — Custom Jinja2 Chat Template
+
+Bu proje, bir dil modelinin (LLM) kullanıcı, sistem, asistan ve araç (tool calling) mesajlarını doğru ayırt edebilmesi ve **Pharmacy Prompt Serialization Format (PPSF v1.0 / v1.1)** spesifikasyonuna uygun şekilde serileştirmesi için geliştirilmiş bir **Custom Jinja2 Chat Template** uygulamasıdır.
+
+Hugging Face `transformers` kütüphanesinin `apply_chat_template()` fonksiyonu ile **%100 tam uyumlu** olarak çalışacak şekilde tasarlanmıştır.
+
+---
+
+## 🎯 Ödev Amacı ve Özellikler
+
+- **Hugging Face Standartlarına Tam Uyumluluk:** Standart `messages` dizisini (`role`, `content`, `tool_calls`) ve `tools` listesini kabul eder.
+- **Alan Spesifik Rol Tanımları (Pharmacy Protocol):**
+  - `system` $\rightarrow$ `@SYSTEM`
+  - `user` $\rightarrow$ `@PATIENT`
+  - `assistant` $\rightarrow$ `@PHARMACIST`
+  - `tool` $\rightarrow$ `@TOOL_RESPONSE`
+- **Tool Calling (Araç Çağrısı) Desteği:**
+  - Mevcut araç tanımlarını `@TOOLS` bloğu altında ilan eder.
+  - Asistanın araç çağırma isteklerini `@TOOL_CALL` formatında formatlar.
+  - Araç yanıtlarını `@TOOL_RESPONSE` olarak bağlama ekler.
+- **Geleceğe Uyumlu Metadata Desteği (PPSF v1.1):**
+  - Mesaj nesnesinde yer alan `metadata.reference` verilerini `@REFERENCE` bloğuna dönüştürür.
+  - Mesaj nesnesinde yer alan `metadata.thought` verilerini (Chain of Thought) `@THOUGHT` bloğuna dönüştürür.
+
+---
+
+## 📁 Proje Dosya Yapısı
+
+```
+Chat_Template/
+├── chat_template.jinja    # PPSF v1.0 / v1.1 Jinja2 şablon dosyası
+├── main.py                # Jinja2 ve Hugging Face AutoTokenizer test scripti
+└── README.md              # Proje dokümantasyonu
+```
+
+---
+
+## 🚀 Kurulum ve Çalıştırma
+
+### 1. Gereksinimler
+Projeyi çalıştırmak için Python 3.8+ ve aşağıdaki kütüphanelerin kurulu olması yeterlidir:
+
+```bash
+pip install jinja2 transformers
+```
+
+### 2. Test Scriptini Çalıştırma
+Tüm test senaryolarını (Standart sohbet, Tool Calling ve Metadata kullanımı) çalıştırmak için:
+
+```bash
+python main.py
+```
+
+---
+
+## 💻 Kullanım Örnekleri
+
+### Hugging Face `transformers` ile Kullanım
+
+```python
+from transformers import AutoTokenizer
+
+# Herhangi bir tokenizer yüklendikten sonra özel şablon atanabilir:
+tokenizer = AutoTokenizer.from_pretrained("gpt2")
+
+with open("chat_template.jinja", "r", encoding="utf-8") as f:
+    tokenizer.chat_template = f.read()
+
+messages = [
+    {"role": "system", "content": "Sen uzman bir eczacı yapay zekâsısın."},
+    {"role": "user", "content": "Boğazım ağrıyor."}
+]
+
+prompt = tokenizer.apply_chat_template(
+    messages,
+    add_generation_prompt=True,
+    tokenize=False
+)
+
+print(prompt)
+```
+
+**Üretilen Çıktı:**
+```text
+@FORMAT PPSF/1.0
+
+@SYSTEM
+Sen uzman bir eczacı yapay zekâsısın.
+
+@PATIENT
+Boğazım ağrıyor.
+
+@PHARMACIST
+```
+
+---
+
+### Tool Calling Senaryosu Örneği
+
+**Girdi:**
+```python
+messages = [
+    {"role": "system", "content": "Sen uzman bir eczacı yapay zekâsısın."},
+    {"role": "user", "content": "Parol ne işe yarar?"},
+    {
+        "role": "assistant",
+        "content": None,
+        "tool_calls": [
+            {
+                "function": {
+                    "name": "search_drug",
+                    "arguments": {"drug": "Parol"}
+                }
+            }
+        ]
+    },
+    {
+        "role": "tool",
+        "content": '{"drug": "Parol", "active_ingredient": "Parasetamol", "usage": "Ağrı kesici ve ateş düşürücü"}'
+    }
+]
+```
+
+**Üretilen Çıktı:**
+```text
+@FORMAT PPSF/1.0
+
+@SYSTEM
+Sen uzman bir eczacı yapay zekâsısın.
+
+@PATIENT
+Parol ne işe yarar?
+
+@TOOL_CALL
+{
+  "name": "search_drug",
+  "arguments": {"drug": "Parol"}
+}
+
+@TOOL_RESPONSE
+{"drug": "Parol", "active_ingredient": "Parasetamol", "usage": "Ağrı kesici ve ateş düşürücü"}
+
+@PHARMACIST
+```
+
+---
+
+## 🏛️ Mimari Tasarım Notları (PPSF v1.1 Desteği)
+
+Hugging Face standart `messages` yapısında `thought` veya `reference` rolleri bulunmamaktadır. Bu nedenle PPSF formatında CoT (Düşünce Adımları) ve RAG (Referans Dokümanlar) desteği `metadata` nesnesi üzerinden sağlanmıştır:
+
+```python
+{
+    "role": "user",
+    "content": "Grip için hangi ilacı kullanmalıyım?",
+    "metadata": {
+        "reference": "[Kılavuz Doc #42]: Parasetamol 500mg tercih edilir."
+    }
+}
+```
+
+Jinja2 şablonu bu `metadata` içeriğini otomatik olarak algılar ve `@REFERENCE` ile `@THOUGHT` bloklarını sırasıyla bağlama yerleştirir. Bu yaklaşım, ekosistem uyumluluğunu bozmadan formatı genişletilebilir kılar.

chat_template.jinja

@@ -0,0 +1,99 @@
+{#-
+    Pharmacy Prompt Serialization Format (PPSF) v1.0 / v1.1
+
+    Supported roles:
+      system     -> @SYSTEM
+      user       -> @PATIENT (with optional @REFERENCE via metadata)
+      assistant  -> @PHARMACIST (with optional @THOUGHT via metadata)
+      tool       -> @TOOL_RESPONSE
+
+    Tool Calling:
+      tools      -> @TOOLS
+      tool_calls -> @TOOL_CALL
+
+    Copyright:
+      PPSF v1.0
+-#}
+{{- "@FORMAT PPSF/1.0\n\n" -}}
+
+{#- ===========================
+   SYSTEM MESSAGE
+=========================== -#}
+{%- if messages and messages[0]["role"] == "system" -%}
+@SYSTEM
+{{ messages[0]["content"] | trim }}
+
+{% endif -%}
+
+{#- ===========================
+   TOOL DEFINITIONS
+=========================== -#}
+{%- if tools -%}
+@TOOLS
+Available tools:
+
+{% for tool in tools -%}
+{{ tool | tojson }}
+{% endfor %}
+To invoke a tool respond ONLY with:
+
+@TOOL_CALL
+{
+  "name": "...",
+  "arguments": { ... }
+}
+
+{% endif -%}
+
+{#- ===========================
+   CHAT HISTORY
+=========================== -#}
+{%- for message in messages -%}
+{%- if loop.first and message["role"] == "system" -%}
+    {# Handled in system block #}
+{%- elif message["role"] == "user" -%}
+    {%- set ref = message.get("reference") or (message.get("metadata") and message.metadata.get("reference")) -%}
+    {%- if ref -%}
+@REFERENCE
+{{ ref | trim }}
+
+{% endif -%}
+@PATIENT
+{{ message["content"] | trim }}
+
+{% elif message["role"] == "assistant" -%}
+    {%- set thought = message.get("thought") or (message.get("metadata") and message.metadata.get("thought")) -%}
+    {%- if thought -%}
+@THOUGHT
+{{ thought | trim }}
+
+{% endif -%}
+    {%- if message.get("content") -%}
+@PHARMACIST
+{{ message["content"] | trim }}
+
+{% endif -%}
+    {%- if message.get("tool_calls") -%}
+        {%- for tc in message["tool_calls"] -%}
+@TOOL_CALL
+{
+  "name": {{ tc["function"]["name"] | tojson }},
+  "arguments": {{ tc["function"]["arguments"] if tc["function"]["arguments"] is string else (tc["function"]["arguments"] | tojson) }}
+}
+
+{% endfor -%}
+    {%- endif -%}
+{%- elif message["role"] == "tool" -%}
+@TOOL_RESPONSE
+{{ message["content"] | trim }}
+
+{% endif -%}
+{%- endfor -%}
+
+{#- ===========================
+   GENERATION PROMPT
+=========================== -#}
+{%- if add_generation_prompt -%}
+@PHARMACIST
+{%- endif -%}
+

main.py

@@ -0,0 +1,137 @@
+import json
+import jinja2
+
+def tojson_filter(val, indent=None):
+    if indent is not None:
+        return json.dumps(val, ensure_ascii=False, indent=indent)
+    return json.dumps(val, ensure_ascii=False)
+
+def render_with_jinja(template_path, messages, tools=None, add_generation_prompt=False):
+    with open(template_path, "r", encoding="utf-8") as f:
+        template_content = f.read()
+
+    env = jinja2.Environment(trim_blocks=True, lstrip_blocks=True)
+    env.filters["tojson"] = tojson_filter
+
+    template = env.from_string(template_content)
+    return template.render(
+        messages=messages,
+        tools=tools,
+        add_generation_prompt=add_generation_prompt
+    )
+
+def render_with_huggingface(template_path, messages, tools=None, add_generation_prompt=False):
+    try:
+        from transformers import AutoTokenizer
+        with open(template_path, "r", encoding="utf-8") as f:
+            template_content = f.read()
+
+        tokenizer = AutoTokenizer.from_pretrained("gpt2")
+        tokenizer.chat_template = template_content
+        return tokenizer.apply_chat_template(
+            messages,
+            tools=tools,
+            add_generation_prompt=add_generation_prompt,
+            tokenize=False
+        )
+    except Exception as e:
+        return f"[HuggingFace Error / Not Available]: {e}"
+
+if __name__ == "__main__":
+    template_file = "chat_template.jinja"
+
+    print("=" * 60)
+    print(" 1. Standart Sohbet Senaryosu (PPSF v1.0)")
+    print("=" * 60)
+    messages_1 = [
+        {
+            "role": "system",
+            "content": "Sen uzman bir eczacı yapay zekâsısın."
+        },
+        {
+            "role": "user",
+            "content": "Boğazım ağrıyor."
+        }
+    ]
+
+    print("\n--- [Jinja2 Output] ---")
+    print(render_with_jinja(template_file, messages_1, add_generation_prompt=True))
+
+    print("--- [HuggingFace apply_chat_template Output] ---")
+    print(render_with_huggingface(template_file, messages_1, add_generation_prompt=True))
+
+    print("=" * 60)
+    print(" 2. Tool Calling & Tool Response Senaryosu")
+    print("=" * 60)
+    messages_2 = [
+        {
+            "role": "system",
+            "content": "Sen uzman bir eczacı yapay zekâsısın."
+        },
+        {
+            "role": "user",
+            "content": "Parol ne işe yarar?"
+        },
+        {
+            "role": "assistant",
+            "content": None,
+            "tool_calls": [
+                {
+                    "function": {
+                        "name": "search_drug",
+                        "arguments": {"drug": "Parol"}
+                    }
+                }
+            ]
+        },
+        {
+            "role": "tool",
+            "content": '{"drug": "Parol", "active_ingredient": "Parasetamol", "usage": "Ağrı kesici ve ateş düşürücü"}'
+        }
+    ]
+
+    tools_2 = [
+        {
+            "name": "search_drug",
+            "description": "Verilen ilaç hakkında detaylı bilgi arar.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "drug": {"type": "string", "description": "İlaç adı"}
+                },
+                "required": ["drug"]
+            }
+        }
+    ]
+
+    print("\n--- [Jinja2 Output] ---")
+    print(render_with_jinja(template_file, messages_2, tools=tools_2, add_generation_prompt=True))
+
+    print("=" * 60)
+    print(" 3. PPSF v1.1 Gelecek Uyumlu Metadata (@THOUGHT & @REFERENCE)")
+    print("=" * 60)
+    messages_3 = [
+        {
+            "role": "system",
+            "content": "Sen uzman bir eczacı yapay zekâsısın."
+        },
+        {
+            "role": "user",
+            "content": "Grip için hangi ilacı kullanmalıyım?",
+            "metadata": {
+                "reference": "[Kılavuz Doc #42]: Parasetamol 500mg hafif ağrı ve ateş durumlarında tercih edilir."
+            }
+        },
+        {
+            "role": "assistant",
+            "content": "Ateş ve hafif ağrınız varsa doktor veya eczacınıza danışarak Parasetamol içerikli ilaçlar tercih edebilirsiniz.",
+            "metadata": {
+                "thought": "Kullanıcının semptomları grip kaynaklı ateş ve hafif ağrı belirtilerine uymaktadır. Referans doküman #42 incelenerek Parasetamol tavsiye edildi."
+            }
+        }
+    ]
+
+    print("\n--- [Jinja2 Output] ---")
+    print(render_with_jinja(template_file, messages_3, add_generation_prompt=False))
+
+