Agents SDK: diegimas ir jūsų pirmasis agentas
Šiame puslapyje
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_KEYkaip 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