Agents SDK: Inštalácia a váš prvý agent
Na tejto strane
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_KEYako premennú prostredia - Používaj
Runner.run_sync()pre vývoj aRunner.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