Agents SDK: Instalēšana un tavs pirmais aģents
Šajā lapā
Agents SDK: Instalēšana un tavs pirmais aģents
Ķeramies pie kodēšanas. Tu instalēsi OpenAI oficiālo Agents SDK, izveidosi funkcionējošu Python aģentu un iepazīsies ar trim izpildes režīmiem, kurus izmantosi visā šī kursa laikā.
Priekšnosacījumi
Tev vajag tikai trīs lietas: datorā instalētu Python 3.10+, OpenAI kontu ar aktīvu API atslēgu un koda redaktoru. Mēs iesakām VS Code, taču der jebkurš redaktors ar Python sintakses izcelšanu.
Instalēšana
Pakotnes nosaukums ir openai-agents. Uzmanību: instalējot tikai openai, tu iegūsi klasisko API klientu, nevis Agents SDK.
pip install openai-agents
Šī pakotne automātiski instalē nepieciešamās atkarības, tostarp OpenAI Python SDK. Tālāk iestati savu API atslēgu kā vides mainīgo. SDK to nolasīs automātiski, tāpēc papildu konfigurācija nav vajadzīga.
export OPENAI_API_KEY="sk-proj-your-api-key"
Šī komanda pazūd, aizverot termināli, un tu noteikti nevēlies savu atslēgu ierakstīt tieši pirmkoda failos. Pareizai projekta iestatīšanai izmanto .env failu kopā ar python-dotenv un pievieno šo failu savam .gitignore pirms pirmā commit.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
Tavs pirmais aģents
Izveido failu ar nosaukumu 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)
Palaid to:
python my_first_agent.py
Tu tikko izveidoji un palaidi savu pirmo aģentu. Tas ir vienkāršs – bez rīkiem, bez aizsardzības mehānismiem –, taču tas veido pamatu visam pārējam. Atlikusī kursa daļa tikai attīsta šos divus objektus: Agent un Runner.
Asinhronā izpilde
run_sync bloķē pašreizējo pavedienu, līdz tiek saņemta atbilde. Testa skriptam tas ir pieņemami, bet tīmekļa serverim, kas apstrādā simtiem vienlaicīgu pieprasījumu, tas ir nepieņemami. Produkcijas vidē tu izmantosi asinhrono režīmu.
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() ir asinhronā versija; Runner.run_sync() ir sinhrons apvalks, kas to izsauc tavā vietā. Strādājot ar FastAPI vai jebkuru citu asinhrono ietvaru, vienmēr izmanto Runner.run().
Straumēšanas izpilde
Pastāv trešais režīms, kas ir būtisks ikreiz, kad ekrāna priekšā gaida cilvēks. Straumēšana parāda atbildi tās ģenerēšanas brīdī, tokens pa tokenam.
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())
Cikls async for apstrādā notikumu straumi. Šeit mēs atlasām tikai neapstrādātus modeļa atbildes notikumus un drukājam tikai teksta fragmentus. Straumēšana ir kritiski svarīga lietotāja pieredzei: neviens nevēlas 10 sekundes skatīties tukšā ekrānā.
Aģenta projekta struktūra
Produkcijas aģents neietilpst vienā failā. Atdali aģentu definīcijas, rīkus un testus jau no paša sākuma, pretējā gadījumā tavs main.py ātri kļūs nelasāms.
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
Galvenās atziņas
- Instalē SDK ar
pip install openai-agents - Iestati
OPENAI_API_KEYkā vides mainīgo - Izstrādei izmanto
Runner.run_sync(), bet asinhronai produkcijas videi –Runner.run() - Reāllaika straumēšanai izmanto
Runner.run_streamed() - Strukturē projektu ar atsevišķām mapēm aģentiem, rīkiem un testiem