Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Agents SDK: Instalacija i tvoj prvi agent

Lekcija 4 od 25 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Agents SDK: Instalacija i tvoj prvi agent
  2. Preduvjeti
  3. Instalacija
  4. Tvoj prvi agent
  5. Asinkrono izvršavanje
  6. Streamanje (Streaming)
  7. Struktura projekta agenta
  8. Ključne točke

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_KEY kao varijablu okruženja
  • Koristi Runner.run_sync() za razvoj i Runner.run() za asinkronu proizvodnju
  • Koristi Runner.run_streamed() za streamanje u stvarnom vremenu
  • Strukturiraj svoj projekt s odvojenim mapama za agente, alate i testove