Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Agents SDK: diegimas ir jūsų pirmasis agentas

Paskaita 4 iš 25 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Agents SDK: diegimas ir jūsų pirmasis agentas
  2. Būtinos sąlygos
  3. Diegimas
  4. Jūsų pirmasis agentas
  5. Asinchroninis vykdymas
  6. Srautinis vykdymas
  7. Agentų projekto struktūra
  8. Svarbiausi punktai

Agents SDK: diegimas ir jūsų pirmasis agentas

Pradėkime koduoti. Įdiegsite oficialų „OpenAI“ Agents SDK, sukursite veikiantį Python agentą ir išnagrinėsite tris vykdymo režimus, kuriuos naudosite per visus šiuos kursus.

Būtinos sąlygos

Jums reikia tik trijų dalykų: kompiuteryje įdiegto Python 3.10+, OpenAI paskyros su aktyviu API raktu ir kodo redaktoriaus. Rekomenduojame naudoti „VS Code“, tačiau tinka bet kuris redaktorius, palaikantis Python sintaksės paryškinimą.

Diegimas

Paketas vadinasi openai-agents. Būkite atidūs: įdiegus vien openai, gausite klasikinį API klientą, o ne Agents SDK.

pip install openai-agents

Šis paketas automatiškai įdiegia reikiamus priklausomus komponentus, įskaitant „OpenAI“ Python SDK. Toliau nustatykite savo API raktą kaip aplinkos kintamąjį. SDK jį nuskaitys automatiškai, todėl papildomų konfigūracijų nereikia.

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

Ši komanda išnyks uždarius terminalą, ir tikrai nenorite savo rakto įterpti tiesiai į源代码 failus. Tinkamam projekto nustatymui naudokite .env failą su python-dotenv ir prieš pirmąjį įsipareigojimą (commit) įtraukite tą failą į .gitignore.

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

Jūsų pirmasis agentas

Sukurkite failą pavadinimu 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)

Paleiskite jį:

python my_first_agent.py

Jūs ką tik sukūrėte ir paleidote savo pirmąjį agentą. Tai paprasta – jokių įrankių, jokių apsaugos mechanizmų, tačiau tai yra visko kitko pagrindas. Likusi šio kurso dalis tiesiog remiasi šiais dviem objektais: Agent ir Runner.

Asinchroninis vykdymas

run_sync blokuoja dabartinę giją, kol gaunamas atsakymas. Testavimo scenarijui tai tinka, tačiau nepriimtina žiniatinklio serveriui, apdorojančiam šimtus vienu metu vykdomų užklausų. Gamtinėje aplinkoje naudosite asinchroninį režimą.

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() yra asinchroninė versija; Runner.run_sync() yra sinchroninis apvalkalas, kuris ją iškviečia jūsų vardu. Naudodami „FastAPI“ ar bet kurią kitą asinchroninę sistemą, visada naudokite Runner.run().

Srautinis vykdymas

Yra ir trečiasis režimas, būtinas visada, kai žmogus laukia prie ekrano. Srautinis režimas rodo atsakymą generavimo metu, žymenį po žymens.

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

Ciklas async for apdoroja įvykių srautą. Čia mes filtruojame neapdorotus modelio atsakymo įvykius ir spausdiname tik teksto fragmentus. Srautinis režimas yra kritiškai svarbus naudotojo patirčiai: niekas nenori 10 sekundžių žiūrėti į tuščią ekraną.

Agentų projekto struktūra

Gamybinis agentas netelpa į vieną failą. Agentų apibrėžimus, įrankius ir testus atskirkite nuo pat pradžių, kitaip jūsų main.py greitai taps nebeskaitomas.

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

Svarbiausi punktai

  • Įdiekite SDK naudodami pip install openai-agents
  • Nustatykite OPENAI_API_KEY kaip aplinkos kintamąjį
  • Kūrimo metu naudokite Runner.run_sync(), o asinchroninei gamybai – Runner.run()
  • Realaus laiko srautiniam perdavimui naudokite Runner.run_streamed()
  • Struktūrizuokite projektą naudodami atskirus aplankus agentams, įrankiams ir testams