Agents SDK: Instalacija i tvoj prvi agent
Na ovoj stranici
Agents SDK: Instalacija i tvoj prvi agent
Krenimo s kodiranjem. Instalirat ćeš službeni OpenAI Agents SDK, izgraditi funkcionalnog Python agenta i istražiti tri načina izvršavanja koje ćeš koristiti tijekom ovog tečaja.
Preduvjeti
Trebaš samo tri stvari: Python 3.10+ instaliran na svom računalu, OpenAI račun s aktivnim API ključem i uređivač koda. Preporučujemo VS Code, ali bilo koji uređivač s isticanjem Python sintakse će odraditi posao.
Instalacija
Paket se zove openai-agents. Pazi: instalacija samo openai paketa daje ti klasičnog API klijenta, a ne Agents SDK.
pip install openai-agents
Ovaj paket automatski instalira potrebne ovisnosti, uključujući OpenAI Python SDK. Zatim postavi svoj API ključ kao varijablu okruženja. SDK ga automatski očita, pa nije potrebna dodatna konfiguracija.
export OPENAI_API_KEY="sk-proj-your-api-key"
Ova naredba nestaje kada zatvoriš terminal, a sigurno ne želiš hard-kodirati svoj ključ u izvorne datoteke. Za ispravnu postavku projekta koristi .env datoteku s python-dotenv i dodaj tu datoteku u svoj .gitignore prije prvog commita.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
Tvoj prvi agent
Stvori datoteku pod nazivom 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)
Pokreni ga:
python my_first_agent.py
Upravo si stvorio i pokrenuo svog prvog agenta. Jednostavno je – bez alata, bez zaštitnih ograda – ali to čini temelj za sve ostalo. Ostatak ovog tečaja samo nadograđuje ova dva objekta: Agent i Runner.
Asinkrono izvršavanje
run_sync blokira trenutnu nit dok odgovor ne stigne. To je u redu za test skriptu, ali neprihvatljivo za web poslužitelj koji obrađuje stotine istovremenih zahtjeva. U proizvodnji ćeš koristiti asinkroni način rada.
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 asinkrona verzija; Runner.run_sync() je sinkroni omotač koji je poziva umjesto tebe. Kada koristiš FastAPI ili bilo koji drugi asinkroni okvir, uvijek koristi Runner.run().
Streamanje (Streaming)
Postoji i treći način, ključan kad god čovjek čeka ispred ekrana. Streamanje prikazuje odgovor dok se generira, token po token.
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())
Petlja async for troši stream događaja. Ovdje filtriramo sirove odgovore modela i ispisujemo samo tekstualne fragmente. Streamanje je ključno za korisničko iskustvo: nitko ne želi gledati u prazan ekran 10 sekundi.
Struktura projekta agenta
Proizvodni agent ne staje u jednu datoteku. Od samog početka odvoji definicije agenata, alate i testove, inače će tvoj main.py brzo postati nečitljiv.
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 točke
- Instaliraj SDK s
pip install openai-agents - Postavi
OPENAI_API_KEYkao varijablu okruženja - Koristi
Runner.run_sync()za razvoj iRunner.run()za asinkronu proizvodnju - Koristi
Runner.run_streamed()za streamanje u stvarnom vremenu - Strukturiraj svoj projekt s odvojenim mapama za agente, alate i testove