Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Agents SDK: Instalēšana un tavs pirmais aģents

Nodarbība 4 no 25 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Agents SDK: Instalēšana un tavs pirmais aģents
  2. Priekšnosacījumi
  3. Instalēšana
  4. Tavs pirmais aģents
  5. Asinhronā izpilde
  6. Straumēšanas izpilde
  7. Aģenta projekta struktūra
  8. Galvenās atziņas

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_KEY kā 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