initial commit

04-Zarządzanie-Agentami/Tryb Server vs Task.md

@@ -0,0 +1,83 @@
+# Tryb Server vs Task
+
+#sympozium #agenty #server-mode
+
+## Dwa tryby wykonania
+
+### Task mode (default)
+- Kubernetes **Job** - run-to-completion
+- Pod istnieje tylko przez czas wykonania
+- Garbage collection po zakończeniu
+- Dla: one-shot tasks, scheduled runs, channel messages
+
+### Server mode
+- Kubernetes **Deployment + Service**
+- Pod żyje długo
+- Nie jest usuwany po "zakończeniu"
+- Dla: web endpoints, long-running services
+
+## Kiedy server mode?
+
+Server mode aktywowany gdy:
+1. `AgentRun.spec.mode = "server"` (jawnie ustawione)
+2. SkillPack ma `sidecar.requiresServer = true`
+
+Typowy use case: **web-endpoint** skill, który eksponuje agenta jako HTTP API.
+
+## Architektura server mode
+
+```
+SympoziumInstance z skill "web-endpoint"
+    ↓
+Instance Reconciler → tworzy AgentRun (mode: server)
+    ↓
+AgentRun Reconciler → reconcilePendingServer():
+  1. Deployment (zamiast Job)
+  2. Service (ClusterIP)
+  3. HTTPRoute (Envoy Gateway, jeśli dostępny)
+  4. Auto-generated API key (Secret)
+    ↓
+Web Proxy Sidecar:
+  - /v1/chat/completions (OpenAI-compat)
+  - /sse, /message (MCP protocol)
+  - Rate limiting
+  - Auth via API key
+```
+
+## Przepływ request'u w server mode
+
+```
+HTTP Client → Gateway → HTTPRoute → Service → Web Proxy Pod
+    ↓
+Web Proxy tworzy per-request AgentRun (mode: task!)
+    ↓
+Normalny flow: Job → Agent → wynik → Web Proxy → HTTP Response
+```
+
+Kluczowe: web proxy sidecar sam działa w server mode, ale **każdy request to osobny task-mode AgentRun** - zachowujemy ephemeral model dla izolacji.
+
+## Reconciliation server mode
+
+`reconcileServing()` (zamiast reconcileRunning):
+- Sprawdza Deployment health
+- Sprawdza Service health
+- Reconciliuje HTTPRoute
+- Requeue co 30 sekund
+
+`reconcileDelete()` dla server mode:
+- Delete Deployment
+- Delete Service
+- Delete HTTPRoute
+- Delete API key Secret
+
+## Faza Serving
+
+```
+AgentRun phases:
+  Pending → Serving (nie Running!)
+  Serving (długo) → Succeeded (gdy usunięty)
+```
+
+---
+
+Powiązane: [[Web Endpoints - OpenAI-compat API]] | [[Cykl życia AgentRun]] | [[Model efemerycznych agentów]]