Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Agents SDK: Namestitev in vaš prvi agent

Lekcija 4 od 25 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Agents SDK: Namestitev in vaš prvi agent
  2. Predpogoji
  3. Namestitev
  4. Vaš prvi agent
  5. Asinhrono izvajanje
  6. Izvajanje s pretokom (Streaming)
  7. Struktura projekta z agenti
  8. Ključne ugotovitve

Agents SDK: Namestitev in vaš prvi agent

Preidimo na kodiranje. Namestil boš uradni SDK za agente podjetja OpenAI, zgradil delujočega agenta v Pythonu in raziskal tri načine izvajanja, ki jih boš uporabljal skozi celoten tečaj.

Predpogoji

Potrebuješ le tri stvari: nameščen Python 3.10+ na svojem računalniku, račun OpenAI z aktivnim ključem API in urejevalnik kode. Priporočamo VS Code, vendar deluje kateri koli urejevalnik s poudarjanjem sintakse Python.

Namestitev

Paket se imenuje openai-agents. Pozor: namestitev samega paketa openai ti da klasičnega odjemalca API, ne pa SDK za agente.

pip install openai-agents

Ta paket samodejno namesti zahtevane odvisnosti, vključno s Python SDK za OpenAI. Nato nastavi svoj ključ API kot spremenljivko okolja. SDK ga samodejno prebere, zato dodatna konfiguracija ni potrebna.

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

Ta ukaz izgine, ko zapreš terminal, svojega ključa pa zagotovo ne želiš trdno kodirati v izvorne datoteke. Za pravilno nastavitev projekta uporabi datoteko .env s knjižnico python-dotenv in to datoteko dodaj v .gitignore pred prvo potrditvijo.

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

Vaš prvi agent

Ustvari datoteko z imenom 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)

Zaženi ga:

python my_first_agent.py

Pravkar si ustvaril in zagnal svojega prvega agenta. Preprost je – brez orodij, brez varoval – vendar tvori temelj za vse ostalo. Preostanek tega tečaja gradi le na teh dveh objektih: Agent in Runner.

Asinhrono izvajanje

run_sync blokira trenutno nit, dokler ne prispe odgovor. To je v redu za testno skripto, nesprejemljivo pa za spletni strežnik, ki obravnava na stotine sočasnih zahtevkov. V proizvodnem okolju boš uporabil asinhroni način.

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 asinhrona različica; Runner.run_sync() je sinhroni ovitek, ki jo pokliče namesto tebe. Ko uporabljaš FastAPI ali kateri koli drug asinhroni okvir, vedno uporabi Runner.run().

Izvajanje s pretokom (Streaming)

Obstaja tretji način, ki je bistven, kadar človek čaka pred zaslonom. Pretok prikazuje odgovor med njegovim generiranjem, žeton za žetonom.

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

Zanka async for porabi tok dogodkov. Tu filtriramo surove dogodke odziva modela in natisnemo le besedilne fragmente. Pretok je ključen za uporabniško izkušnjo: nihče noče 10 sekund strmeti v prazen zaslon.

Struktura projekta z agenti

Proizvodni agent ne sodi v eno samo datoteko. Od samega začetka loči definicije agentov, orodja in teste, sicer bo tvoja main.py hitro postala neberljiva.

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 ugotovitve

  • Namesti SDK z ukazom pip install openai-agents
  • Nastavi OPENAI_API_KEY kot spremenljivko okolja
  • Uporabi Runner.run_sync() za razvoj in Runner.run() za asinhrono proizvodno okolje
  • Uporabi Runner.run_streamed() za pretok v realnem času
  • Strukturiraj svoj projekt z ločenimi mapami za agente, orodja in teste