🤖 2026 Practical Agent Architecture

20 პერსონალური & აღმასრულებელი აგენტი

მზა ჩარჩო, არქიტექტურული პატერნები, ნულოვანი რისკის დიზაინი და სრული გზამკვლევი Morning Briefing Agent-ის ასაწყობად და Windows/Linux-ზე ავტომატური გაშვებისთვის.

⚡ Python 3.11+ / LiteLLM 🧠 Gemini 3.5 Flash Lite 🤖 xAI GrokBot & Real-time X 📱 Telegram Bot API 📅 Windows Task Scheduler 🆓 100% Free APIs

👔 20 პერსონალური & აღმასრულებელი აგენტის კატალოგი

აირჩიეთ აგენტი თქვენი ბიზნეს საჭიროების ან ფინალური (Capstone) პროექტისთვის.

#01 Tier 2: HITL
📥 Inbox Triage Agent
ალაგებს ელფოსტას პრიორიტეტის მიხედვით, არქივებს ხმაურს, ნიშნავს სასწრაფო წერილებს და ადგენს დღის რეზიუმეს.
ინტეგრაცია: Gmail / IMAP რისკი: დაბალი
#02 Tier 2: HITL
✍️ Email Drafting Agent
წერს საპასუხო წერილებს თქვენი ავთენტური სტილით და ინახავს Drafts-ში. არასდროს აგზავნის ადამიანის დადასტურების გარეშე.
ინტეგრაცია: Gmail MCP რისკი: უსაფრთხო
#03 Tier 2: HITL
📅 Calendar Scheduling Agent
პოულობს ოპტიმალურ დროს შეხვედრებისთვის, მართავს გადადებებს და ავტომატურად იცავს სამუშაო ფოკუს-საათებს (Focus Blocks).
ინტეგრაცია: Google Cal / CalDAV რისკი: საშუალო
#04 Tier 1: Quick Win
🌅 Morning Brief Agent
დილის შეჯამება: დღის შეხვედრები, გადაუდებელი მეილები, ამინდი, კრიპტო/აქციები და სიახლეები. სრულად Read-only.
ინტეგრაცია: Telegram, Weather, Cal რისკი: ნულოვანი
#05 Tier 1: Quick Win
🤝 Meeting Prep Agent
შეხვედრამდე 15 წუთით ადრე ამოიღებს მონაწილის LinkedIn/ბექგრაუნდს, წარსულ ჩანაწერებსა და ღია საკითხებს.
ინტეგრაცია: Calendar, CRM, Notion რისკი: ნულოვანი
#06 Tier 1: Quick Win
📝 Meeting Notes Agent
ზარის აუდიო ტრანსკრიპტიდან ამოიღებს მიღებულ გადაწყვეტილებებს, Action Items-ს და გზავნის Slack-ში ან Notion-ში.
ინტეგრაცია: Whisper, Notion MCP რისკი: ნულოვანი
#07 Tier 2: HITL
✅ Task & To-Do Manager
ჩატებიდან, მეილებიდან და შეხვედრებიდან ამოკრებს დავალებებს, ანიჭებს პრიორიტეტს და ამატებს Todoist/Linear/Notion-ში.
ინტეგრაცია: Todoist, Notion, Telegram რისკი: დაბალი
#08 Tier 3: Transact
✈️ Travel Planning Agent
ეძებს ფრენებსა და სასტუმროებს, ადგენს ოპტიმალურ სამგზავრო მარშრუტს და ინახავს ბილეთებს კალენდარში.
ინტეგრაცია: Flight API, Scraper, Cal რისკი: მაღალი
#09 Tier 3: Transact
🧾 Expense & Receipt Agent
კრებს ქვითრებს (PDF/ფოტო), Vision AI-ით ამოიღებს თანხას, კომპანიასა და თარიღს და ავსებს ბუღალტრულ რეპორტს.
ინტეგრაცია: Vision AI, Drive, Sheets რისკი: საშუალო
#10 Tier 3: Transact
💳 Personal Finance Agent
აკონტროლებს ბიუჯეტს, აფიქსირებს უჩვეულო ჩამოჭრებს და აჯამებს ყოველთვიურ ხარჯებს კატეგორიების მიხედვით.
ინტეგრაცია: Bank CSV, Google Sheets რისკი: მაღალი
#11 Tier 2: HITL
🧠 Second-Brain Agent
აორგანიზებს ყოველდღიურ ჩანაწერებს Notion-სა და Obsidian-ში, პოულობს სემანტიკურ კავშირებს წარსულ იდეებთან.
ინტეგრაცია: Notion MCP, Qdrant რისკი: დაბალი
#12 Tier 1: Quick Win
📰 Research & GrokBot Intelligence
ამოიღებს სიახლეებს RSS-იდან, ვებიდან და xAI GrokBot-ის Real-time X ნაკადიდან, აანალიზებს ბაზრის ცოცხალ სენტიმენტს და ქმნის 3-წუთიან დაიჯესტს.
ინტეგრაცია: xAI GrokBot, RSS, Firecrawl რისკი: ნულოვანი
#13 Tier 2: HITL
👥 CRM & Relationship Agent
გახსენებთ პარტნიორებთან და კლიენტებთან დაკავშირებას, ინახავს წინა კომუნიკაციის ისტორიას და გეგმავს Follow-up-ს.
ინტეგრაცია: HubSpot, Sheets, Telegram რისკი: დაბალი
#14 Tier 3: Orchestrator
👑 Chief of Staff Agent
კოორდინაციას უწევს სხვა აგენტებს, აკონტროლებს კვირის პრიორიტეტებს და ამზადებს აღმასრულებელ სტატუს-რეპორტს.
ინტეგრაცია: Multi-Agent Orchestrator რისკი: საშუალო
#15 Tier 1: Quick Win
📄 Document Drafting Agent
მოკლე თეზისებიდან ქმნის სრულყოფილ წინადადებებს (Proposals), მემორანდუმებსა და ხელშეკრულებების მონახაზებს.
ინტეგრაცია: Markdown, Docs, PDF რისკი: ნულოვანი
#16 Tier 1: Quick Win
📊 Slide Deck Agent
ტექსტურ გეგმას ან მონაცემებს წამებში გარდაქმნის სტრუქტურირებულ, პრეზენტაციულ HTML/Markdown სლაიდებად.
ინტეგრაცია: Marp, Reveal.js რისკი: ნულოვანი
#17 Tier 2: HITL
📣 Social Media & Trend Agent
xAI GrokBot-ითა და X/LinkedIn API-ით აიდენტიფიცირებს ვირუსულ ტრენდებს, გრძელ მასალებს გარდაქმნის პოსტებად და ინახავს დასადასტურებლად.
ინტეგრაცია: GrokBot, LinkedIn API, Buffer რისკი: საშუალო
#18 Tier 3: Transact
🏃 Health & Routine Agent
აღრიცხავს ჩვევებს, ძილს, ვარჯიშებსა და კვებას, აანალიზებს ტენდენციებს და იძლევა ადაპტურ რეკომენდაციებს.
ინტეგრაცია: Health API, Sheets რისკი: დაბალი
#19 Tier 3: Transact
🏡 Smart Home & Errands
მართავს საოჯახო შეხსენებებს, შეკვეთებს, დასუფთავების განრიგსა და IoT მოწყობილობებს.
ინტეგრაცია: Home Assistant, Webhooks რისკი: მაღალი
#20 Tier 3: Personal Coach
🎓 Learning Coach Agent
ადგენს სწავლის პერსონალურ გეგმას, ყოველდღიურად გიტარებთ ქვიზებს და აკონტროლებს პროგრესს ახალ უნარებში.
ინტეგრაცია: RAG, Telegram, Memory რისკი: ნულოვანი

🌅 Live Case Study: Morning Briefing Executive Agent

რეალური, პროდაქშენში გამოცდილი აგენტის არქიტექტურა (Python, LiteLLM, Telegram, Task Scheduler).

⭐ რეკომენდებული საწყისი პროექტი

რატომ დილის ბრიფინგი? ის იდეალურია დასაწყებად: მუშაობს მხოლოდ Read-Only რეჟიმში, არ აქვს არანაირი შეცდომის რისკი (არაფერს შლის და არ აგზავნის სხვის მეილზე), იყენებს 100%-ით უფასო API-ებს და იძლევა მყისიერ ყოველდღიურ ღირებულებას.

┌────────────────────────────────────────────────────────────────────────────────────────┐ │ MORNING BRIEFING AGENT WORKFLOW │ └────────────────────────────────────────────────────────────────────────────────────────┘ [1. Trigger] ───────► Windows Task Scheduler (07:30 AM) │ [2. Data Engine] ───┬───────┴───────────────────────┬──────────────────────┬───────────┐ ▼ ▼ ▼ ▼ Open-Meteo API CoinGecko / Stooq xAI GrokBot Gmail / CalDAV (ამინდი, უფასო) (კრიპტო & აქციები) (Real-time X) (readonly, PEEK) │ │ │ │ [3. Logic] ─────────┼───────────────────────────────┴──────────────────────┴───────────┤ ▼ Deterministic Code Formatting (რიცხვები, ფასები, ▲/▼ გამოთვლა კოდით — ZERO ჰალუცინაცია) │ [4. LLM] ───────────▼ LiteLLM ──► Gemini 3.5 Flash Lite / Grok (მხოლოდ სინთეზი, ქართული თარგმანი, ციტატა და ბრიფინგის შეკვრა) │ [5. Notifier] ──────▼ Telegram Bot (პირდაპირი მესიჯი + Inline ღილაკი 📈 ბაზრები) + Email (SMTP სარეზერვო)

🔑 მთავარი საინჟინრო პრინციპები

⚙️ 1. კოდი VS მოდელი (Strict Separation)

ფინანსური ციფრები, აქციების პროცენტები (▲ 1.8%) და ფასები ფორმატირდება მკაცრად კოდით (markets.py). მოდელი არ ითვლის მათ, რათა გამოირიცხოს ჰალუცინაციები და დაიზოგოს ტოკენები.

🛡️ 2. Graceful Degradation (მედეგობა)

თუ Stooq ან CoinGecko გაითიშა, ბრიფინგი არ ფუჭდება — მის ადგილას იწერება „მიუწვდომელია“ და დანარჩენი იგზავნება. თუ LLM გაითიშა, იგზავნება ნედლი ფაქტები.

🔒 3. Read-Only უსაფრთხოება

Gmail IMAP იხსნება readonly რეჟიმში BODY.PEEK ბრძანებით. წერილები არ მოინიშნება წაკითხულად და აგენტს არ აქვს გაგზავნის უფლება.

🧠 4. Gemini 3+ Prompt Engineering

Gemini 3+ მოდელებში temperature და top_p მოძველებულია. ლაკონურობა და ფაქტობრივი სიზუსტე იმართება პირდაპირ სისტემურ პრომპტში.

⚡ 5. xAI GrokBot & Real-time X Stream

სურვილისამებრ ინტეგრირდება xAI Grok API ან GrokBot: აგენტი კითხულობს X-ის (Twitter) ცოცხალ ნაკადს, იჭერს ბაზრის ცხელ ინსაიტებსა და Breaking News-ს რეალურ დროში.

💻 1. უფასო ფინანსური მონაცემები: sources/markets.py

CoinGecko უფასო API კრიპტოვალუტებისთვის და Stooq უფასო CSV API ამერიკული აქციებისთვის (გასაღების გარეშე):

sources/markets.py (CoinGecko + Stooq CSV)
import csv, io, os, requests

TIMEOUT = 10
HEADERS = {"User-Agent": "morning-briefing/1.0"}
CG_URL = "https://api.coingecko.com/api/v3/simple/price"
STOOQ_URL = "https://stooq.com/q/d/l/"

def fetch_crypto(ids: list[str], vs: str = "usd") -> list[dict]:
    """CoinGecko API: ფასი და 24 საათის ცვლილება (%)"""
    headers = dict(HEADERS)
    key = os.getenv("COINGECKO_API_KEY")  # არასავალდებულო Demo Key
    if key: headers["x-cg-demo-api-key"] = key
    r = requests.get(CG_URL, params={"ids": ",".join(ids), "vs_currencies": vs, "include_24hr_change": "true"}, headers=headers, timeout=TIMEOUT)
    r.raise_for_status()
    data = r.json()
    return [{"name": c, "price": data[c][vs], "change_pct": data[c].get(f"{vs}_24h_change")} for c in ids if c in data]

def fetch_stock(symbol: str) -> dict | None:
    """Stooq API: ბოლო ორი დღის Close ფასი და % ცვლილება (ფორმატი: aapl.us)"""
    r = requests.get(STOOQ_URL, params={"s": symbol, "i": "d"}, headers=HEADERS, timeout=TIMEOUT)
    r.raise_for_status()
    rows = [x for x in csv.DictReader(io.StringIO(r.text)) if x.get("Close")]
    if len(rows) < 2: return None
    last, prev = float(rows[-1]["Close"]), float(rows[-2]["Close"])
    return {"name": symbol.upper(), "price": last, "change_pct": (last - prev) / prev * 100}

⚙️ 2. config.yaml კონფიგურაცია

config.yaml (ბაზრებისა და მოდელის მართვა)
llm:
  models:
    - gemini/gemini-3.5-flash-lite  # პირველი სამუშაო მოდელი (Google 2026)
    - xai/grok-4                    # xAI Grok 4.7 / GrokBot API
    - ollama_chat/deepseek-r1:8b    # ლოკალური სარეზერვო

markets:
  enabled: true
  vs_currency: usd
  crypto: [bitcoin, ethereum, solana]   # CoinGecko ID-ები
  stocks: [aapl.us, msft.us, nvda.us]  # Stooq .us სუფიქსით

delivery:
  channel: telegram  # ან email

⏰ 3. ყოველდღიური გაშვება: Windows Task Scheduler

PowerShell სკრიპტი, რომელიც აგენტს ავტომატურად უშვებს ყოველ სამუშაო დღეს 07:30 საათზე:

PowerShell (Run as Administrator)
$action = New-ScheduledTaskAction `
  -Execute "C:\Users\GBASILAIA\claude\ai2026\morning-briefing\.venv\Scripts\python.exe" `
  -Argument "main.py" `
  -WorkingDirectory "C:\Users\GBASILAIA\claude\ai2026\morning-briefing"

$trigger = New-ScheduledTaskTrigger -Weekly -DaysOfWeek Monday,Tuesday,Wednesday,Thursday,Friday -At 7:30am

Register-ScheduledTask -TaskName "MorningBriefing" -Action $action -Trigger $trigger

💡 რჩევა გამორთული კომპიუტერისთვის:

Task Scheduler-ის პარამეტრებში მონიშნეთ ოფცია: „Run task as soon as possible after a scheduled start is missed“. ასე აგენტი მაშინვე გაეშვება, როგორც კი დილით ლეპტოპს ჩართავთ.

📱 4. Telegram ბოტის ინტერაქცია

აგენტი არა მხოლოდ აგზავნის დილის ბრიფინგს, არამედ მუშაობს ინტერაქტიულად Telegram ბოტად:

🧪 ტესტირება --dry-run რეჟიმით:

პირველ გაშვებამდე გამოიყენეთ python main.py --dry-run. ეს ბრძანება ამოიღებს ყველა მონაცემს, დაბეჭდავს ეკრანზე და არაფერს გააგზავნის Telegram-ში/ფოსტაზე. ასე გადაამოწმებთ, რომ ყველა API მუშაობს შეუფერხებლად.

გამოიყენეთ ეს ცოდნა თქვენს ფინალურ პროექტში!

შეარჩიეთ 20 აღმასრულებელი აგენტიდან ერთ-ერთი, მოარგეთ რეალურ ბიზნეს ამოცანას და წარმოადგინეთ მე-7 ლექციის Pitch-deck-ზე.