Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Agents SDK: installimine ja sinu esimene agent

Õppetund 4 / 25 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Agents SDK: installimine ja sinu esimene agent
  2. Eeldused
  3. Installimine
  4. Sinu esimene agent
  5. Asünkroonne käivitamine
  6. Voogedastusrežiim (Streaming)
  7. Agendi projekti struktuur
  8. Peamised punktid

Agents SDK: installimine ja sinu esimene agent

Hakkame kodeerima. Installid OpenAI ametliku Agents SDK, lood toimiva Pythoni agendi ja uurid kolme käivitamisrežiimi, mida selles kursuses läbi kasutad.

Eeldused

Vajad vaid kolme asja: masinas peab olema installitud Python 3.10+, sul peab olema OpenAI konto aktiivse API-võtmega ja koodiredaktor. Soovitame VS Code’i, kuid sobib iga redaktor, mis toetab Pythoni süntaksi esiletõstmist.

Installimine

Paketi nimi on openai-agents. Pane tähele: ainult openai installimine annab sulle klassikalise API-kliendi, mitte Agents SDK-d.

pip install openai-agents

See pakett installib automaatselt vajalikud sõltuvused, sealhulgas OpenAI Pythoni SDK. Järgmiseks määra oma API-võti keskkonnamuutujana. SDK loeb selle automaatselt, seega lisakonfiguratsiooni pole vaja.

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

See käsk kaob terminali sulgemisel ja kindlasti ei taha sa oma võtit lähtekoodifailidesse kõvakodeerida. Korraliku projekti seadistamiseks kasuta .env faili koos python-dotenv-iga ja lisa see fail oma .gitignore-i enne esimest commit’i.

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

Sinu esimene agent

Loo fail nimega 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)

Käivita see:

python my_first_agent.py

Lõid ja käivitasid just oma esimese agendi. See on lihtne – ilma tööriistade ja kaitsepiiranguteta –, kuid see moodustab aluse kõigele muule. Ülejäänud kursus põhineb lihtsalt nendel kaheel objektil: Agent ja Runner.

Asünkroonne käivitamine

run_sync blokeerib praeguse lõime, kuni vastus saabub. Testiskripti jaoks sobib see hästi, kuid sadu samaaegseid päringuid töötleva veebiserveri jaoks on see vastuvõetamatu. Tootmises kasutad asünkroonset režiimi.

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() on asünkroonne versioon; Runner.run_sync() on sünkroonne mähis, mis kutsub selle sinu eest. FastAPI või mõne muu asünkroonse raamistiku kasutamisel kasuta alati Runner.run().

Voogedastusrežiim (Streaming)

On olemas kolmas režiim, mis on hädavajalik iga kord, kui inimene ootab vastust ekraanil. Voogedastus kuvab vastuse tekkimise ajal, token haaval.

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

Tsükkel async for tarbib sündmuste voogu. Siin filtreerime toore mudeli vastuse sündmused ja prindime ainult tekstifragmendid. Voogedastus on kasutajakogemuse jaoks kriitilise tähtsusega: keegi ei taha 10 sekundit tühja ekraani vahtida.

Agendi projekti struktuur

Tootmiseks mõeldud agent ei mahu ühte faili. Eralda agendi definitsioonid, tööriistad ja testid algusest peale, vastasel juhul muutub sinu main.py kiiresti loetamatuks.

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

Peamised punktid

  • Installi SDK käsuga pip install openai-agents
  • Määra OPENAI_API_KEY keskkonnamuutujana
  • Kasuta arendamiseks Runner.run_sync() ja asünkroonse tootmise jaoks Runner.run()
  • Kasuta reaalajas voogedastuseks Runner.run_streamed()
  • Struktureeri oma projekt eraldi kaustadega agentide, tööriistade ja testide jaoks