Agents SDK: installimine ja sinu esimene agent
Sellel lehel
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_KEYkeskkonnamuutujana - Kasuta arendamiseks
Runner.run_sync()ja asünkroonse tootmise jaoksRunner.run() - Kasuta reaalajas voogedastuseks
Runner.run_streamed() - Struktureeri oma projekt eraldi kaustadega agentide, tööriistade ja testide jaoks