Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Agents SDK: Asennus ja ensimmäinen agenttisi

Oppitunti 4 / 25 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Agents SDK: Asennus ja ensimmäinen agenttisi
  2. Esivaatimukset
  3. Asennus
  4. Ensimmäinen agenttisi
  5. Asynkroninen suoritus
  6. Streamaus-suoritus
  7. Agenttiprojektin rakenne
  8. Keskeiset asiat

Agents SDK: Asennus ja ensimmäinen agenttisi

Aloitetaan koodaaminen. Asennat OpenAI:n virallisen Agents SDK:n, rakennat toimivan Python-agentin ja tutustut kolmeen suoritusmoodiin, joita käytät koko tämän kurssin ajan.

Esivaatimukset

Tarvitset vain kolme asiaa: koneellesi asennetun Python 3.10+ -version, OpenAI-tilin, jossa on aktiivinen API-avain, sekä koodieditorin. Suosittelemme VS Codea, mutta mikä tahansa editori, jossa on Python-syntaksikorostus, toimii hyvin.

Asennus

Paketin nimi on openai-agents. Varo: pelkän openai-paketin asentaminen antaa sinulle klassisen API-asiakkaan, ei Agents SDK:ta.

pip install openai-agents

Tämä paketti asentaa automaattisesti vaaditut riippuvuudet, mukaan lukien OpenAI Python SDK:n. Aseta seuraavaksi API-avaimesi ympäristömuuttujaksi. SDK lukee sen automaattisesti, joten lisäasetuksia ei tarvita.

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

Tämä komento katoaa, kun suljet päätteen, etkä varmasti halua kovakoodata avaintasi lähdekooditiedostoihisi. Oikeaa projektiasetusta varten käytä .env-tiedostoa yhdessä python-dotenv-kirjaston kanssa ja lisää tämä tiedosto .gitignore-tiedostoosi ennen ensimmäistä commitia.

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

Ensimmäinen agenttisi

Luo tiedosto nimeltä 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)

Suorita se:

python my_first_agent.py

Loit ja suoritat juuri ensimmäisen agenttisi. Se on yksinkertainen – ei työkaluja, ei turvakaiteita – mutta se muodostaa perustan kaikelle muulle. Kurssin loppuosa rakentaa vain näiden kahden objektin päälle: Agent ja Runner.

Asynkroninen suoritus

run_sync estää nykyisen säikeen, kunnes vastaus saapuu. Tämä sopii testiskriptille, mutta on mahdoton hyväksyä verkkopalvelimelle, joka käsittelee satoja samanaikaisia pyyntöjä. Tuotannossa käytät asynkronista moodia.

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 asynkroninen versio; Runner.run_sync() on synkroninen kääre, joka kutsuu sitä puolestasi. Kun käytät FastAPI:a tai mitä tahansa muuta asynkronista kehystä, käytä aina Runner.run():ää.

Streamaus-suoritus

Kolmas moodi on välttämätön aina, kun ihminen odottaa näytön ääressä. Streamaus näyttää vastuksen sitä mukaa kun se generoituu, token kerrallaan.

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

async for -silmukka kuluttaa tapahtumavirtaa. Tässä suodatamme raakat mallivastauseventit ja tulostamme vain tekstikatkelmat. Streamaus on kriittinen käyttäjäkokemukselle: kukaan ei halua tuijottaa tyhjää näyttöä 10 sekunnin ajan.

Agenttiprojektin rakenne

Tuotantoagentti ei mahdu yhteen tiedostoon. Erota agenttimäärityksesi, työkalusi ja testisi alusta alkaen, muuten main.py:stäsi tulee nopeasti lukukelvoton.

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

Keskeiset asiat

  • Asenna SDK komennolla pip install openai-agents
  • Aseta OPENAI_API_KEY ympäristömuuttujaksi
  • Käytä Runner.run_sync():ää kehitykseen ja Runner.run():ää asynkroniseen tuotantoon
  • Käytä Runner.run_streamed():ää reaaliaikaiseen streamaukseen
  • Jäsennä projektisi erillisillä kansioilla agenteille, työkaluille ja testeille