Salt la conținutul principal
Română— Alege o limbă
Meniu

Agents SDK: Instalare și primul dumneavoastră agent

Lecția 4 din 25 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Agents SDK: Instalare și primul dumneavoastră agent
  2. Condiții prealabile
  3. Instalare
  4. Primul dumneavoastră agent
  5. Execuție asincronă
  6. Execuție prin streaming
  7. Structura proiectului de agent
  8. Puncte cheie

Agents SDK: Instalare și primul dumneavoastră agent

Să trecem la cod. Veți instala SDK-ul oficial Agents de la OpenAI, veți construi un agent Python funcțional și veți explora cele trei moduri de execuție pe care le veți utiliza pe tot parcursul acestui curs.

Condiții prealabile

Aveți nevoie doar de trei lucruri: Python 3.10+ instalat pe mașina dumneavoastră, un cont OpenAI cu o cheie API activă și un editor de cod. Vă recomandăm VS Code, dar orice editor cu evidențierea sintaxei Python funcționează perfect.

Instalare

Pachetul se numește openai-agents. Atenție: instalarea doar a pachetului openai vă oferă clientul API clasic, nu și SDK-ul Agents.

pip install openai-agents

Acest pachet instalează automat dependențele necesare, inclusiv SDK-ul Python pentru OpenAI. În continuare, setați cheia API ca variabilă de mediu. SDK-ul o citește automat, deci nu este necesară nicio configurare suplimentară.

export OPENAI_API_KEY="sk-proj-your-api-key"

Această comandă dispare când închideți terminalul și, cu siguranță, nu doriți să codificați manual cheia în fișierele sursă. Pentru o configurare corectă a proiectului, utilizați un fișier .env cu python-dotenv și adăugați acel fișier la .gitignore înainte de primul commit.

pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key

Primul dumneavoastră agent

Creați un fișier numit my_first_agent.py:

from agents import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant. Respond in English concisely.",
    model="gpt-5.6-terra",
)

result = Runner.run_sync(agent, "Explain what an AI agent is in three sentences.")
print(result.final_output)

Rulați-l:

python my_first_agent.py

Tocmai ați creat și rulat primul dumneavoastră agent. Este simplu – fără instrumente, fără mecanisme de siguranță – dar constituie fundamentul pentru tot restul. Restul acestui curs se bazează doar pe aceste două obiecte: Agent și Runner.

Execuție asincronă

run_sync blochează firul de execuție curent până la sosirea răspunsului. Acest lucru este acceptabil pentru un script de test, dar inacceptabil pentru un server web care gestionează sute de cereri concurente. În producție, veți utiliza modul asincron.

import asyncio
from agents import Agent, Runner

agent = Agent(
    name="Async Assistant",
    instructions="You are a helpful assistant. Respond in English.",
    model="gpt-5.6-terra",
)

async def main():
    result = await Runner.run(agent, "What are the advantages of Python for AI?")
    print(result.final_output)

asyncio.run(main())

Runner.run() este versiunea asincronă; Runner.run_sync() este un wrapper sincron care o apelează pentru dumneavoastră. Când utilizați FastAPI sau orice alt cadru asincron, folosiți întotdeauna Runner.run().

Execuție prin streaming

Există un al treilea mod, esențial ori de câte ori un utilizator așteaptă în fața ecranului. Streaming-ul afișează răspunsul pe măsură ce este generat, token cu token.

import asyncio
from agents import Agent, Runner

agent = Agent(
    name="Streaming Assistant",
    instructions="You are a helpful assistant. Respond in English.",
    model="gpt-5.6-terra",
)

async def main():
    result = Runner.run_streamed(agent, "Tell a short story about AI.")
    async for event in result.stream_events():
        if event.type == "raw_response_event":
            if hasattr(event.data, "delta") and event.data.delta:
                print(event.data.delta, end="", flush=True)
    print()  # New line at the end

asyncio.run(main())

Bucla async for consumă un flux de evenimente. Aici, filtrăm evenimentele brute de răspuns ale modelului și afișăm doar fragmentele de text. Streaming-ul este critic pentru experiența utilizatorului: nimeni nu vrea să se uite la un ecran gol timp de 10 secunde.

Structura proiectului de agent

Un agent de producție nu încap într-un singur fișier. Separați definițiile agenților, instrumentele și testele încă de la început, altfel fișierul main.py va deveni rapid ilizibil.

my-agent-project/
├── .env                 # API key
├── requirements.txt     # Dependencies
├── agents/
│   ├── __init__.py
│   ├── assistant.py     # Agent definition
│   └── tools.py         # Tool definitions
├── main.py              # Entry point
└── tests/
    └── test_agent.py    # Tests
# requirements.txt
openai-agents>=0.1.0
python-dotenv>=1.0.0

Puncte cheie

  • Instalați SDK-ul cu pip install openai-agents
  • Setați OPENAI_API_KEY ca variabilă de mediu
  • Utilizați Runner.run_sync() pentru dezvoltare și Runner.run() pentru producție asincronă
  • Utilizați Runner.run_streamed() pentru streaming în timp real
  • Structurați proiectul cu foldere separate pentru agenți, instrumente și teste