Agents SDK: Namestitev in vaš prvi agent
Na tej strani
Agents SDK: Namestitev in vaš prvi agent
Preidimo na kodiranje. Namestil boš uradni SDK za agente podjetja OpenAI, zgradil delujočega agenta v Pythonu in raziskal tri načine izvajanja, ki jih boš uporabljal skozi celoten tečaj.
Predpogoji
Potrebuješ le tri stvari: nameščen Python 3.10+ na svojem računalniku, račun OpenAI z aktivnim ključem API in urejevalnik kode. Priporočamo VS Code, vendar deluje kateri koli urejevalnik s poudarjanjem sintakse Python.
Namestitev
Paket se imenuje openai-agents. Pozor: namestitev samega paketa openai ti da klasičnega odjemalca API, ne pa SDK za agente.
pip install openai-agents
Ta paket samodejno namesti zahtevane odvisnosti, vključno s Python SDK za OpenAI. Nato nastavi svoj ključ API kot spremenljivko okolja. SDK ga samodejno prebere, zato dodatna konfiguracija ni potrebna.
export OPENAI_API_KEY="sk-proj-your-api-key"
Ta ukaz izgine, ko zapreš terminal, svojega ključa pa zagotovo ne želiš trdno kodirati v izvorne datoteke. Za pravilno nastavitev projekta uporabi datoteko .env s knjižnico python-dotenv in to datoteko dodaj v .gitignore pred prvo potrditvijo.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
Vaš prvi agent
Ustvari datoteko z imenom 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)
Zaženi ga:
python my_first_agent.py
Pravkar si ustvaril in zagnal svojega prvega agenta. Preprost je – brez orodij, brez varoval – vendar tvori temelj za vse ostalo. Preostanek tega tečaja gradi le na teh dveh objektih: Agent in Runner.
Asinhrono izvajanje
run_sync blokira trenutno nit, dokler ne prispe odgovor. To je v redu za testno skripto, nesprejemljivo pa za spletni strežnik, ki obravnava na stotine sočasnih zahtevkov. V proizvodnem okolju boš uporabil asinhroni način.
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() je asinhrona različica; Runner.run_sync() je sinhroni ovitek, ki jo pokliče namesto tebe. Ko uporabljaš FastAPI ali kateri koli drug asinhroni okvir, vedno uporabi Runner.run().
Izvajanje s pretokom (Streaming)
Obstaja tretji način, ki je bistven, kadar človek čaka pred zaslonom. Pretok prikazuje odgovor med njegovim generiranjem, žeton za žetonom.
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())
Zanka async for porabi tok dogodkov. Tu filtriramo surove dogodke odziva modela in natisnemo le besedilne fragmente. Pretok je ključen za uporabniško izkušnjo: nihče noče 10 sekund strmeti v prazen zaslon.
Struktura projekta z agenti
Proizvodni agent ne sodi v eno samo datoteko. Od samega začetka loči definicije agentov, orodja in teste, sicer bo tvoja main.py hitro postala neberljiva.
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
Ključne ugotovitve
- Namesti SDK z ukazom
pip install openai-agents - Nastavi
OPENAI_API_KEYkot spremenljivko okolja - Uporabi
Runner.run_sync()za razvoj inRunner.run()za asinhrono proizvodno okolje - Uporabi
Runner.run_streamed()za pretok v realnem času - Strukturiraj svoj projekt z ločenimi mapami za agente, orodja in teste