Algengar spurningar um Assistants API (v2)

Hvað er Assistants API?

Assistants API gerir þróunaraðilum kleift að byggja auðveldlega öfluga AI-aðstoðarmenn innan forrita sinna. Þetta API fjarlægir þörfina á að stjórna samtalsferli og bætir við aðgangi að verkfærum sem OpenAI hýsir, eins og kóðatúlki og File Search. API-ið styður einnig bætt eiginleikakall fyrir verkfæri þriðja aðila.

Get ég enn notað Assistants API v1 beta?

Nei. Frá og með 18. desember 2024 hafa notendur ekki lengur aðgang að v1 útgáfu betaútgáfu Assistant API. Við styðjum sem stendur aðeins v2. Skoðaðu þennan flutningsleiðarvísi til að breyta API-köllunum þínum úr v1 í v2

Hvernig fæ ég aðgang að því?

Assistants API er í boði fyrir alla með OpenAI API-reikning, en það er úrelt og verður fjarlægt í ágúst 2026. Fyrir ný verkefni skaltu nota Responses API í staðinn. Ef þú notar nú þegar Assistants API skaltu skipuleggja flutninginn yfir í Responses API. Þú getur enn fengið aðgang að núverandi aðstoðarmönnum í Assistants Playground á meðan API-ið er áfram tiltækt.

Hvað er aðstoðarmaður?

Aðstoðarmaður táknar sérhannað AI sem notar líkön OpenAI og getur fengið aðgang að skrám, viðhaldið varanlegum þráðum og kallað á verkfæri.

Hvað er þráður?

Þráður er samtalslota milli aðstoðarmanns og notanda. Þræðir einfalda þróun forrita með því að geyma skilaboðasögu og stytta hana þegar samtalið verður of langt fyrir samhengislengd líkansins.

Hvað er File Search-verkfærið?

`file_search`-verkfærið útfærir nokkrar bestu venjur fyrir endurheimt strax í upphafi til að hjálpa þér að draga rétt gögn úr skránum þínum til að bæta svör líkansins. Frekari upplýsingar má finna í þróunarskjölunum okkar.

Sjálfgefið notar file_search-verkfærið eftirfarandi stillingar:

• Bitastærð: 800 tókar

• Skörun bita: 400 tókar

• Ívörpunarlíkan: `text-embedding-3-large` með 256 víddum

• Hámarksfjöldi bita sem bætt er við samhengi: 20

Hvaða takmarkanir gilda um upphleðslu skráa?

Takmarkanir fyrir upphleðslu skráar eru:

• 512 MB á hverja skrá

• 5M tókar á hverja skrá

• 10k skrár á hverja vigurgeymslu

• 1 vigurgeymsla á hvern aðstoðarmann

• 1 vigurgeymsla á hvern þráð

Heildargeymslumörk fyrir hvert verkefni í fyrirtæki eru 100 GB.

Hvaða takmarkanir eru á File Search-verkfærinu?

Við þekkjum nokkrar takmarkanir sem við vinnum að því að bæta stuðningi við á næstu mánuðum:

1. Sem stendur er engin leið til að breyta stillingum fyrir skiptingu í bita, ívörpun eða endurheimt.

2. Við styðjum ekki þáttun mynda í skjölum.

3. Við styðjum ekki endurheimtir yfir skipulögð skráarsnið (eins og .csv- eða .jsonl-skrár). Sjá studdar skráartegundir.

Hverjar eru hraðatakmarkanirnar fyrir Assistants API?

Hraðatakmarkanirnar fyrir Assistants API eru ekki bundnar við notkunarþrep og líkan. Þess í stað eru sjálfgefin mörk eftir tegund beiðni, með nokkrum undantekningum:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 beiðnir á mínútu

Hvernig er kóðatúlkur verðlagður í API-inu?

Kóðatúlkur kostar $0.03 á hverja lotu. Ef aðstoðarmaðurinn þinn kallar á kóðatúlk samtímis í tveimur mismunandi þráðum myndi það búa til tvær lotur fyrir kóðatúlk (2 * $0.03). Hver lota er sjálfgefið virk í eina klukkustund, sem þýðir að þú greiðir þetta gjald aðeins einu sinni ef notandinn heldur áfram að gefa kóðatúlki leiðbeiningar í sama þræði í allt að eina klukkustund.

Hvernig er File Search verðlagt í API-inu?

File Search kostar $0.10/GB af geymslu í vigurgeymslu á dag (fyrsta GB geymslu er ókeypis). Stærð vigurgeymslunnar byggist á endanlegri stærð vigurgeymslunnar eftir að skráin þín hefur verið þáttuð, skipt í bita og ívörpuð.

Allar vigurgeymslur sem voru búnar til fyrir 17. apríl 2024 verða ókeypis til loka árs 2024, en eftir það verða þær annaðhvort:

• Innheimtar samkvæmt gildandi verðum (nú $0.10/GB/dag) ef þær hafa verið notaðar að minnsta kosti einu sinni í Run sem var búið til eftir 17. apríl 2024.

• Eytt ef þær hafa ekki verið notaðar í einu Run á tímabilinu 17. apríl 2024 til 31. desember 2024 — þetta er til að koma í veg fyrir að þú verðir rukkaður fyrir vigurgeymslur sem þú gætir hafa búið til áður en þessi verðbreyting var tilkynnt en aldrei notað.

Eru takmörk á því hversu marga aðstoðarmenn ég get búið til?

Engin takmörk eru á því hversu marga aðstoðarmenn fyrirtæki getur búið til.

Er streymi í boði í API-inu?

Já, streymi er í boði í Assistants API.

Er JSON-stilling í boði í Assistants API?

Já, JSON-stilling er í boði í Assistants API með færibreytunni response_format á Assistants- eða Run-hlutum.

Mun Assistants API einnig stjórna beiðnum fyrir eiginleikaköll til þriðja aðila?

Nei. Þótt eiginleikakall geri líkaninu kleift að velja verkfæri og forsníða beiðnir fyrir þau er framkvæmd kalla til verkfæra þriðja aðila ekki stjórnað af OpenAI.

Hvernig er farið með gögnin sem ég sendi til OpenAI?

Eins og á öðrum hlutum vettvangsins okkar eru gögn og skrár sem send eru til OpenAI API aldrei notuð til að þjálfa líkönin okkar og þú getur eytt gögnunum þínum hvenær sem þú þarft. Gögnin sem hlaðið er upp í Assistants API eru geymd um óákveðinn tíma þar til notandi eyðir þeim handvirkt.

Er DALL-E í boði í gegnum Assistants API?

Sem stendur er DALL-E ekki í boði.

Er til notendaviðmót fyrir Assistants API?

Þú getur skoðað Playground fyrir Assistants API. Gakktu úr skugga um að þú sért í Assistants-yfirlitinu í vinstri hliðarstikunni og notir líkan sem er samhæft við verkfærin sem þú vilt kveikja á.

Hver eru stafatakmörk leiðbeininga fyrir aðstoðarmenn í Assistants API?

Reiturinn fyrir leiðbeiningar aðstoðarmanns hefur hámarkslengd upp á 256.000 stafi.

Ég fæ villu á borð við „Villa kom upp á þjóninum við vinnslu beiðni þinnar. Okkur þykir það leitt! Þú getur reynt beiðnina aftur eða haft samband við okkur í gegnum Hjálparmiðstöðina okkar á help.openai.com ef villan heldur áfram. “ Hvað ætti ég að gera?

Ef þú færð þessa villu gæti það þýtt að kvaðningin þín sé ekki rétt sett upp. Ef þú heldur áfram að reyna beiðnina aftur og hún mistekst eru hér nokkur atriði til að prófa:

1. gakktu úr skugga um að endurskipuleggja kvaðninguna þína þannig að skipanir sem líkjast eiginleikum séu meðhöndlaðar sem eiginleikar

2. bættu öllum skipunum í kvaðningunni þinni við sem eiginleika í tools

Af hverju virkar File Search-verkfærið mitt ekki vel?

Þegar File Search-verkfærið er notað mælum við með að stilla max_prompt_tokens á ekki minna en 20.000. Fyrir lengri samtöl eða margar aðgerðir með File Search skaltu íhuga að hækka þessi mörk í 50.000 eða helst fjarlægja max_prompt_tokens-mörkin alveg til að fá niðurstöður í hæstu gæðum. Lestu meira hér.

Hvernig get ég veitt endurgjöf?

Okkur þætti vænt um að heyra endurgjöf þína á Developer Forum, í gegnum Hjálparmiðstöðina á help.openai.com eða á Twitter @OpenAIDevs.