Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Agents SDK: Installazzjoni u l-Ewwel Aġent Tiegħek

Lezzjoni 4 / 25 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Agents SDK: Installazzjoni u l-Ewwel Aġent Tiegħek
  2. Prerekwiżiti
  3. Installazzjoni
  4. L-Ewwel Aġent Tiegħek
  5. Eżekuzzjoni Asinkrona
  6. Eżekuzzjoni b’Streaming
  7. Struttura tal-Proġett tal-Aġent
  8. Punti Ewlenin

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_KEY bħala varjabbli tal-ambjent
  • Uża Runner.run_sync() għall-iżvilupp u Runner.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