Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Agents SDK: Inštalácia a váš prvý agent

Lekcia 4 z 25 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Agents SDK: Inštalácia a váš prvý agent
  2. Predpoklady
  3. Inštalácia
  4. Tvoj prvý agent
  5. Asynchrónne vykonávanie
  6. Streamovacie vykonávanie
  7. Štruktúra projektu agenta
  8. Kľúčové poznatky

Agents SDK: Inštalácia a váš prvý agent

Poďme kódovať. Nainštaluješ oficiálny Agents SDK od OpenAI, vytvoríš funkčného Python agenta a preskúmaš tri režimy vykonávania, ktoré budeš používať počas celého tohto kurzu.

Predpoklady

Potrebuješ len tri veci: nainštalovaný Python 3.10+ na svojom počítači, účet OpenAI s aktívnym API kľúčom a kódový editor. Odporúčame VS Code, ale funguje akýkoľvek editor so zvýrazňovaním syntaxe pre Python.

Inštalácia

Balík sa volá openai-agents. Pozor: inštalácia samotného openai ti poskytne klasického API klienta, nie Agents SDK.

pip install openai-agents

Tento balík automaticky nainštaluje požadované závislosti vrátane Python SDK pre OpenAI. Ďalej nastav svoj API kľúč ako premennú prostredia. SDK si ju prečíta automaticky, takže nie je potrebná žiadna ďalšia konfigurácia.

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

Tento príkaz zmizne po zatvorení terminálu a určite nechceš mať svoj kľúč natvrdo zakódovaný v zdrojových súboroch. Pre správne nastavenie projektu použij súbor .env s knižnicou python-dotenv a pred prvým commitom pridaj tento súbor do .gitignore.

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

Tvoj prvý agent

Vytvor súbor s názvom 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)

Spusti ho:

python my_first_agent.py

Práve si vytvoril a spustil svojho prvého agenta. Je to jednoduché – žiadne nástroje, žiadne ochranné mechanizmy – ale tvorí to základ pre všetko ostatné. Zvyšok tohto kurzu len stavia na týchto dvoch objektoch: Agent a Runner.

Asynchrónne vykonávanie

run_sync blokuje aktuálne vlákno, kým nepríde odpoveď. To je v poriadku pre testovací skript, ale neprijateľné pre webový server spracúvajúci stovky súbežných požiadaviek. V produkcii použiješ asynchrónny režim.

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 asynchrónna verzia; Runner.run_sync() je synchronický obal, ktorý ju za teba zavolá. Pri používaní FastAPI alebo akéhokoľvek iného asynchrónneho frameworku vždy používaj Runner.run().

Streamovacie vykonávanie

Existuje tretí režim, ktorý je nevyhnutný vždy, keď na obrazovke čaká človek. Streamovanie zobrazuje odpoveď počas jej generovania, token po tokene.

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())

Cyklus async for spracúva prúd udalostí. Tu filtrujeme surové udalosti odpovede modelu a vypisujeme len textové fragmenty. Streamovanie je kritické pre používateľskú skúsenosť: nikto nechce zízať na prázdnu obrazovku 10 sekúnd.

Štruktúra projektu agenta

Produkčný agent sa nezmestí do jedného súboru. Od začiatku oddeľ definície agentov, nástroje a testy, inak sa tvoj main.py rýchlo stane nečitateľným.

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

Kľúčové poznatky

  • Nainštaluj SDK príkazom pip install openai-agents
  • Nastav OPENAI_API_KEY ako premennú prostredia
  • Používaj Runner.run_sync() pre vývoj a Runner.run() pre asynchrónnu produkciu
  • Používaj Runner.run_streamed() pre streamovanie v reálnom čase
  • Štruktúruj svoj projekt so samostatnými priečinkami pre agentov, nástroje a testy