Agents SDK: Instalare și primul dumneavoastră agent
Pe această pagină
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_KEYca variabilă de mediu - Utilizați
Runner.run_sync()pentru dezvoltare șiRunner.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