Agents SDK: Installazzjoni u l-Ewwel Aġent Tiegħek
F'din il-paġna
Agents SDK: Installazzjoni u l-Ewwel Aġent Tiegħek
Ejja nibdew niktbu l-kodiċi. Se tinstalla s-SDK uffiċjali tal-Aġenti ta’ OpenAI, tibni aġent Python li jaħdem, u tesplora t-tliet modi ta’ eżekuzzjoni li se tuża matul dan il-kors.
Prerekwiżiti
Għandek bżonn biss tliet affarijiet: Python 3.10+ installat fuq il-magna tiegħek, kont OpenAI b’ċavetta API attiva, u editur tal-kodiċi. Nirrakkomandaw VS Code, iżda kwalunkwe editur b’evidenzjar tas-sintassi ta’ Python jaħdem sew.
Installazzjoni
Il-pakkett jismu openai-agents. Oqgħod attent: jekk tinstalla biss openai, tikseb il-klijent klassiku tal-API, mhux is-SDK tal-Aġenti.
pip install openai-agents
Dan il-pakkett jinstalla awtomatikament id-dipendenzi meħtieġa, inkluż l-SDK ta’ Python ta’ OpenAI. Imbagħad, issettja ċ-ċavetta API tiegħek bħala varjabbli tal-ambjent. Is-SDK jaqraha awtomatikament, allura m’hemmx bżonn ta’ konfigurazzjoni addizzjonali.
export OPENAI_API_KEY="sk-proj-your-api-key"
Dan il-kumand jisparixxi meta tagħlaq it-terminal, u żgur li ma tridx tikteb iċ-ċavetta tiegħek direttament fil-fajls tas-sors tiegħek. Għal setup xieraq ta’ proġett, uża fajl .env ma’ python-dotenv, u żid dak il-fajl fil-.gitignore tiegħek qabel l-ewwel commit tiegħek.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
L-Ewwel Aġent Tiegħek
Oħloq fajl imsejjaħ 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)
Iġġrih:
python my_first_agent.py
Għadek kemm ħloqt u ġerrejt l-ewwel aġent tiegħek. Huwa sempliċi—l-ebda għodda, l-ebda protezzjoni (guardrails)—iżda jifforma l-bażi għal kollox ieħor. Il-bqija ta’ dan il-kors sempliċiment jibni fuq dawn iż-żewġ oġġetti: Agent u Runner.
Eżekuzzjoni Asinkrona
run_sync jimblokaw il-thread attwali sakemm tasal ir-risposta. Dan huwa tajjeb għal skript ta’ test, iżda inaċċettabbli għal server web li jimmaniġġja mijiet ta’ talbiet konkorrenti. Fil-produzzjoni, se tuża l-modalità asinkrona.
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() hija l-verżjoni asinkrona; Runner.run_sync() hija wrapper sinkronu li jsejħilha għalik. Meta tuża FastAPI jew kwalunkwe qafas ieħor asinkronu, uża dejjem Runner.run().
Eżekuzzjoni b’Streaming
Hemm it-tielet mod, essenzjali kull meta bniedem ikun qed jistenna quddiem l-iskrin. L-istreaming juri r-risposta hekk kif tiġi ġġenerata, token b’token.
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())
Iċ-ċiklu async for jikkonsma fluss ta’ avvenimenti. Hawnhekk, niffiltraw għal avvenimenti ta’ rispons mudell raw u nistampaw biss il-frammenti tat-test. L-istreaming huwa kritiku għall-esperjenza tal-utent: ħadd ma jrid iħares lejn skrin vojt għal 10 sekondi.
Struttura tal-Proġett tal-Aġent
Aġent tal-produzzjoni ma joqgħodx f’fajl wieħed. Separa d-definizzjonijiet tal-aġent tiegħek, l-għodod u t-testijiet mill-bidu, inkella l-main.py tiegħek malajr isir mhux leġibbli.
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
Punti Ewlenin
- Installa s-SDK b’
pip install openai-agents - Isettja
OPENAI_API_KEYbħala varjabbli tal-ambjent - Uża
Runner.run_sync()għall-iżvilupp uRunner.run()għall-produzzjoni asinkrona - Uża
Runner.run_streamed()għall-istreaming f’ħin reali - Istruttura l-proġett tiegħek b’folders separati għall-aġenti, l-għodod u t-testijiet