📋 სწრაფი ცნობარი: ლექცია 4 (n8n, Executive Agents & Computer Use)

🚨 Panic Button: რა ვქნა, თუ რამე გაფუჭდა? (10-Second Fixes)

❌ "Expression error: Missing }} or invalid syntax"? ➔ Make/n8n-ში ფორმულა ყოველთვის უნდა იხურებოდეს წყვილი ფრჩხილით (მაგ. {{ $json.my_field }} ან {{1.name}}).
❌ Windows Task Scheduler არ უშვებს Python სკრიპტს? ➔ შეამოწმეთ WorkingDirectory (უნდა იყოს აბსოლუტური ბილიკი) და -Execute ველში მიუთითეთ python.exe-ის სრული ბილიკი.
❌ Gemini 3+ / LiteLLM ტემპერატურის გაფრთხილება (Deprecation Warning)? ➔ ამოიღეთ temperature, top_p LiteLLM-ის გამოძახებიდან და სტილის ინსტრუქციები გადაიტანეთ System Prompt-ში.
❌ Gmail IMAP ვერ უკავშირდება მეილს? ➔ გამოიყენეთ Google-ის 16-ნიშნა "App Password" (და არა ჩვეულებრივი პაროლი) და მეილების წასაკითხად გამოიყენეთ BODY.PEEK (რათა წერილები არ მოინიშნოს წაკითხულად).
❌ n8n Webhook მუშაობდა ტესტირებისას, მაგრამ გაჩერდა? ➔ n8n-ში არის 2 Webhook URL: Test და Production. სცენარის გააქტიურების (Active) შემდეგ გარე სერვისში აუცილებლად ჩასვით Production URL!

⚡ 5-Minute Quick-Start: n8n სცენარი 3 ნაბიჯში

☑️ 1. Trigger: დაამატე Manual Trigger ("When clicking Test workflow").
☑️ 2. Action Node: დაამატე Edit Fields (Set) და მიანიჭე ტესტური მნიშვნელობა (მაგ. status: active).
☑️ 3. Execute: დააჭირე Test step - მარჯვენა პანელში დაინახავ გამომავალ JSON ობიექტს.

🌅 Morning Briefing Executive Agent (არქიტექტურის ბარათი)

ბირთვი: Python + LiteLLM (gemini/gemini-3.5-flash-lite ან xai/grok-4.7).
წყაროები: Gmail IMAP (BODY.PEEK უსაფრთხო რეჟიმით), Calendar (ICS/CalDAV), Open-Meteo Weather API, Stooq/CoinGecko.
მიწოდება: Telegram Bot (ინტერაქტიული /markets ბრძანებებით) და ელფოსტა.
ავტომატიზაცია (OS Cron): Windows Task Scheduler (PowerShell: Register-ScheduledTask) დილის 07:30-ზე.
უსაფრთხო ტესტი: python main.py --dry-run (შეტყობინება იბეჭდება ეკრანზე რეალური გაგზავნის გარეშე).

n8n VS Make.com ტერმინოლოგია

Make.com	n8n
Module	Node
Scenario	Workflow
Mapping (Variables)	Expressions (`{{$json.var}}`)
Router	Switch / IF Node
Data structure panel	JSON Output preview

Deep Research აგენტის ციკლი
1. Receive Query: "ანალიზი ბლოკჩეინის რეგულაციებზე EU-ში"
2. Initialize Sub-Workflow:
   [LOOP START]
   3. Search Web (Query 1)
   4. Extract content (Firecrawl)
   5. LLM Analysis: "გვაქვს საკმარისი ინფო?"
      IF YES -> Exit Loop
      IF NO -> Generate Query 2 -> Go to Step 3
   [LOOP END]
6. Aggregate all findings
7. Write Final Report
            

🔒 Zero-Leakage სისტემის Checklist

n8n Hosting: დაყენებულია ლოკალურად Docker-ით (არა n8n Cloud).
LLM: გამოიყენება Ollama Node (მოდელები: Llama 4 Scout/Maverick, DeepSeek-V4.1-Flash ლოკალურად).
Network: სისტემა იზოლირებულია, ან აყენია Firewall, რომელიც კრძალავს გარე მოთხოვნებს (Outbound traffic).
APIs: არ გამოიყენება არანაირი გარე 3rd Party API, რომელიც ამუშავებს კონფიდენციალურ ტექსტს.

            🖱️ Computer Use & Browser Agents წესები
            როდის ვიყენებთ: მხოლოდ მაშინ, როცა სისტემას (ERP, ძველი CRM, პორტალი) არ აქვს ოფიციალური API.
როგორ მუშაობს: Screenshot ➔ Vision LLM ➔ კოორდინატების გამოთვლა (x, y) ➔ მაუსის კლიკი / კლავიატურის აკრეფა.
უსაფრთხოების ზღვარი: ფინანსურ ტრანზაქციებზე ან წაშლის მოქმედებებზე სავალდებულოა Human-in-the-Loop დასტური.

        