Agents SDK: Installation og din første agent
På denne side
Agents SDK: Installation og din første agent
Lad os komme i gang med kodningen. Du installerer OpenAIs officielle Agents SDK, bygger en fungerende Python-agent og udforsker de tre eksekveringstilstande, du vil bruge gennem hele dette kursus.
Forudsætninger
Du behøver kun tre ting: Python 3.10+ installeret på din maskine, en OpenAI-konto med en aktiv API-nøgle og en kodeeditor. Vi anbefaler VS Code, men enhver editor med Python-syntaksfremhævning fungerer fint.
Installation
Pakken hedder openai-agents. Pas på: Hvis du kun installerer openai, får du den klassiske API-klient, ikke Agents SDK.
pip install openai-agents
Denne pakke installerer automatisk nødvendige afhængigheder, herunder OpenAI Python SDK. Derefter skal du sætte din API-nøgle som en miljøvariabel. SDK’en læser den automatisk, så ingen ekstra konfiguration er nødvendig.
export OPENAI_API_KEY="sk-proj-your-api-key"
Denne kommando forsvinder, når du lukker terminalen, og du vil helt sikkert ikke hardkode din nøgle i dine kildefiler. Til en ordentlig projektopsætning skal du bruge en .env-fil med python-dotenv og tilføje den fil til din .gitignore før dit første commit.
pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key
Din første agent
Opret en fil ved navn 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)
Kør den:
python my_first_agent.py
Du har lige oprettet og kørt din første agent. Den er simpel – ingen værktøjer, ingen sikkerhedsforanstaltninger – men den danner grundlaget for alt andet. Resten af dette kursus bygger blot videre på disse to objekter: Agent og Runner.
Asynkron eksekvering
run_sync blokerer den aktuelle tråd, indtil svaret ankommer. Det er fint til et testscript, men uacceptabelt for en webserver, der håndterer hundreder af samtidige anmodninger. I produktion vil du bruge asynkron tilstand.
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() er den asynkrone version; Runner.run_sync() er en synkron wrapper, der kalder den for dig. Når du bruger FastAPI eller ethvert andet asynkront framework, skal du altid bruge Runner.run().
Streamet eksekvering
Der er en tredje tilstand, som er essentiel, når et menneske venter ved skærmen. Streaming viser svaret, efterhånden som det genereres, token for 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())
async for-løkken forbruger en strøm af begivenheder. Her filtrerer vi efter rå modelsvar-begivenheder og udskriver kun tekstfragmenterne. Streaming er afgørende for brugeroplevelsen: Ingen har lyst til at stirre på en tom skærm i 10 sekunder.
Projektstruktur for agenter
En agent i produktion passer ikke i en enkelt fil. Adskil dine agentdefinitioner, værktøjer og tests fra starten, ellers vil din main.py hurtigt blive ulæselig.
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
Vigtige pointer
- Installer SDK’en med
pip install openai-agents - Sæt
OPENAI_API_KEYsom en miljøvariabel - Brug
Runner.run_sync()til udvikling ogRunner.run()til asynkron produktion - Brug
Runner.run_streamed()til streaming i realtid - Strukturér dit projekt med separate mapper til agenter, værktøjer og tests