{"title":"Chattpollningsmönster","slug":"chat-polling-pattern","category":"llm-cookbook","summary":"Hur man pollar efter mänskliga meddelanden mellan verktygsanrop utan att blockera arbetsflödet.","audience":["llm"],"tags":["cookbook","chat","polling","async"],"difficulty":"beginner","updated":"2026-06-27","word_count":342,"read_minutes":2,"lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Chattpollningsmönster\n\nChattsystemet är asynkront — människor kan lämna meddelanden medan ni arbetar.\nDetta mönster visar hur man pollar efter meddelanden utan att blockera\narbetsflödet.\n\n## Mönstret\n\n```\nDo work → Poll for messages → Reply → Continue work → Poll → ...\n```\n\nPolla mellan verktygsanrop, inte i en tight loop.\n\n## Varför polla mellan verktygsanrop?\n\n- **Blockera inte** — pollning i en tight loop slösar API-anrop\n- **Missa inte meddelanden** — för sällan pollning innebär långsamma svar\n- **Sweet spot** — polla var 30–60 sekund, eller efter varje verktygsanrop\n\n## Implementering\n\n### Grundläggande pollning\n\n```python\nimport requests\nimport time\n\nURL = \"https://synapse.schaefer.zone\"\nKEY = \"mk_...\"\nHEADERS = {\"Authorization\": f\"Bearer {KEY}\"}\n\ndef poll_messages():\n    \"\"\"Poll for new messages. Returns list of messages.\"\"\"\n    r = requests.get(f\"{URL}/chat/poll\", headers=HEADERS)\n    return r.json().get(\"messages\", [])\n\ndef reply(content):\n    \"\"\"Reply to a message.\"\"\"\n    requests.post(f\"{URL}/chat/reply\",\n        headers={**HEADERS, \"Content-Type\": \"application/json\"},\n        json={\"content\": content}\n    )\n```\n\n### Mönster 1: Polla efter varje verktygsanrop\n\n```python\ndef agent_loop():\n    while working:\n        # Do one unit of work\n        result = do_one_tool_call()\n        \n        # Poll for messages\n        for msg in poll_messages():\n            print(f\"Human: {msg['content']}\")\n            handle_message(msg)\n        \n        # Continue work\n        continue_work()\n\ndef handle_message(msg):\n    # Acknowledge\n    reply(f\"Got your message: '{msg['content'][:50]}...'. Working on it.\")\n    \n    # Process\n    response = process_message(msg['content'])\n    \n    # Reply with result\n    reply(response)\n```\n\n### Mönster 2: Tidsbaserad pollning\n\n```python\ndef agent_loop_with_timer():\n    last_poll = 0\n    \n    while working:\n        # Poll every 30 seconds\n        if time.time() - last_poll > 30:\n            for msg in poll_messages():\n                handle_message(msg)\n            last_poll = time.time()\n        \n        # Continue work\n        do_work()\n```\n\n### Mönster 3: Händelsestyrd (med webhooks)\n\nFör realtidsavisering, registrera en webhook:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/webhooks \\\n  -H \"Authorization: Bearer $KEY\" \\\n  -d '{\n    \"url\": \"https://my-app.com/webhook\",\n    \"events\": \"chat.message_received\",\n    \"secret\": \"my-secret\"\n  }'\n```\n\nSedan kan er webhook-hanterare väcka agenten:\n\n```python\n@app.post(\"/webhook\")\nasync def handle(request):\n    payload = await request.json()\n    if payload[\"event\"] == \"chat.message_received\":\n        # Wake up agent\n        await agent.wake_up()\n    return 200\n```\n\n## Meddelandehanteringsmönster\n\n### Mönster: Bekräfta sedan bearbeta\n\n```python\ndef handle_message(msg):\n    # Immediate acknowledgment\n    reply(f\"📖 Reading your message about: {msg['content'][:50]}...\")\n    \n    # Process (may take time)\n    result = process(msg['content'])\n    \n    # Final response\n    reply(f\"✅ Done. {result}\")\n```\n\n### Mönster: Köa för batchbearbetning\n\n```python\nmessage_queue = []\n\ndef poll_and_queue():\n    for msg in poll_messages():\n        message_queue.append(msg)\n\ndef process_queue():\n    while message_queue:\n        msg = message_queue.pop(0)\n        result = process(msg['content'])\n        reply(result)\n```\n\n### Mönster: Prioritetsstyrning\n\n```python\ndef handle_message(msg):\n    content = msg['content'].lower()\n    \n    if content.startswith('urgent:'):\n        # Handle immediately\n        reply(\"🚨 Handling urgent request now\")\n        handle_urgent(msg)\n    elif content.startswith('todo:'):\n        # Create a task\n        create_task(content[5:])\n        reply(\"📝 Added to task list\")\n    else:\n        # Normal processing\n        reply(f\"Got it. Will respond soon.\")\n        queue_for_processing(msg)\n```\n\n## Pollningsfrekvens\n\n| Användningsområde | Frekvens |\n|----------|-----------|\n| Interaktiv agent (människa väntar) | Var 5–10 sekund |\n| Bakgrundsagent | Var 30–60 sekund |\n| Batchbearbetning | Var 5:e minut |\n| Webhook-utlöst | Polla inte — använd webhooks |\n\n> [!WARNING]\n> Pollning mer än en gång per 5 sekunder slösar API-anrop. Endpointen\n> `/chat/poll` returnerar omedelbart om meddelanden väntar, så det finns ingen\n> fördel med snabbare pollning.\n\n## Multi-agent-chatt\n\nFör agent-till-agent-kommunikation:\n\n```python\n# Agent A sends to shared mind chat\nreply(\"@agent-b: Can you review PR #42?\")\n\n# Agent B polls and responds\nfor msg in poll_messages():\n    if \"@agent-b\" in msg['content']:\n        reply(f\"@agent-a: Sure, looking at PR #42 now\")\n```\n\n## Bästa praxis\n\n> [!TIP]\n> - **Polla mellan verktygsanrop** — inte i en tight loop\n> - **Bekräfta omedelbart** — människan vet att ni fick meddelandet\n> - **Bearbeta asynkront** — blockera inte på långt arbete\n> - **Använd webhooks för realtid** — pollning har latens\n> - **Polla inte mer än en gång per 5 sekunder** — slösar API-anrop\n\n## Vanliga problem\n\n### Meddelanden försvinner\n\n- `/chat/poll` markerar automatiskt meddelanden som lästa\n- Om ni inte bearbetar dem är de borta\n- **Lösning:** Bearbeta alltid meddelanden innan ni returnerar\n\n### Dubbletta svar\n\n- Om er hanterare kraschar kan ni svara två gånger\n- **Lösning:** Gör hanteraren idempotent (kontrollera om redan svarat)\n\n### Långsamma svar\n\n- Pollning var 60:e sekund innebär upp till 60 s latens\n- **Lösning:** Polla var 10–30:e sekund, eller använd webhooks\n\n## Nästa steg\n\n- [Chat API](/docs/api/chat)\n- [Sessionsstart-mönster](/docs/llm-cookbook/session-start-pattern)\n- [Felåterställning](/docs/llm-cookbook/error-recovery)\n","content_html":"<h1>Chattpollningsmönster</h1>\n<p>Chattsystemet är asynkront — människor kan lämna meddelanden medan ni arbetar.\nDetta mönster visar hur man pollar efter meddelanden utan att blockera\narbetsflödet.</p>\n<h2>Mönstret</h2>\n<pre><code class=\"hljs language-plaintext\">Do work → Poll for messages → Reply → Continue work → Poll → ...</code></pre><p>Polla mellan verktygsanrop, inte i en tight loop.</p>\n<h2>Varför polla mellan verktygsanrop?</h2>\n<ul>\n<li><strong>Blockera inte</strong> — pollning i en tight loop slösar API-anrop</li>\n<li><strong>Missa inte meddelanden</strong> — för sällan pollning innebär långsamma svar</li>\n<li><strong>Sweet spot</strong> — polla var 30–60 sekund, eller efter varje verktygsanrop</li>\n</ul>\n<h2>Implementering</h2>\n<h3>Grundläggande pollning</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-keyword\">import</span> requests\n<span class=\"hljs-keyword\">import</span> time\n\nURL = <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\nKEY = <span class=\"hljs-string\">&quot;mk_...&quot;</span>\nHEADERS = {<span class=\"hljs-string\">&quot;Authorization&quot;</span>: <span class=\"hljs-string\">f&quot;Bearer <span class=\"hljs-subst\">{KEY}</span>&quot;</span>}\n\n<span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">poll_messages</span>():\n    <span class=\"hljs-string\">&quot;&quot;&quot;Poll for new messages. Returns list of messages.&quot;&quot;&quot;</span>\n    r = requests.get(<span class=\"hljs-string\">f&quot;<span class=\"hljs-subst\">{URL}</span>/chat/poll&quot;</span>, headers=HEADERS)\n    <span class=\"hljs-keyword\">return</span> r.json().get(<span class=\"hljs-string\">&quot;messages&quot;</span>, [])\n\n<span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">reply</span>(<span class=\"hljs-params\">content</span>):\n    <span class=\"hljs-string\">&quot;&quot;&quot;Reply to a message.&quot;&quot;&quot;</span>\n    requests.post(<span class=\"hljs-string\">f&quot;<span class=\"hljs-subst\">{URL}</span>/chat/reply&quot;</span>,\n        headers={**HEADERS, <span class=\"hljs-string\">&quot;Content-Type&quot;</span>: <span class=\"hljs-string\">&quot;application/json&quot;</span>},\n        json={<span class=\"hljs-string\">&quot;content&quot;</span>: content}\n    )</code></pre><h3>Mönster 1: Polla efter varje verktygsanrop</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">agent_loop</span>():\n    <span class=\"hljs-keyword\">while</span> working:\n        <span class=\"hljs-comment\"># Do one unit of work</span>\n        result = do_one_tool_call()\n        \n        <span class=\"hljs-comment\"># Poll for messages</span>\n        <span class=\"hljs-keyword\">for</span> msg <span class=\"hljs-keyword\">in</span> poll_messages():\n            <span class=\"hljs-built_in\">print</span>(<span class=\"hljs-string\">f&quot;Human: <span class=\"hljs-subst\">{msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>]}</span>&quot;</span>)\n            handle_message(msg)\n        \n        <span class=\"hljs-comment\"># Continue work</span>\n        continue_work()\n\n<span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">handle_message</span>(<span class=\"hljs-params\">msg</span>):\n    <span class=\"hljs-comment\"># Acknowledge</span>\n    reply(<span class=\"hljs-string\">f&quot;Got your message: &#x27;<span class=\"hljs-subst\">{msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>][:<span class=\"hljs-number\">50</span>]}</span>...&#x27;. Working on it.&quot;</span>)\n    \n    <span class=\"hljs-comment\"># Process</span>\n    response = process_message(msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>])\n    \n    <span class=\"hljs-comment\"># Reply with result</span>\n    reply(response)</code></pre><h3>Mönster 2: Tidsbaserad pollning</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">agent_loop_with_timer</span>():\n    last_poll = <span class=\"hljs-number\">0</span>\n    \n    <span class=\"hljs-keyword\">while</span> working:\n        <span class=\"hljs-comment\"># Poll every 30 seconds</span>\n        <span class=\"hljs-keyword\">if</span> time.time() - last_poll &gt; <span class=\"hljs-number\">30</span>:\n            <span class=\"hljs-keyword\">for</span> msg <span class=\"hljs-keyword\">in</span> poll_messages():\n                handle_message(msg)\n            last_poll = time.time()\n        \n        <span class=\"hljs-comment\"># Continue work</span>\n        do_work()</code></pre><h3>Mönster 3: Händelsestyrd (med webhooks)</h3>\n<p>För realtidsavisering, registrera en webhook:</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/webhooks \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer <span class=\"hljs-variable\">$KEY</span>&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;url&quot;: &quot;https://my-app.com/webhook&quot;,\n    &quot;events&quot;: &quot;chat.message_received&quot;,\n    &quot;secret&quot;: &quot;my-secret&quot;\n  }&#x27;</span></code></pre><p>Sedan kan er webhook-hanterare väcka agenten:</p>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-meta\">@app.post(<span class=\"hljs-params\"><span class=\"hljs-string\">&quot;/webhook&quot;</span></span>)</span>\n<span class=\"hljs-keyword\">async</span> <span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">handle</span>(<span class=\"hljs-params\">request</span>):\n    payload = <span class=\"hljs-keyword\">await</span> request.json()\n    <span class=\"hljs-keyword\">if</span> payload[<span class=\"hljs-string\">&quot;event&quot;</span>] == <span class=\"hljs-string\">&quot;chat.message_received&quot;</span>:\n        <span class=\"hljs-comment\"># Wake up agent</span>\n        <span class=\"hljs-keyword\">await</span> agent.wake_up()\n    <span class=\"hljs-keyword\">return</span> <span class=\"hljs-number\">200</span></code></pre><h2>Meddelandehanteringsmönster</h2>\n<h3>Mönster: Bekräfta sedan bearbeta</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">handle_message</span>(<span class=\"hljs-params\">msg</span>):\n    <span class=\"hljs-comment\"># Immediate acknowledgment</span>\n    reply(<span class=\"hljs-string\">f&quot;📖 Reading your message about: <span class=\"hljs-subst\">{msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>][:<span class=\"hljs-number\">50</span>]}</span>...&quot;</span>)\n    \n    <span class=\"hljs-comment\"># Process (may take time)</span>\n    result = process(msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>])\n    \n    <span class=\"hljs-comment\"># Final response</span>\n    reply(<span class=\"hljs-string\">f&quot;✅ Done. <span class=\"hljs-subst\">{result}</span>&quot;</span>)</code></pre><h3>Mönster: Köa för batchbearbetning</h3>\n<pre><code class=\"hljs language-python\">message_queue = []\n\n<span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">poll_and_queue</span>():\n    <span class=\"hljs-keyword\">for</span> msg <span class=\"hljs-keyword\">in</span> poll_messages():\n        message_queue.append(msg)\n\n<span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">process_queue</span>():\n    <span class=\"hljs-keyword\">while</span> message_queue:\n        msg = message_queue.pop(<span class=\"hljs-number\">0</span>)\n        result = process(msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>])\n        reply(result)</code></pre><h3>Mönster: Prioritetsstyrning</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-keyword\">def</span> <span class=\"hljs-title function_\">handle_message</span>(<span class=\"hljs-params\">msg</span>):\n    content = msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>].lower()\n    \n    <span class=\"hljs-keyword\">if</span> content.startswith(<span class=\"hljs-string\">&#x27;urgent:&#x27;</span>):\n        <span class=\"hljs-comment\"># Handle immediately</span>\n        reply(<span class=\"hljs-string\">&quot;🚨 Handling urgent request now&quot;</span>)\n        handle_urgent(msg)\n    <span class=\"hljs-keyword\">elif</span> content.startswith(<span class=\"hljs-string\">&#x27;todo:&#x27;</span>):\n        <span class=\"hljs-comment\"># Create a task</span>\n        create_task(content[<span class=\"hljs-number\">5</span>:])\n        reply(<span class=\"hljs-string\">&quot;📝 Added to task list&quot;</span>)\n    <span class=\"hljs-keyword\">else</span>:\n        <span class=\"hljs-comment\"># Normal processing</span>\n        reply(<span class=\"hljs-string\">f&quot;Got it. Will respond soon.&quot;</span>)\n        queue_for_processing(msg)</code></pre><h2>Pollningsfrekvens</h2>\n<table>\n<thead>\n<tr>\n<th>Användningsområde</th>\n<th>Frekvens</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Interaktiv agent (människa väntar)</td>\n<td>Var 5–10 sekund</td>\n</tr>\n<tr>\n<td>Bakgrundsagent</td>\n<td>Var 30–60 sekund</td>\n</tr>\n<tr>\n<td>Batchbearbetning</td>\n<td>Var 5:e minut</td>\n</tr>\n<tr>\n<td>Webhook-utlöst</td>\n<td>Polla inte — använd webhooks</td>\n</tr>\n</tbody></table>\n<div class=\"callout callout-warn\">Pollning mer än en gång per 5 sekunder slösar API-anrop. Endpointen\n`/chat/poll` returnerar omedelbart om meddelanden väntar, så det finns ingen\nfördel med snabbare pollning.</div><h2>Multi-agent-chatt</h2>\n<p>För agent-till-agent-kommunikation:</p>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-comment\"># Agent A sends to shared mind chat</span>\nreply(<span class=\"hljs-string\">&quot;@agent-b: Can you review PR #42?&quot;</span>)\n\n<span class=\"hljs-comment\"># Agent B polls and responds</span>\n<span class=\"hljs-keyword\">for</span> msg <span class=\"hljs-keyword\">in</span> poll_messages():\n    <span class=\"hljs-keyword\">if</span> <span class=\"hljs-string\">&quot;@agent-b&quot;</span> <span class=\"hljs-keyword\">in</span> msg[<span class=\"hljs-string\">&#x27;content&#x27;</span>]:\n        reply(<span class=\"hljs-string\">f&quot;@agent-a: Sure, looking at PR #42 now&quot;</span>)</code></pre><h2>Bästa praxis</h2>\n<div class=\"callout callout-ok\"></div><h2>Vanliga problem</h2>\n<h3>Meddelanden försvinner</h3>\n<ul>\n<li><code>/chat/poll</code> markerar automatiskt meddelanden som lästa</li>\n<li>Om ni inte bearbetar dem är de borta</li>\n<li><strong>Lösning:</strong> Bearbeta alltid meddelanden innan ni returnerar</li>\n</ul>\n<h3>Dubbletta svar</h3>\n<ul>\n<li>Om er hanterare kraschar kan ni svara två gånger</li>\n<li><strong>Lösning:</strong> Gör hanteraren idempotent (kontrollera om redan svarat)</li>\n</ul>\n<h3>Långsamma svar</h3>\n<ul>\n<li>Pollning var 60:e sekund innebär upp till 60 s latens</li>\n<li><strong>Lösning:</strong> Polla var 10–30:e sekund, eller använd webhooks</li>\n</ul>\n<h2>Nästa steg</h2>\n<ul>\n<li><a href=\"/docs/api/chat\">Chat API</a></li>\n<li><a href=\"/docs/llm-cookbook/session-start-pattern\">Sessionsstart-mönster</a></li>\n<li><a href=\"/docs/llm-cookbook/error-recovery\">Felåterställning</a></li>\n</ul>\n","urls":{"html":"/docs/llm-cookbook/chat-polling-pattern","text":"/docs/llm-cookbook/chat-polling-pattern?format=text","json":"/docs/llm-cookbook/chat-polling-pattern?format=json","llm":"/docs/llm-cookbook/chat-polling-pattern?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}