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.
Mikä Assistants API on?
Assistants API mahdollistaa kehittäjille tehokkaiden AI-avustajien helpon rakentamisen sovelluksiinsa. Tämä API poistaa tarpeen hallita keskusteluhistoriaa ja lisää pääsyn OpenAI:n isännöimiin työkaluihin, kuten koodintulkitsimeen ja File Searchiin. API tukee myös parannettua toiminnon kutsumista kolmannen osapuolen työkaluille.
Voinko yhä käyttää Assistants API v1 beta -versiota?
Et. 18. joulukuuta 2024 alkaen käyttäjillä ei enää ole pääsyä Assistant API beta -version v1-versioon. Tuemme tällä hetkellä vain v2:ta. Tutustu tähän siirtymisoppaaseen, jotta voit muuntaa API-kutsusi v1:stä v2:een
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 edustaa tiettyyn tarkoitukseen rakennettua AI:ta, joka käyttää OpenAI:n malleja ja voi käyttää tiedostoja, ylläpitää pysyviä säikeitä ja kutsua työkaluja.
Mikä on säie?
Säie on avustajan ja käyttäjän välinen keskusteluistunto. Säikeet yksinkertaistavat sovelluskehitystä tallentamalla viestihistorian ja lyhentämällä sitä, kun keskustelu kasvaa liian pitkäksi mallin kontekstipituudelle.
Mikä File Search -työkalu on?
`file_search`-työkalu toteuttaa valmiiksi useita haun parhaita käytäntöjä, jotta voit poimia tiedostoistasi oikeat tiedot mallin vastausten täydentämiseksi. Lisätietoja on kehittäjädokumentaatiossamme.
Oletusarvoisesti file_search-työkalu käyttää seuraavia asetuksia:
Lohkon koko: 800 tokenia
Lohkojen päällekkäisyys: 400 tokenia
Upotusmalli: `text-embedding-3-large`, 256 ulottuvuutta
Kontekstiin lisättävien lohkojen enimmäismäärä: 20
Mitkä ovat tiedoston lataamisen rajoitukset?
Tiedoston lataamista koskevat rajoitukset ovat:
512 Mt tiedostoa kohden
5M tokenia tiedostoa kohden
10k tiedostoa vektorivarastoa kohden
1 vektorivarasto avustajaa kohden
1 vektorivarasto säiettä kohden
Organisaation kunkin projektin kokonaistallennusraja on 100 Gt.
Mitkä ovat File Search -työkalun rajoitukset?
Meillä on muutamia tunnettuja rajoituksia, joihin pyrimme lisäämään tuen tulevien kuukausien aikana:
Tällä hetkellä lohkomisen, upotusten tai haun asetuksia ei voi muuttaa.
Emme tue asiakirjoissa olevien kuvien jäsentämistä.
Emme tue hakuja rakenteisista tiedostomuodoista (kuten .csv- tai .jsonl-tiedostoista). Katso tuetut tiedostotyypit.
Mitkä ovat Assistants API:n pyyntörajat?
Assistants API:n pyyntörajat eivät ole sidottuja käyttötasoon ja malliin. Sen sijaan oletusrajat määräytyvät pyyntötyypin mukaan, muutamin poikkeuksin:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 pyyntöä minuutissa
Miten koodintulkitsin on hinnoiteltu API:ssa?
Koodintulkitsimen hinta on 0,03 $ / istunto. Jos avustajasi kutsuu koodintulkitsinta samanaikaisesti kahdessa eri säikeessä, tämä luo kaksi koodintulkitsimen istuntoa (2 * 0,03 $). Kukin istunto on oletusarvoisesti aktiivinen yhden tunnin, mikä tarkoittaa, että maksaisit tämän maksun vain kerran, jos käyttäjäsi antaa ohjeita koodintulkitsimelle samassa säikeessä enintään tunnin ajan.
Miten File Search on hinnoiteltu API:ssa?
File Searchin hinta on 0,10 $/Gt vektorivaraston tallennustilaa päivässä (ensimmäinen Gt tallennustilaa on ilmainen). Vektorivaraston koko perustuu vektorivaraston lopulliseen kokoon sen jälkeen, kun tiedostosi on jäsennetty, lohkottu ja upotettu.
Kaikki ennen 17. huhtikuuta 2024 luodut vektorivarastot ovat ilmaisia vuoden 2024 loppuun asti, minkä jälkeen ne joko:
Laskutetaan nykyisten hintojen mukaan (tällä hetkellä 0,10 $/Gt/päivä), jos niitä on käytetty vähintään kerran Runissa, joka on luotu 17. huhtikuuta 2024 jälkeen.
Poistetaan, jos niitä ei ole käytetty yhdessäkään Runissa 17. huhtikuuta 2024 ja 31. joulukuuta 2024 välisenä aikana — näin vältetään se, että sinua laskutetaan vektorivarastoista, jotka olet ehkä luonut ennen tämän hinnoittelumuutoksen ilmoittamista mutta joita et ole koskaan käyttänyt.
Onko luotavien avustajien määrälle rajaa?
Organisaation luomien avustajien määrälle ei ole rajaa.
Onko suoratoisto saatavilla API:ssa?
Kyllä, suoratoisto on saatavilla Assistants API:ssa.
Onko JSON-tila saatavilla Assistants API:ssa?
Kyllä, JSON-tila on saatavilla Assistants API:ssa Assistants- tai Run-objektien response_format-parametrin kautta.
Hallitseeko Assistants API myös kolmannen osapuolen toimintokutsujen pyyntöjä?
Ei. Vaikka toiminnon kutsuminen antaa mallille mahdollisuuden valita työkaluja ja muotoilla niille pyyntöjä, OpenAI ei hallinnoi kolmannen osapuolen työkalujen kutsujen suorittamista.
Miten OpenAI:lle lähettämiäni tietoja käsitellään?
Kuten muullakin alustallamme, OpenAI API:lle välitettyjä tietoja ja tiedostoja ei koskaan käytetä malliemme kouluttamiseen, ja voit poistaa tietosi milloin tahansa. Assistants API:in ladatut tiedot tallennetaan toistaiseksi, kunnes käyttäjä poistaa ne manuaalisesti.
Onko DALL-E saatavilla Assistants API:n kautta?
Tällä hetkellä DALL-E ei ole saatavilla.
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:ssa?
Avustajan ohjeet -kentän enimmäispituus on 256 000 merkkiä.
Saan virheilmoituksen, kuten ”Palvelimella tapahtui virhe pyyntöäsi käsiteltäessä. Pahoittelut siitä! Voit yrittää pyyntöäsi uudelleen tai ottaa meihin yhteyttä ohjekeskuksemme kautta osoitteessa help.openai.com, jos virhe jatkuu. ” Mitä minun pitäisi tehdä?
Jos saat tämän virheen, se voi tarkoittaa, että kehotettasi ei ole määritetty oikein. Jos yrität pyyntöä uudelleen ja se epäonnistuu, kokeile seuraavia asioita:
varmista, että muotoilet kehotteesi uudelleen niin, että kaikkia funktion kaltaisia komentoja käsitellään funktioina
lisää kehotteessasi olevat komennot funktioina kohteeseen
tools
Miksi File Search -työkaluni ei toimi hyvin?
Kun käytät File Search -työkalua, suosittelemme asettamaan max_prompt_tokens-arvoksi vähintään 20 000. Pidemmissä keskusteluissa tai useissa File Search -vuorovaikutuksissa harkitse tämän rajan nostamista 50 000:een tai mieluiten max_prompt_tokens-rajojen poistamista kokonaan, jotta saat laadukkaimmat tulokset. Lue lisää täältä.
Miten voin antaa palautetta?
Kuulemme mielellämme palautteesi kehittäjäfoorumillamme, ohjekeskuksen kautta osoitteessa help.openai.com tai Twitterissä @OpenAIDevs.