AI-agenter · leksjon

Kalle OpenAI API: chat.completions

Send meldinger til OpenAI-endepunktet chat.completions, angi temperature og max_tokens, og tolk svaret.

Leksjon 1 av 413 trinn

Kalle OpenAI API: chat.completions er en gratis leksjon i AI-agenter på CoddyKit. Dette er leksjon 1 av 4. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i AI-agenter, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i AI-agenter inneholder totalt 4 leksjoner.

Hvorfor chat.completions?

OpenAI har to API-er:

  • chat.completions — standardendepunktet med bred støtte
  • Responses API / Assistants — administrerte agenter (mer avansert)

Denne leksjonen dekker chat.completions, som er arbeidshesten for 95 % av agenter.

Installer SDK-en

Én pakke, én linje:

# pip install openai
from openai import OpenAI

client = OpenAI()  # reads OPENAI_API_KEY from env

Ditt første kall

En minimal completion:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=[
        {'role': 'system', 'content': 'You are concise.'},
        {'role': 'user', 'content': 'Capital of France?'},
    ],
)
print(response.choices[0].message.content)
# 'Paris'

Svarobjektets oppbygning

Svaret inneholder mer enn bare tekst. Nyttige felt:

response.choices[0].message.content       # the text
response.choices[0].finish_reason          # 'stop' / 'length' / 'tool_calls'
response.usage.prompt_tokens               # input tokens
response.usage.completion_tokens           # output tokens
response.usage.total_tokens                # sum
response.id                                # 'chatcmpl-...' for tracing

Viktige parametere

  • model — hvilken modell som skal brukes
  • temperature — 0.0 deterministisk, 1.0 kreativt
  • max_tokens — øvre grense for utdataenes lengde
  • top_p — et alternativ til temperature
  • seed — reproduserbare utdata (med forbehold)

Temperature: Velg etter oppgave

  • 0.0 — uthenting, klassifisering, kodegenerering
  • 0.2–0.5 — de fleste agentavgjørelser
  • 0.7–1.0 — kreativ skriving, idémyldring

Stop-sekvenser

Avslutt utdata ved en bestemt markør:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=messages,
    stop=['\n\n', 'END'],
)
# Stops as soon as a blank line or 'END' appears.

Flere alternativer

Generer N kandidater i ett kall:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=messages,
    n=3,  # three samples
)
for choice in response.choices:
    print(choice.message.content)

Feiltyper som må håndteres

  • RateLimitError — 429, vent før nytt forsøk
  • APIConnectionError — nettverksproblem
  • APITimeoutError — tregt svar
  • AuthenticationError — ugyldig API-nøkkel
  • BadRequestError — skjemaproblem

Asynkrone kall

For agenter med høy gjennomstrømming bruker du den asynkrone klienten:

from openai import AsyncOpenAI
import asyncio

client = AsyncOpenAI()

async def ask(q):
    r = await client.chat.completions.create(
        model='gpt-4o-mini',
        messages=[{'role': 'user', 'content': q}],
    )
    return r.choices[0].message.content

results = asyncio.run(asyncio.gather(*[ask(q) for q in questions]))

Tidsavbrudd og nye forsøk er innebygd

SDK-en gjør noen nye forsøk som standard. Du kan overstyre dette:

client = OpenAI(
    timeout=30.0,
    max_retries=3,
)

Årsaker til avslutning

Hva betyr finish_reason == "length"?

Oppsummering

Du kan nå kalle OpenAI fra Python. Deretter dekker vi Anthropic API, som har små, men viktige forskjeller.

Gratis å komme i gang

Lær deg AI-agenter med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs
60
Leksjoner
239

Ofte stilte spørsmål

Er leksjonen «Kalle OpenAI API: chat.completions» gratis?

Ja – hele teksten i «Kalle OpenAI API: chat.completions» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av AI-agenter-kurset, kan du oppgradere til CoddyKit PRO. Kurset i AI-agenter inneholder totalt 4 leksjoner.

Hva lærer jeg i «Kalle OpenAI API: chat.completions»?

Send meldinger til OpenAI-endepunktet chat.completions, angi temperature og max_tokens, og tolk svaret. Du øver på AI-agenter med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med AI-agenter?

Ingen tidligere erfaring er nødvendig. AI-agenter på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 1 av 4.

Hvor lang tid tar leksjonen «Kalle OpenAI API: chat.completions»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne AI-agenter-leksjonen?

Ja. Alle AI-agenter-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

  1. Kalle OpenAI API: chat.completions
  2. Kalle Anthropic API: messages
  3. Strømming av svar (SSE)
  4. Kostnadsbevissthet: tokenberegning og budsjetter
← Tilbake til AI-agenter