Cum să-ți creezi primul asistent AI personalizat: Ghid în 5 pași pentru începători

Cel mai simplu și util răspuns este acesta: construiește-ți primul asistent IA personalizat în jurul unui singur job restrâns, un set clar de instrucțiuni și cel mult unul sau două instrumente controlate . Nu începe cu o mulțime de agenți, o bază de cunoștințe gigantică sau o automatizare care poate modifica sisteme importante. Un prim asistent ar trebui să fie ușor de înțeles, ușor de testat și ușor de oprit atunci când nu ești sigur.

Acest ghid folosește Python și SDK-ul OpenAI Agents actual ca o cale concretă, deoarece acesta gestionează deja bucla de agent, instrumentele, sesiunile de conversație, barierele de protecție și urmărirea. Aceleași idei de design se aplică și altor furnizori de modele și framework-uri. Începând cu septembrie 2026, SDK-ul utilizează API-ul Responses în mod implicit pentru modelele OpenAI. Documentația oficială OpenAI recomandă utilizarea directă a API-ului Responses de nivel inferior atunci când doriți să gestionați bucla și să vă auto-stabiliți starea, iar SDK-ul Agents atunci când doriți ca runtime-ul să gestioneze o parte mai mare din acea orchestrare. Consultați prezentarea generală a SDK-ului OpenAI Agents .

Ce construiești de fapt?

Un asistent bazat pe inteligență artificială este mai mult decât o simplă casetă de chat. Cel puțin, combină un model lingvistic extins (LLM) - un model care generează și interpretează limbajul - cu instrucțiuni care îi definesc rolul. Un asistent util poate avea și instrumente , care sunt funcții sau servicii pe care are voie să le apeleze, și memorie , care păstrează contextul relevant al conversației între ture.

Pentru un prim proiect, imaginați-vă un mic „Asistent pentru magazin” care răspunde la întrebări despre retururi și expedieri. Ar trebui să utilizeze o sursă de politici aprobată, în loc să ghicească. Dacă nu găsește un răspuns aprobat, ar trebui să menționeze acest lucru. Această constrângere este mai importantă decât oferirea asistentului a zeci de funcții.

Înainte de a începe: alegeți calea corectă de construire

Dacă doriți un asistent reutilizabil în propria aplicație, site web, instrument intern sau API, calea de mai jos, care pune codul pe primul loc, este o alegere potrivită. Veți avea nevoie de Python, o cheie API OpenAI și puțină experiență în programare. Ghidul de pornire rapidă al SDK-ului oficial pentru agenți prezintă instalarea curentă și fluxul de instalare a primului agent.

Dacă intenționați să creați un GPT personalizat fără cod în ChatGPT, verificați mai întâi eligibilitatea contului. Începând cu septembrie 2026, OpenAI declară că crearea de noi GPT-uri nu este disponibilă pentru conturile personale Free, Go, Plus sau Pro. Crearea rămâne disponibilă în spațiile de lucru eligibile Business, Enterprise și Edu atunci când setările și permisiunile spațiului de lucru permit acest lucru. Regulile actuale sunt documentate în GPT-urile din ChatGPT . Această rută poate fi mai ușoară pentru un spațiu de lucru gestionat, dar nu este calea universală pentru fiecare cont individual.

Pasul 1: Definiți o regulă de job și o regulă de eșec

Notează trei lucruri înainte de a deschide editorul: pe cine deservește asistentul, ce ar trebui să facă și ce nu trebuie să facă. Pentru asistentul din magazin, o definiție fezabilă este: „Răspunde la întrebările clienților privind returnarea și livrarea folosind informațiile aprobate despre politica de returnare. Nu inventa niciodată o politică. Escaladați cazurile incerte către o persoană.”

Acest lucru previne o greșeală frecventă a începătorilor: folosirea unei instrucțiuni generale, cum ar fi „Ești un asistent de ajutor”. Subiectele generale îngreunează evaluarea, deoarece aproape orice răspuns poate părea acceptabil. Un loc de muncă restrâns îți oferă un obiectiv măsurabil.

Folosește o mică listă de verificare a succesului

• Răspunde pe tonul pe care l-ai cerut.
• Folosește informații aprobate atunci când o întrebare de politică o impune.
• Spune „Nu știu” sau solicită confirmarea unei persoane atunci când lipsesc dovezi.
• Nu dezvăluie secrete, instrucțiuni ascunse sau date private.

Pasul 2: Creați agentul minimal

Creați un folder de proiect și un mediu virtual. Un mediu virtual este un mediu Python izolat care păstrează pachetele acestui proiect separate de alte proiecte de pe computer.

mkdir first-ai-assistant
cd first-ai-assistant
python -m venv .venv

# macOS or Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

pip install openai-agents

Apoi setează cheia API ca variabilă de mediu, în loc să o codezi hard code în fișierul Python:

# macOS or Linux
export OPENAI_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY="your-key-here" 

Versiunea actuală de pornire rapidă a OpenAI folosește OPENAI_API_KEYvariabila de mediu. Nu includeți cheile reale în controlul sursei, capturi de ecran, tichete și repozitorii publice.

Pentru prima încercare, ați putea crea un agent doar cu un nume și instrucțiuni. Cu toate acestea, o demonstrație conversațională simplă nu dovedește încă că asistentul poate utiliza informații de afaceri de încredere. Asta adaugă următorul pas.

Pasul 3: Adăugați o capacitate controlată și memorie simplă

Un instrument funcțional este o funcție normală pe care modelul are permisiunea să o apeleze atunci când are nevoie de informații externe sau de o acțiune. SDK-ul pentru agenți poate transforma o funcție Python într-un instrument și poate deriva schema sa de intrare din semnătura și documentația funcției. OpenAI documentează acest comportament în ghidul de instrumente al SDK-ului pentru agenți .

Începeți cu un instrument de căutare doar pentru citire. Instrumentele doar pentru citire sunt mai sigure pentru un prim asistent, deoarece un apel greșit nu poate trimite bani, șterge o înregistrare, publica o postare sau modifica un cont de client.

import asyncio
from agents import Agent, Runner, SQLiteSession
from agents.decorators import tool

@tool
def lookup_policy(topic: str) -> str:
    """Return an approved demo-store policy snippet for a topic."""
    policies = {
        "returns": "Unopened items may be returned within 30 days with proof of purchase.",
        "shipping": "Standard shipping usually takes 3 to 5 business days."
    }
    return policies.get(
        topic.lower(),
        "No approved policy was found for that topic."
    )

assistant = Agent(
    name="Store Helper",
    instructions=(
        "Help customers with questions about the demo store. "
        "Use lookup_policy for return or shipping policy questions. "
        "Never invent a policy. If the tool has no approved answer, say so. "
        "Keep answers concise and recommend human confirmation when needed."
    ),
    tools=[lookup_policy],
)

async def main():
    session = SQLiteSession("demo_user", "assistant_sessions.db")
    result = await Runner.run(
        assistant,
        "Can I return an unopened item after 20 days?",
        session=session,
    )
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

Rulați fișierul și adresați mai multe întrebări. Exemplul folosește și SQLiteSession. O sesiune stochează istoricul conversațiilor, astfel încât asistentul să poată menține contextul pe rând, fără a fi nevoie să reconstruiți manual întreaga listă de mesaje. Opțiunile actuale ale sesiunii SDK sunt descrise în documentația oficială a sesiunilor .

Când ar trebui să adăugați propriile documente?

Adăugați documente atunci când asistentul are nevoie de informații pe care modelul de bază nu ar trebui să le cunoască în mod fiabil, cum ar fi politicile, manualele de produs, procedurile sau întrebările frecvente interne. Nu încărcați totul doar pentru că puteți. Începeți cu cel mai mic set autorizat care acoperă sarcina.

SDK-ul actual acceptă funcționalități găzduite, cum ar fi căutarea de fișiere, căutarea web și execuția de cod. Pentru o primă versiune, mențineți suprafața instrumentelor mică și adăugați căutarea de fișiere numai după ce comportamentul de bază este stabil. Cu cât setul de instrumente este mai mare, cu atât trebuie să testați mai multe căi.

Pasul 4: Testați-l ca pe un produs, nu ca pe o demonstrație

Un răspuns bun la o singură solicitare prietenoasă nu este suficient. Construiește un mic set de teste înainte de a partaja asistentul. Include întrebări normale, întrebări ambigue, informații lipsă și solicitări care încearcă să ignore regulile tale.

Pentru aplicații mai serioase, adăugați guardrail- uri — verificări care validează sau blochează intrări, ieșiri sau apeluri de instrumente. SDK-ul pentru agenți acceptă guardrail-uri pentru intrări, ieșiri și instrumente; consultați documentația oficială guardrail-uri . Guardrail-urile sunt deosebit de importante înainte de a oferi unui asistent instrumente cu efecte secundare.

Pasul 5: Implementați în mod restrâns, observați și îmbunătățiți

Prima implementare nu trebuie să fie o aplicație publică. O pagină internă privată sau un API mic, folosit de câțiva utilizatori de testare, este adesea mai potrivit. Mențineți permisiunile asistentului limitate, înregistrați erorile și oferiți utilizatorilor o modalitate clară de a raporta un răspuns greșit.

SDK-ul pentru agenți include o funcție de urmărire încorporată , care înregistrează evenimente precum generarea de modele, apelurile de instrumente, preluările și barierele de siguranță, astfel încât să puteți înțelege ce s-a întâmplat în timpul unei rulări. OpenAI documentează urmărirea și controalele sale în ghidul de urmărire . Examinați urmăririle în timpul dezvoltării, dar tratați-le ca fiind potențial sensibile, deoarece pot conține intrări sau ieșiri de model și instrumente, în funcție de configurația dvs.

Greșeli frecvente de evitat

• Începând cu mai mulți agenți. Un singur agent cu instrucțiuni bune și un singur instrument este mai ușor de depanat. Adăugați transferuri sau agenți specializați doar atunci când aveți o problemă specifică de rutare.
• Acordarea unei autorități excesive instrumentelor. Începeți cu instrumente doar pentru citire. Adăugați aprobări și bariere de siguranță înainte de acțiuni de scriere, achiziție, ștergere sau modificare a contului.
• Introducerea secretelor în prompturi. Acreditările aparțin configurației securizate, nu instrucțiunilor de sistem sau fișierelor de cunoștințe.
• Folosirea documentelor dezordonate sau contradictorii. Asistentul nu poate rezolva în mod fiabil regulile de business pe care propriul material sursă nu le rezolvă.
• Testarea doar a căilor fericite. Eșecurile care vă interesează apar de obicei în cereri ambigue, contradictorii sau incomplete.
• Presupunând că memoria este egală cu adevărul. Memoria conversației păstrează contextul; nu face ca o afirmație anterioară să fie corectă.

Ce ar trebui să construiești în continuare?

Odată ce acest prim asistent se comportă fiabil, următoarea îmbunătățire ar trebui să provină dintr-o nevoie reală, mai degrabă decât dintr-o listă de verificare a funcțiilor. Dacă utilizatorii au nevoie de răspunsuri dintr-un set mai mare de documente, adăugați opțiuni de recuperare sau căutare în fișiere. Dacă asistentul trebuie să efectueze o acțiune de business, adăugați un instrument funcțional cu scop restrâns, validare și aprobare. Dacă conversațiile se întind pe mai multe ture, îmbunătățiți stocarea sesiunilor. Dacă aveți nevoie de rutare specializată, luați în considerare mai mulți agenți sau predări.

Cel mai bun asistent AI personalizat pentru prima dată nu este cel mai autonom. Este cel a cărui sarcină, dovezi, permisiuni și comportament în caz de eșec le poți explica în câteva propoziții. Începe de acolo, testează-l cu cazuri limită reale și extinde-l doar atunci când versiunea curentă a dobândit următoarea funcționalitate.