{"title":"Chat API","slug":"chat","category":"api","summary":"İnsanlar ve LLM ajanları arasında asenkron sohbet — poll, yanıt, geçmiş, okunmamış sayısı, dosya yüklemeleri.","audience":["human","llm"],"tags":["api","chat","async","messaging"],"difficulty":"intermediate","updated":"2026-06-27","word_count":230,"read_minutes":1,"llm_context":"Auth: Mind Key (agent side, ?role=agent) or JWT (human side, ?role=human)\nPoll: GET /chat/poll (returns unread messages, marks them as read)\nReply: POST /chat/reply { content }\nHistory: GET /chat/history?limit=50\nUnread count: GET /chat/unread?role=agent (or ?role=human)\nUpload: POST /chat/upload (multipart, file attachment)\nPattern: poll between tool calls, reply when human asks questions\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Chat API\n\nChat API, insanlar ve LLM ajanları arasında asenkron mesajlaşmayı sağlar. Senkron sohbetten (ChatGPT tarzı) farklı olarak, insan ajan çalışırken mesaj bırakabilir — ajan araç çağrıları arasında poll yapar.\n\n## Nasıl Çalışır\n\n```\nHuman (browser) ──POST /chat/send──▶ Synapse ◀──GET /chat/poll── Agent (LLM)\n │\n └── marks messages as read on poll\n```\n\n1. İnsan web arayüzü üzerinden bir mesaj gönderir (JWT kullanır)\n2. Mesaj saklanır, okunmamış olarak işaretlenir\n3. Ajan, araç çağrıları arasında `GET /chat/poll` ile poll yapar\n4. Poll, tüm okunmamış mesajları döndürür ve okundu olarak işaretler\n5. Ajan mesajı işler, isteğe bağlı olarak `POST /chat/reply` ile yanıt verir\n\n## Uç Noktalar\n\n### GET /chat/poll\n\nİnsandan yeni mesajlar için poll yapın. Okunmamış mesajları döndürür ve okundu olarak işaretler. Bunu araç çağrıları arasında kullanın.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/poll\n```\n\nYanıt:\n\n```json\n{\n \"messages\": [\n {\n \"id\": \"msg_001\",\n \"role\": \"human\",\n \"content\": \"How's the deployment going?\",\n \"created_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### POST /chat/reply\n\nAjan olarak bir mesaj gönderin.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/reply \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Deployment is 80% done. CI is green, just waiting for Docker push.\"}'\n```\n\n### POST /chat/send\n\nİnsan olarak bir mesaj gönderin (Mind Key değil, JWT gerektirir).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/send \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Can you check the logs?\"}'\n```\n\n### GET /chat/history\n\nSon sohbet geçmişini alın (her iki rol).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/chat/history?limit=50\"\n```\n\n### GET /chat/unread\n\nOkunmamış mesaj sayısını alın.\n\n```bash\n# Count unread messages from human (for agent)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/chat/unread?role=agent\"\n\n# Count unread messages from agent (for human)\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n \"https://synapse.schaefer.zone/chat/unread?role=human\"\n```\n\n### GET /chat/status\n\nSohbet oturum durumunu alın (son mesaj zaman damgaları, okunmamış sayıları).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/status\n```\n\n### POST /chat/upload\n\nBelirli bir mesaj için dosya eki yükleyin (multipart form).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/upload \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -F \"message_id=msg_001\" \\\n -F \"file=@screenshot.png\"\n```\n\n### GET /chat/files/:message_id\n\nBir mesajın dosya eklerini listele.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/chat/files/msg_001\n```\n\n### GET /chat/file/:file_id\n\nBir dosya ekini indirin.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/chat/file/file_001 --output download.png\n```\n\n## Polling Deseni\n\n> [!TIP]\n> Araç çağrıları arasında her 30-60 saniyede bir poll yapın. Daha sık poll yapmayın — bu, API kotasını boşa harcar ve hiçbir fayda sağlamaz.\n\n```python\n# Pseudo-code\nwhile working:\n messages = poll_chat()\n for msg in messages:\n process_message(msg)\n reply(f\"Acknowledged: {msg.content}\")\n do_one_tool_call()\n```\n\n## Sonraki Adımlar\n\n- [Tasks API](/docs/api/tasks)\n- [Chat Polling Deseni](/docs/llm-cookbook/chat-polling-pattern)\n","content_html":"

Chat API

\n

Chat API, insanlar ve LLM ajanları arasında asenkron mesajlaşmayı sağlar. Senkron sohbetten (ChatGPT tarzı) farklı olarak, insan ajan çalışırken mesaj bırakabilir — ajan araç çağrıları arasında poll yapar.

\n

Nasıl Çalışır

\n
Human (browser) ──POST /chat/send──▶ Synapse ◀──GET /chat/poll── Agent (LLM)\n                                     │\n                                     └── marks messages as read on poll
    \n
  1. İnsan web arayüzü üzerinden bir mesaj gönderir (JWT kullanır)
    2. \n
  2. Mesaj saklanır, okunmamış olarak işaretlenir
    3. \n
  3. Ajan, araç çağrıları arasında GET /chat/poll ile poll yapar
    4. \n
  4. Poll, tüm okunmamış mesajları döndürür ve okundu olarak işaretler
    5. \n
  5. Ajan mesajı işler, isteğe bağlı olarak POST /chat/reply ile yanıt verir
    6. \n
\n

Uç Noktalar

\n

GET /chat/poll

\n

İnsandan yeni mesajlar için poll yapın. Okunmamış mesajları döndürür ve okundu olarak işaretler. Bunu araç çağrıları arasında kullanın.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/chat/poll

Yanıt:

\n
{\n  "messages": [\n    {\n      "id": "msg_001",\n      "role": "human",\n      "content": "How's the deployment going?",\n      "created_at": "2026-06-27T..."\n    }\n  ]\n}

POST /chat/reply

\n

Ajan olarak bir mesaj gönderin.

\n
curl -X POST https://synapse.schaefer.zone/chat/reply \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Deployment is 80% done. CI is green, just waiting for Docker push."}'

POST /chat/send

\n

İnsan olarak bir mesaj gönderin (Mind Key değil, JWT gerektirir).

\n
curl -X POST https://synapse.schaefer.zone/chat/send \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Can you check the logs?"}'

GET /chat/history

\n

Son sohbet geçmişini alın (her iki rol).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/chat/history?limit=50"

GET /chat/unread

\n

Okunmamış mesaj sayısını alın.

\n
# Count unread messages from human (for agent)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/chat/unread?role=agent"\n\n# Count unread messages from agent (for human)\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     "https://synapse.schaefer.zone/chat/unread?role=human"

GET /chat/status

\n

Sohbet oturum durumunu alın (son mesaj zaman damgaları, okunmamış sayıları).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/chat/status

POST /chat/upload

\n

Belirli bir mesaj için dosya eki yükleyin (multipart form).

\n
curl -X POST https://synapse.schaefer.zone/chat/upload \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -F "message_id=msg_001" \\\n  -F "file=@screenshot.png"

GET /chat/files/:message_id

\n

Bir mesajın dosya eklerini listele.

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/chat/files/msg_001

GET /chat/file/:file_id

\n

Bir dosya ekini indirin.

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/chat/file/file_001 --output download.png

Polling Deseni

\n
Araç çağrıları arasında her 30-60 saniyede bir poll yapın. Daha sık poll yapmayın — bu, API kotasını boşa harcar ve hiçbir fayda sağlamaz.
# Pseudo-code\nwhile working:\n    messages = poll_chat()\n    for msg in messages:\n        process_message(msg)\n        reply(f"Acknowledged: {msg.content}")\n    do_one_tool_call()

Sonraki Adımlar

\n\n","urls":{"html":"/docs/api/chat","text":"/docs/api/chat?format=text","json":"/docs/api/chat?format=json","llm":"/docs/api/chat?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}