Från och med 11 mars 2025 har vi släppt byggstenarna i vår nya Agentplattform. Mer information finns i vår API-dokumentation för vårt Responses API, verktyg inklusive Web Search, File Search och Computer Use, samt vår Agents SDK med Tracing. Baserat på er feedback om Assistants API beta har vi införlivat viktiga förbättringar i Responses API. När vi har uppnått fullständig funktionsparitet kommer vi att tillkännage en utfasningsplan för Assistants API senare i år, med ett mål om slutdatum under första halvåret 2026.
Vad är Assistants API?
Med Assistants API kan utvecklare enkelt bygga kraftfulla AI-assistenter i sina appar. Detta API tar bort behovet av att hantera konversationshistorik och ger åtkomst till verktyg som hanteras av OpenAI, som Kodtolkare och File Search. API:et stöder även förbättrade funktionsanrop för tredjepartsverktyg.
Kan jag fortfarande använda Assistants API v1 beta?
Nej. Från och med 18 december 2024 har användare inte längre åtkomst till v1-versionen av Assistant API beta. Vi stöder för närvarande endast v2. Läs denna migreringsguide för att konvertera dina API-anrop från v1 till v2
Hur får jag åtkomst till det?
Assistants API är tillgängligt för alla med ett OpenAI API-konto, men det är utfasat och kommer att tas bort i augusti 2026. För nya projekt ska du använda Responses API i stället. Om du redan använder Assistants API bör du planera din migrering till Responses API. Du kan fortfarande komma åt befintliga assistenter i Assistants Playground medan API:et är tillgängligt.
Vad är en assistent?
En assistent representerar en specialbyggd AI som använder OpenAI:s modeller och kan komma åt filer, behålla beständiga trådar och anropa verktyg.
Vad är en tråd?
En tråd är en konversationssession mellan en assistent och en användare. Trådar förenklar applikationsutveckling genom att lagra meddelandehistorik och korta ned den när konversationen blir för lång för modellens kontextlängd.
Vad är File Search-verktyget?
Verktyget `file_search` implementerar flera bästa praxis för hämtning direkt för att hjälpa dig att extrahera rätt data från dina filer och förbättra modellens svar. Mer information finns i vår utvecklardokumentation.
Som standard använder file_search-verktyget följande inställningar:
Segmentstorlek: 800 token
Segmentöverlappning: 400 token
Inbäddningsmodell: `text-embedding-3-large` med 256 dimensioner
Maximalt antal segment som läggs till i kontext: 20
Vilka begränsningar gäller för filuppladdning?
Begränsningarna för att ladda upp en fil är:
512 MB per fil
5M token per fil
10k filer per vektorlagring
1 vektorlagring per assistent
1 vektorlagring per tråd
Den totala lagringsgränsen för varje projekt i en organisation är 100 GB.
Vilka begränsningar har File Search-verktyget?
Vi har några kända begränsningar som vi arbetar med att lägga till stöd för under de kommande månaderna:
Det finns för närvarande inget sätt att ändra inställningarna för segmentering, inbäddning eller hämtning.
Vi stöder inte parsning av bilder i dokument.
Vi stöder inte hämtningar över strukturerade filformat (som .csv- eller .jsonl-filer). Se filtyper som stöds.
Vilka är frekvensgränserna för Assistants API?
Frekvensgränserna för Assistants API är inte knutna till användningsnivå och modell. I stället finns standardgränser per begärandetyp, med ett par undantag:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 begäranden per minut
Hur prissätts Kodtolkare i API:et?
Kodtolkare kostar $0.03 per session. Om din assistent anropar Kodtolkare samtidigt i två olika trådar skapas två sessioner i Kodtolkare (2 * $0.03). Varje session är som standard aktiv i en timme, vilket innebär att du bara betalar avgiften en gång om användaren fortsätter att ge instruktioner till Kodtolkare i samma tråd i upp till en timme.
Hur prissätts File Search i API:et?
File Search kostar $0.10/GB vektorlagring per dag (den första GB lagring är gratis). Storleken på vektorlagringen baseras på den resulterande storleken på vektorlagringen när filen har parsats, segmenterats och bäddats in.
Alla vektorlagringar som skapades före 17 april 2024 är gratis till slutet av 2024, varefter de antingen kommer att:
Debiteras enligt de aktuella priserna (för närvarande $0.10/GB/dag) om de har använts minst en gång i en Run som skapats efter 17 april 2024.
Raderas om de inte har använts i en enda Run mellan 17 april 2024 och 31 december 2024 — detta för att undvika att du debiteras för vektorlagringar som du kan ha skapat innan denna prisändring tillkännagavs men aldrig använde.
Finns det en gräns för hur många assistenter jag kan skapa?
Det finns ingen gräns för hur många assistenter en organisation kan skapa.
Är streaming tillgängligt i API:et?
Ja, streaming är tillgängligt i Assistants API.
Är JSON-läge tillgängligt i Assistants API?
Ja, JSON-läge är tillgängligt i Assistants API via parametern response_format på Assistants- eller Run-objekt.
Kommer Assistants API också att hantera begäranden om funktionsanrop till tredje part?
Nej. Även om funktionsanrop gör att modellen kan välja verktyg och formatera begäranden för dem, hanteras inte anrop till tredjepartsverktyg av OpenAI.
Hur hanteras data som jag skickar till OpenAI?
Precis som med resten av vår plattform används data och filer som skickas till OpenAI API aldrig för att träna våra modeller, och du kan radera dina data när du behöver. Data som laddas upp till Assistants API lagras på obestämd tid tills en användare raderar den manuellt.
Är DALL-E tillgängligt via Assistants API?
För närvarande är DALL-E inte tillgängligt.
Finns det ett användargränssnitt för Assistants API?
Du kan titta i Playground för Assistants API. Se till att du är i vyn Assistants i vänster sidofält och använder en modell som är kompatibel med de verktyg du vill aktivera.
Vilken är teckengränsen för assistentinstruktioner i Assistants API?
Fältet för assistentinstruktioner har en maximal längd på 256 000 tecken.
Jag får ett fel som ”Servern hade ett fel när din begäran bearbetades. Vi beklagar det! Du kan försöka skicka begäran igen eller kontakta oss via vårt hjälpcenter på help.openai.com om felet kvarstår. ” Vad ska jag göra?
Om du får det här felet kan det betyda att din prompt inte är korrekt konfigurerad. Om du fortsätter att försöka skicka begäran igen och den misslyckas kan du prova följande:
se till att omstrukturera din prompt så att kommandon som liknar funktioner behandlas som funktioner
lägg till alla kommandon i din prompt som en funktion i
tools
Varför fungerar inte mitt File Search-verktyg bra?
När du använder File Search-verktyget rekommenderar vi att du ställer in max_prompt_tokens på minst 20 000. För längre konversationer eller flera interaktioner med File Search bör du överväga att höja denna gräns till 50 000, eller helst ta bort gränserna för max_prompt_tokens helt för att få resultat av högsta kvalitet. Läs mer här.
Hur kan jag ge feedback?
Vi vill gärna höra din feedback i vårt utvecklarforum, via Hjälpcenter på help.openai.com eller på Twitter @OpenAIDevs.