11. maaliskuuta 2025 julkaisimme uuden Agents-alustamme rakennuspalikat. Lisätietoja on API-dokumentaatiossamme: Responses API, työkalut kuten Web Search, File Search ja Computer Use sekä Agents SDK ja Tracing. Assistants API betasta saamasi palautteen perusteella olemme sisällyttäneet keskeisiä parannuksia Responses API:in. Kun saavutamme täyden ominaisuusvastaavuuden, ilmoitamme Assistants API:n käytöstäpoistosuunnitelmasta myöhemmin tänä vuonna, ja tavoitteena on lopettaa se vuoden 2026 ensimmäisellä puoliskolla.
Usein kysytyt kysymykset
Mikä on Assistants API -rajapinta?
Assistants API -rajapinnan avulla kehittäjät voivat helposti rakentaa tehokkaita tekoälyavustajia sovelluksiinsa. Tämä API-rajapinta poistaa tarpeen hallita keskusteluhistoriaa ja tarjoaa käyttöön OpenAI:n ylläpitämiä työkaluja, kuten koodintulkitsimen ja File Search -työkalun. API-rajapinta tukee myös entistä parempaa toiminnon kutsumista kolmannen osapuolen työkaluissa.
Voinko edelleen käyttää Assistants API v1:n beetaversiota?
Et. Käyttäjillä ei ole enää ollut 18. joulukuuta 2024 alkaen pääsyä Assistant APIn beetaversion v1-versioon. Tuemme tällä hetkellä vain v2-versiota. Tässä siirtymäoppaassa kerrotaan, miten API-kutsut muunnetaan v1-versiosta v2-versioon.
Miten saan siihen pääsyn?
Assistants API on kaikkien OpenAI API -tilin omistajien saatavilla, mutta se on vanhentunut ja poistetaan elokuussa 2026. Käytä uusissa projekteissa sen sijaan Responses API:a. Jos käytät jo Assistants API:a, suunnittele siirtymisesi Responses API:in. Voit edelleen käyttää olemassa olevia avustajia Assistants Playgroundissa niin kauan kuin API on saatavilla.
Mikä on avustaja?
Avustaja on tiettyyn tarkoitukseen luotu tekoäly, joka käyttää OpenAI:n malleja ja pystyy käyttämään tiedostoja, ylläpitämään pysyviä keskusteluketjuja ja kutsumaan työkaluja.
Mikä on keskusteluketju?
Keskusteluketju on avustajan ja käyttäjän välinen keskusteluistunto. Keskusteluketjut helpottavat sovelluskehitystä tallentamalla viestihistorian ja lyhentämällä sitä, kun keskustelu kasvaa liian pitkäksi mallin kontekstiin.
Mikä on File Search -työkalu?
file_search-työkalu hyödyntää valmiiksi useita tiedonhaun parhaita käytäntöjä, joiden avulla löydät tiedostoistasi oikeat tiedot mallin vastausten täydentämiseen.
file_search-työkalu käyttää oletusarvoisesti seuraavia asetuksia:
Tekstilohkon koko: 800 tokenia
Tekstilohkojen päällekkäisyys: 400 tokenia
Upotusmalli: text-embedding-3-large, 256 ulottuvuutta
Kontekstiin lisättävien tekstilohkojen enimmäismäärä: 20
Mitä rajoituksia tiedostojen lataamisessa on?
Tiedostojen lataamista koskevat seuraavat rajoitukset:
512 Mt tiedostoa kohden
5 miljoonaa tokenia tiedostoa kohden
10 000 tiedostoa vektorivarastoa kohden
1 vektorivarasto avustajaa kohden
1 vektorivarasto keskusteluketjua kohden
Organisaation kunkin projektin kokonaistallennustila on rajoitettu 100 gigatavuun.
Mitä rajoituksia File Search -työkalulla on?
Työkalussa on muutamia tunnettuja rajoituksia, joita pyrimme poistamaan lisäämällä tukea seuraaville ominaisuuksille tulevien kuukausien aikana:
Pilkkomisen, upotusten tai tiedonhaun asetuksia ei tällä hetkellä voi muuttaa.
Asiakirjoissa olevien kuvien jäsentämistä ei tueta.
Tiedonhakua rakenteisista tiedostomuodoista (kuten .csv- tai .jsonl-tiedostoista) ei tueta. Katso tuetut tiedostotyypit.
Mitkä ovat Assistants API -rajapinnan pyyntörajat?
Assistants API -rajapinnan pyyntörajat eivät riipu käyttötasosta ja mallista. Sen sijaan oletusrajat määräytyvät pyyntötyypin mukaan muutamaa poikkeusta lukuun ottamatta:
GET: 1 000 pyyntöä minuutissa
POST: 300 pyyntöä minuutissa
DELETE: 300 pyyntöä minuutissa
Miten koodintulkitsimen käyttö API-rajapinnassa hinnoitellaan?
Koodintulkitsimen hinta on 0,03 dollaria istunnolta. Jos avustajasi kutsuu koodintulkitsinta samanaikaisesti kahdessa eri keskusteluketjussa, syntyy kaksi koodintulkitsimen istuntoa (2 × 0,03 dollaria). Kukin istunto on oletusarvoisesti aktiivinen tunnin ajan. Maksat siis tämän maksun vain kerran, jos käyttäjäsi jatkaa ohjeiden antamista koodintulkitsimelle samassa keskusteluketjussa enintään tunnin ajan.
Miten File Search -työkalun käyttö API-rajapinnassa hinnoitellaan?
File Search -työkalun hinta on 0,10 dollaria päivässä vektorivaraston tallennustilan gigatavua kohden (ensimmäinen gigatavu on maksuton). Vektorivaraston koko määräytyy sen mukaan, kuinka paljon tilaa tiedostosi vie jäsentämisen, pilkkomisen ja upotusten luomisen jälkeen.
Kaikki ennen 17.4.2024 luodut vektorivarastot ovat maksuttomia vuoden 2024 loppuun asti. Sen jälkeen ne joko:
Laskutetaan voimassa olevan hinnaston mukaisesti (tällä hetkellä 0,10 dollaria/Gt/päivä), jos niitä on käytetty vähintään kerran 17.4.2024 jälkeen luodussa Run-suorituksessa.
Poistetaan, jos niitä ei ole käytetty yhdessäkään Run-suorituksessa 17.4.–31.12.2024. Näin sinua ei laskuteta vektorivarastoista, jotka olet saattanut luoda ennen tämän hinnoittelumuutoksen julkistamista mutta joita et ole koskaan käyttänyt.
Onko luotavien avustajien määrälle rajaa?
Organisaation luomien avustajien määrälle ei ole rajaa.
Tukeeko API-rajapinta suoratoistoa?
Kyllä, Assistants API -rajapinta tukee suoratoistoa.
Onko JSON-tila käytettävissä Assistants API -rajapinnassa?
Kyllä, JSON-tila on käytettävissä Assistants API -rajapinnassa Assistants- tai Run-objektien response_format-parametrin kautta.
Hallinnoiko Assistants API -rajapinta myös kolmannen osapuolen toimintokutsujen pyyntöjä?
Ei. Toiminnon kutsuminen antaa mallille mahdollisuuden valita työkaluja ja muotoilla niille pyyntöjä, mutta OpenAI ei hallinnoi kolmannen osapuolen työkaluihin tehtävien kutsujen suorittamista.
Miten OpenAI:lle lähettämiäni tietoja käsitellään?
Kuten muuallakin alustallamme, OpenAI:n API-rajapintaan lähetettyjä tietoja ja tiedostoja ei koskaan käytetä malliemme kouluttamiseen, ja voit poistaa tietosi milloin tahansa. Assistants API -rajapintaan ladatut tiedot säilytetään toistaiseksi, kunnes käyttäjä poistaa ne manuaalisesti.
Onko DALL-E käytettävissä Assistants API -rajapinnan kautta?
DALL-E ei ole tällä hetkellä käytettävissä.
Onko Assistants API:lle käyttöliittymää?
Voit tutustua Assistants API:n Playgroundiin. Varmista, että olet vasemman sivupalkin Assistants-näkymässä ja käytät mallia, joka on yhteensopiva niiden työkalujen kanssa, jotka haluat ottaa käyttöön.
Mikä on avustajan ohjeiden merkkiraja Assistants API -rajapinnassa?
Avustajan ohjekentän enimmäispituus on 256 000 merkkiä.
Saan seuraavanlaisen virheilmoituksen: ”Palvelimessa tapahtui virhe pyyntöäsi käsiteltäessä. Pahoittelemme! Voit yrittää pyyntöä uudelleen. Jos virhe toistuu, ota meihin yhteyttä ohjekeskuksen kautta osoitteessa help.openai.com. ” Mitä minun pitäisi tehdä?
Tämä virhe voi tarkoittaa, että kehotteesi ei ole oikein määritetty. Jos pyyntö epäonnistuu toistuvista yrityksistä huolimatta, kokeile seuraavia keinoja:
muokkaa kehotteen rakennetta niin, että kaikkia funktion kaltaisia komentoja käsitellään funktioina
lisää kehotteesi kaikki komennot funktioina tools-kenttään
Miksi File Search -työkaluni ei toimi hyvin?
Kun käytät File Search -työkalua, suosittelemme asettamaan max_prompt_tokens-parametrin arvoksi vähintään 20 000. Jos keskustelut ovat pitkiä tai File Search -työkalua käytetään useita kertoja, harkitse rajan nostamista 50 000:een. Parhaat tulokset saat poistamalla max_prompt_tokens-rajoitukset kokonaan.
Miten voin antaa palautetta?
Otamme mielellämme vastaan palautettasi kehittäjäfoorumillamme, ohjekeskuksen kautta osoitteessa help.openai.com tai Twitterissä tilillä @OpenAIDevs.