Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Agents SDK: Telepítés és az első ágensed

4. lecke 25 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Agents SDK: Telepítés és az első ágensed
  2. Előfeltételek
  3. Telepítés
  4. Az első ágensed
  5. Aszinkron végrehajtás
  6. Streamelt végrehajtás
  7. Ágens projektstruktúra
  8. Főbb megállapítások

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-agents paranccsal
  • Állítsd be az OPENAI_API_KEY változót környezeti változóként
  • Használd a Runner.run_sync() módszert fejlesztéshez, a Runner.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