Gyors e-mail válaszok készítése AI segítségével a Hugging Face-szel

Szerezd meg a digitális kulcsodat (API token)

Először szerezzük be az egyedi digitális kulcsodat, az úgynevezett API tokent. Az API (Application Programming Interface) olyan, mint egy étterem digitális menüje és rendelési rendszere, lehetővé téve a különböző számítógépes programoknak, hogy kommunikáljanak egymással. Az API tokened olyan, mint a személyes, titkos VIP belépőd, amely megmondja a Hugging Face "pincérének" (az API-nak), hogy jogosult vagy rendelést leadni.

Nyisd meg a böngésződet, és menj a Hugging Face weboldalára. Jelentkezz be a fiókodba. Bejelentkezés után általában egy letisztult oldalt látsz, esetleg az aktivitási hírfolyamoddal. Keresd meg a profilképedet (általában egy kör az inicialiddal vagy a választott képeddel) a képernyő jobb felső sarkában. Kattints rá. Egy menü fog lecsúszni vagy lenyílni, ahol olyan opciókat látsz, mint a "Profil", "Beállítások" és "Kijelentkezés". Válaszd a "Beállítások" menüpontot. A következő képernyőn egy oldalsávot látsz bal oldalon különböző fiókbeállításokkal. Kattints az "Access Tokens" (Hozzáférési tokenek) menüpontra. Ezután egy "New token" (Új token) feliratú gombot látsz. Kattints rá. Egy kis ablak fog felugrani, amely részleteket kér. Adj a tokenednek egy leíró nevet, például "Email-Reply-Bot", és állítsd a Role (Szerepkör) beállítást "read"-re (olvasás). Ez az "olvasási" szerepkör azt jelenti, hogy a token csak arra jogosít fel, hogy információkat fogadj (például AI által generált szöveget), de nem módosíthatsz semmit a fiókodban. Kattints a "Generate a token" (Token generálása) gombra. Egy nagyon hosszú, véletlenszerű karaktersorozat (az API tokened) fog megjelenni a képernyőn. Azonnal másold ki ezt a tokent! A mellette lévő másolás ikonra kattinthatsz. Kezeld ezt a tokent jelszóként – miután elhagytad ezt az oldalt, nem fogod újra látni. Mentsd el valahova biztonságosan ideiglenesen, például egy egyszerű szöveges dokumentumba, mivel hamarosan szükséged lesz rá.

Ha másképp néz ki: Ha a profilképed nincs a jobb felső sarokban, keress egy általános fiókikont (például egy emberi sziluettet) vagy egy menügombot (gyakran három vízszintes vonal, néha "hamburger menünek" is hívják). A "Beállítások" vagy "Hozzáférési tokenek" kissé eltérő neveken is szerepelhetnek, de általában a fiókkezelési területeden találhatók.

Akkor tudod, hogy sikeres voltál, ha sikeresen kimásoltál egy hosszú karakterláncot, amely hf_ kezdetű (pl. hf_ABCDEF1234567890), és biztonságosan elmented.

Keress egy AI "séfet" (modellt) az e-mailedhez

Most ki kell választanod egy AI modellt, ami olyan, mintha egy konkrét séfet választanál az ételedhez. Minden modell egy egyedi számítógépes program, amelyet különböző feladatokra képeztek ki. E-mailek vázlatának elkészítéséhez egy "szöveggeneráló" modellre lesz szükséged – egy olyanra, amelyet kifejezetten arra terveztek, hogy új szöveget hozzon létre az utasításaid alapján.

Nyiss meg egy új böngészőfület, és navigálj a Hugging Face Hub oldalra. Ezen az oldalon egy hangsúlyos keresőmezőt fogsz látni, általában középen vagy a tetején. Írd be a keresőmezőbe, hogy text-generation. Gépelés közben megjelenhet egy modelllista, vagy meg kell nyomnod az Entert az eredmények megtekintéséhez. Ezután számos különböző AI modellt látsz majd. Kezdőknek jó kiindulópont a gpt2, mert jól ismert és általában hatékony különböző szöveges feladatokhoz. Láthatod még a distilgpt2-t (egy kisebb, gyorsabb verzió) vagy a microsoft/DialoGPT-medium-ot. Kattints a kiválasztott modellre (pl. kattints a gpt2 modellkártyára). A modell speciális oldalán, legfelül, látni fogod a Model ID-ját. A gpt2 esetében a Model ID egyszerűen gpt2. Jegyezd fel ezt a Model ID-t – szükséged lesz rá a következő lépéshez.

Ha másképp néz ki: Ha a text-generation nem hoz jó eredményeket, próbálj meg a bal oldalon keresni szűrőket, és válaszd a "Text Generation" opciót a "Feladatok" alatt. A legnépszerűbb modelleket gyakran először listázzák, vagy egyértelműen fel vannak címkézve.

Akkor tudod, hogy sikeres voltál, ha sikeresen feljegyezted a választott szöveggeneráló AI modell Model ID-ját (pl. gpt2).

Készítsd elő a "rendelésedet" (API kérés)

Most megfogalmazod azt a konkrét utasítást, amit el szeretnél küldeni az AI-nak. Ezt az utasítást promptnak nevezzük. Az API tokenedet, a modell azonosítóját és a promptot egyetlen parancsba fogod összeállítani a curl (ejtsd: "körl") nevű eszköz segítségével. A curl egy gyakori módja annak, hogy kéréseket küldj a számítógéped termináljából webes szolgáltatásoknak, mint például a Hugging Face API-ja.

Nyisd meg a számítógéped terminálját. Windowson a Start menüben rákereshetsz a "Parancssor" vagy "PowerShell" kifejezésekre. Macen vagy Linuxon keresd a "Terminál" alkalmazást. Miután megnyílt, egy villogó kurzorral ellátott ablakot látsz, amely készen áll a bemenetre. Egy curl parancsot fogunk használni, ami egy speciális kódsor, amely elküldi a kérésedet. A parancsod a következőket fogja tartalmazni:

• -X POST: Ez azt jelenti a Hugging Face-nek, hogy adatokat küldesz (például rendelést adsz le).
• -H "Authorization: Bearer YOUR_API_TOKEN": Ez tartalmazza a VIP belépődet (API tokent), hogy megerősítse, jogosult vagy a kérés leadására.
• -H "Content-Type: application/json": Ez azt mondja a Hugging Face-nek, hogy JSON (JavaScript Object Notation) formátumban küldesz információt, ami egy strukturált módja a számítógépes programok közötti adatcserének.
• -d '{ "inputs": "YOUR PROMPT", "parameters": { "max_new_tokens": 50, "return_full_text": false } }': Ez a tényleges adat, amit küldesz. Az "inputs" tartalmazza a promptodat (az utasítást az AI számára). A "parameters" extra utasítások, mint például a "max_new_tokens": 50 (kb. 50 új szövegegység, úgynevezett token kérése – egy token nagyjából négy karakter) és a "return_full_text": false (ami biztosítja, hogy az AI csak a generált választ küldje vissza, az eredeti promptodat ne).
• https://api-inference.huggingface.co/models/YOUR_MODEL_ID: Ez az AI "konyha" webcíme, ahol a kiválasztott modelled vár.

Ki kell cserélned a YOUR_API_TOKEN részt a tényleges tokeneddel az 1. lépésből, és a YOUR_MODEL_ID részt a modell azonosítójával a 2. lépésből.

Ha másképp néz ki: Győződj meg róla, hogy a terminálod készen áll a parancsok fogadására. Néhány céges hálózat blokkolhatja a curl parancsokat. Ha olyan hibákat tapasztalsz, mint "parancs nem található", akkor kapcsolatba kell lépned az IT részleggel, vagy meg kell próbálnod egy másik számítógépet.

Akkor tudod, hogy sikeres voltál, ha van egy teljes curl parancsstringed (mint az alábbi példában), amely tartalmazza a tényleges API tokenedet és a kiválasztott modell azonosítóját, készen arra, hogy kimásold és beilleszd a terminálba.

curl -X POST \
  -H "Authorization: Bearer hf_YOURUNIQUEKEY123" \
  -H "Content-Type: application/json" \
  -d '{ "inputs": "Az ügyfél elégedetlen a szolgáltatással és visszatérítést kér. Fogalmazz meg egy udvarias és empatikus választ.", "parameters": { "max_new_tokens": 80, "return_full_text": false } }' \
  https://api-inference.huggingface.co/models/gpt2

Küldd el a rendelésedet az AI "konyhába"

Miután elkészült a teljes curl parancsod, ideje elküldeni. Óvatosan másold ki a teljes parancsot, beleértve a curl szót az elején és a modell URL-jét a végén. Ezután térj vissza a nyitott terminálablakodhoz.

Illeszd be a teljes curl parancsot a terminálablakba a villogó kurzorhoz. Beillesztés után nyomd meg az Enter billentyűt a billentyűzeteden. Ezután a számítógéped elküldi ezt a kérést az interneten keresztül a Hugging Face-nek. Az AI ezután feldolgozza a kérésedet – ezt a folyamatot inferenciának nevezzük. Eltarthat néhány másodpercig, különösen az első alkalommal, amikor egy adott modellt használsz, vagy ha a Hugging Face-nek "be kell töltenie" a modellt a szervereire számodra. A terminálablak általában rövid ideig üres marad, miközben várakozik a válaszra.

Ha másképp néz ki: Ha hosszú ideig (több mint 20-30 másodpercig) semmi sem történik, vagy azonnal hibát látsz, például "Kapcsolat megtagadva", ellenőrizd újra az internetkapcsolatodat, és győződj meg arról, hogy a curl parancsod pontosan úgy van beírva, ahogy az a leírásban szerepel, hiányzó idézőjelek vagy karakterek nélkül. A lassú válasz egyszerűen azt jelentheti, hogy a modellnek egy pillanatot vesz igénybe a betöltése.

Akkor tudod, hogy sikeres voltál, ha rövid várakozás után a terminálablakban új szöveg jelenik meg. Ez a szöveg általában egy szögletes zárójellel [ vagy egy nyitó kapcsos zárójellel { kezdődik, jelezve, hogy adatok érkeztek.

Olvasd el az AI "válaszát" (e-mail vázlat)

Rövid várakozás után szöveg jelenik meg a terminálban. Ez JSON (JavaScript Object Notation) formátumban lesz, ami egy szabványos, szervezett módja annak, hogy a programok adatokat küldjenek egymásnak. Elsőre talán kicsit bonyolultnak tűnik, de ne aggódj – egy konkrét részét keresed.

A JSON kimenet jellemzően egy listát ( [] jelzi) fog mutatni, amely egy vagy több objektumot ( {} jelzi) tartalmaz. Ezen objektumok egyikében találod a "generated_text" kulcsot. Az e kulcsot közvetlenül követő szöveg, kettős idézőjelek között, az AI által megfogalmazott e-mail válasz. Például, valami ilyesmit láthatsz: \"generated_text\": \"Kedves [Ügyfél neve],\\n\\nKöszönjük, hogy megkeresett minket...\" (az \n új sort jelent, a \\ pedig egyetlen \ karaktert). Olvasd át ezt a generált szöveget. Kijelölheted és kimásolhatod a szöveget az idézőjelek között a "generated_text" után.

Ha másképp néz ki: Ha JSON helyett hibaüzeneteket látsz, térj vissza, és gondosan ellenőrizd a 3. lépést az API tokenedben, a modell azonosítójában vagy a JSON adatstruktúrájában előforduló elgépelések (különösen az idézőjelek) tekintetében. Néha egy nagyon rövid max_new_tokens nagyon rövid vagy hiányos választ eredményezhet.

Akkor tudod, hogy sikeres voltál, ha egyértelműen azonosítani és kimásolni tudod az AI által generált e-mail szöveget a terminál kimenetének \"generated_text\": szakaszából. Ezután beillesztheted ezt a szöveget az e-mail programodba, személyre szabhatod nevekkel, specifikus részletekkel és a márkád hangjával, mivel az AI csak általános vázlatot biztosít.