A zárt AI csapdája
A legtöbb vállalati AI projekt ugyanott akad el: az LLM okos, de nem lát ki a saját rendszeréből. Nem tudja, milyen emailek jöttek. Nem látja a naptárat. Nem ismeri a CRM-ben lévő ügyfeleket. Nem tud számlát kiállítani.
Az eredmény: egy chatablak, amibe a felhasználó kézzel másolja be az információt — az AI-t digitális titkárnőként használja, ahelyett hogy az autonóm asszisztensként dolgozna.
A megoldás: AI connector-ok — strukturált integrációk, amelyek lehetővé teszik, hogy az AI ágens közvetlenül kommunikáljon külső rendszerekkel.
Mi az AI connector?
Az AI connector egy kétirányú híd az AI ágens és egy külső rendszer között:
Külső rendszer Connector AI ágens
(Gmail, Calendar, ┌──────────────┐
Számlázz.hu, ...) │ Normalizál │──▶ Feldolgozás
│ + Triggerel │ (Evaluator)
API / Webhook ◀──── │ │
│ MCP Tools │◀── Cselekvés
└──────────────┘ (Executor)
Két irány, két funkció:
- Inbound (külső → AI): Adatok fogadása, normalizálása, és az AI ágens értesítése (webhook, polling, full sync)
- Outbound (AI → külső): Az AI ágens cselekszik a külső rendszerben (MCP/Tool hívás, OAuth2 delegálás)
Az 5 connector-architekturális pattern
Best practice: a produkciós rendszerek mindig hybrid-ot használnak. A webhook kieshet (DNS hiba, szerver restart, rate limit). A polling biztosítja, hogy semmi ne vesszen el.
A normalizálás: a connector legfontosabb feladata
A legnagyobb hiba, amit CTO-k elkövetnek: a nyers API adatot közvetlenül az LLM-nek adják. Egy Gmail API válasz 200+ mezőt tartalmaz — a legtöbb irreleváns. Az LLM token-t pazarol, és rosszabb válaszokat ad.
Normalizálás előtt (nyers Gmail API):
{
"id": "18f3a2b1c4d5e6f7",
"threadId": "18f3a2b1c4d5e6f7",
"labelIds": ["INBOX", "UNREAD"],
"payload": {
"headers": [
{ "name": "From", "value": "Kiss Anna <anna@example.com>" },
{ "name": "Subject", "value": "Re: Időpont módosítás" }
]
}
}
Normalizálás után (ágens-kész formátum):
{
"source": "gmail",
"eventType": "email.received",
"entities": [
{ "type": "email", "label": "Re: Időpont módosítás" },
{ "type": "client", "label": "Kiss Anna" }
],
"edges": [
{ "from": "email", "to": "client", "type": "SENT_BY" }
],
"textContent": "Kiss Anna emailt küldött: Időpont módosítás holnap 17:00-ra."
}
A normalizált formátum entitásokat extrahál, kapcsolatokat definiál, embedding-kész szöveget generál, és forrásrendszer-függetlenné teszi az adatot.
Az MCP Tool-ok: a connector kifelé néző arca
Az inbound mellett a connector outbound képességeket is publikál — MCP tool-ok formájában:
A tool-ok dinamikusan regisztrálódnak: ha a felhasználó bekapcsol egy connector-t, az AI ágens automatikusan „megtanulja", hogy új képessége van. Kikapcsoláskor a képesség eltűnik — nincs kódmódosítás, nincs újraindítás.
Az OAuth2 komplexitás: a connector rejtett költsége
A connector-integráció 80%-a nem a funkció, hanem az autentikáció. A modern SaaS API-k OAuth2-t használnak:
1. Felhasználó → OAuth consent screen → Engedély
2. Authorization code → Access token + Refresh token
3. Access token lejár (1 óra) → Refresh token → Új access token
4. Refresh token lejár (6 hónap) → Felhasználó újra jóváhagy
A tipikus hibák: token refresh race condition, revoked token detektálás hiánya, túl sok scope kérése (az ügyfél nem bízik meg), token plain text tárolása (GDPR kockázat).
Best practice: minimális scope, titkosított token-tárolás, centralizált refresh, 401-re automatikus re-auth flow.
A 2025-ös connector-ökoszisztéma
A trend: a connector-ok egyre inkább szabványos interface-en (MCP) publikálják a képességeiket. Egy MCP-kompatibilis connector bármilyen MCP-támogató ágens-keretrendszerrel működik — vendor lock-in nélkül.
CTO checklist: connector-architektúra tervezéséhez
Összefoglalás
Az AI connector a láthatatlan infrastruktúra, ami a „tud válaszolni" és a „megoldja a problémát" közötti különbséget jelenti. Nem szexis, nem demo-képes — de nélküle az AI ágens csak egy okosabb chatbot.
A jó connector-architektúra: kétirányú (fogad ÉS cselekszik), normalizál (entitások, kapcsolatok, embedding-kész szöveg), dinamikus (runtime képesség-regisztráció), és megbízható (hybrid push/pull, idempotens, graceful degradation).
Ha az AI ágens az agy, a connector a kéz és a szem — nélküle nem lát és nem tud cselekedni.
Szeretné összekötni az AI ágensét a valós üzleti rendszereivel?
Az Atlosz csapata megtervezi és megvalósítja az AI connector-architektúrát — Gmail, Calendar, CRM, Számlázz.hu és egyéb integrációkkal, OAuth2 lifecycle kezeléssel, normalizálással.