Agents SDK: Telepítés és az első ágensed
Ezen az oldalon
Agents SDK: Telepítés és az első ágensed
Kezdjük a kódolást. Telepíted az OpenAI hivatalos Agents SDK-ját, felépítesz egy működő Python ágenst, és felfedezed azt a három végrehajtási módot, amelyet a kurzus során végig használni fogsz.
Előfeltételek
Csak három dologra van szükséged: Python 3.10+ telepítve a gépedre, egy OpenAI-fiók aktív API-kulccsal, és egy kódszerkesztő. A VS Code-ot ajánljuk, de bármilyen szerkesztő megfelel, amely támogatja a Python szintaxiskiemelést.
Telepítés
A csomag neve openai-agents. Figyelj: ha csak az openai csomagot telepíted, a klasszikus API-klienst kapod meg, nem az Agents SDK-t.
pip install openai-agents
Ez a csomag automatikusan telepíti a szükséges függőségeket, beleértve az OpenAI Python SDK-t is. Ezután állítsd be az API-kulcsodat környezeti változóként. Az SDK automatikusan beolvassa ezt, így nincs szükség további konfigurációra.
export OPENAI_API_KEY="sk-proj-your-api-key"
Ez a parancs eltűnik, amikor bezárod a terminált, és természetesen nem szeretnéd a kulcsodat közvetlenül a forráskódba írni. Egy megfelelő projektbeállításhoz használj egy .env fájlt a python-dotenv segítségével, és ezt a fájlt add hozzá a .gitignore listához az első commit előtt.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
Az első ágensed
Hozz létre egy my_first_agent.py nevű fájlt:
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)
Futtasd le:
python my_first_agent.py
Éppen most hoztad létre és futtattad az első ágensedet. Egyszerű – nincs benne eszköz, nincs biztonsági korlát –, de ez alkotja az alapját minden másnak. A kurzus hátralévő része csupán erre a két objektumra épít: az Agent-re és a Runner-re.
Aszinkron végrehajtás
A run_sync blokkolja az aktuális szálat mindaddig, amíg a válasz meg nem érkezik. Ez egy tesztscriptnél rendben van, de elfogadhatatlan egy webkiszolgálónál, amelynek egyszerre százakkal kell kezelnie a kéréseket. Éles környezetben aszinkron módot fogsz használni.
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())
A Runner.run() az aszinkron változat; a Runner.run_sync() egy szinkron burkoló, amely helyetted hívja meg ezt. Ha FastAPI-t vagy bármilyen más aszinkron keretrendszert használsz, mindig a Runner.run() függvényt alkalmazd.
Streamelt végrehajtás
Van egy harmadik mód is, amely elengedhetetlen, amikor egy ember várakozik a képernyő előtt. A streamelés során a válasz tokenről tokenre jelenik meg, ahogy generálódik.
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() # Új sor a végén
asyncio.run(main())
Az async for ciklus fogyasztja az eseményfolyamot. Itt kiszűrjük a nyers modellválasz eseményeket, és csak a szövegrészleteket írjuk ki. A streamelés kritikus fontosságú a felhasználói élmény szempontjából: senki sem szeret 10 másodpercig egy üres képernyőt bámulni.
Ágens projektstruktúra
Egy éles környezeti ágens nem fér el egyetlen fájlban. Kezdettől fogva válaszd szét az ágensdefiníciókat, az eszközöket és a teszteket, különben a main.py fájlod gyorsan olvashatatlanná válik.
my-agent-project/
├── .env # API kulcs
├── requirements.txt # Függőségek
├── agents/
│ ├── __init__.py
│ ├── assistant.py # Ágens definíció
│ └── tools.py # Eszköz definíciók
├── main.py # Belépési pont
└── tests/
└── test_agent.py # Tesztek
# requirements.txt
openai-agents>=0.1.0
python-dotenv>=1.0.0
Főbb megállapítások
- Telepítsd az SDK-t a
pip install openai-agentsparanccsal - Állítsd be az
OPENAI_API_KEYváltozót környezeti változóként - Használd a
Runner.run_sync()módszert fejlesztéshez, aRunner.run()módszert pedig aszinkron éles környezethez - Alkalmazd a
Runner.run_streamed()módszert valós idejű streameléshez - Strukturáld a projektedet külön mappákba rendezve az ágenseket, eszközöket és teszteket