Agents SDK: Asennus ja ensimmäinen agenttisi
Tällä sivulla
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_KEYympäristömuuttujaksi - Käytä
Runner.run_sync():ää kehitykseen jaRunner.run():ää asynkroniseen tuotantoon - Käytä
Runner.run_streamed():ää reaaliaikaiseen streamaukseen - Jäsennä projektisi erillisillä kansioilla agenteille, työkaluille ja testeille