OpenAI
Ukurasa huu ulitafsiriwa na mashine. Tazama makala asili ya Kiingereza.

Maswali Yanayoulizwa Mara kwa Mara ya Assistants API (v2)

Kagua vipengele, vikomo na bei za Assistants API v2, pamoja na uhamishaji kwenda Responses API.

Ilisasishwa: 6 days ago

Kufikia Machi 11, 2025, tumetoa vipengele vya msingi vya jukwaa letu jipya la Agents. Kwa maelezo, angalia hati zetu za API za Responses API, Tools ikijumuisha Web Search, File Search, na Computer Use, na Agents SDK yetu yenye Tracing. Kulingana na maoni yako kuhusu Assistants API beta, tumejumuisha maboresho muhimu katika Responses API. Baada ya kufikia usawa kamili wa vipengele, tutatangaza mpango wa kusitisha Assistants API baadaye mwaka huu, tukiwa na tarehe lengwa ya kuizima katika nusu ya kwanza ya 2026.

Maswali yanayoulizwa mara kwa mara

Assistants API ni nini?

Assistants API huwawezesha wasanidi programu kuunda kwa urahisi wasaidizi wa AI wenye uwezo mkubwa ndani ya programu zao. API hii huondoa haja ya kudhibiti historia ya mazungumzo na kutoa ufikiaji wa zana zinazopangishwa na OpenAI kama vile Kifasiri cha Msimbo na Utafutaji wa Faili. API pia inaauni mgao wa kiutendaji ulioboreshwa kwa zana za wahusika wengine.

Je, bado ninaweza kutumia toleo la beta la Assistants API v1?

La. Kuanzia 18 Desemba 2024, watumiaji hawana tena ufikiaji wa toleo la v1 la beta la Assistant API. Kwa sasa tunatumia v2 pekee. Tafadhali soma mwongozo huu wa uhamishaji ili kubadilisha miito yako ya API kutoka v1 hadi v2.

Ninaipataje?

Assistants API inapatikana kwa yeyote aliye na akaunti ya OpenAI API, lakini imepitwa na wakati na itaondolewa Agosti 2026. Kwa miradi mipya, tumia Responses API badala yake. Ikiwa tayari unatumia Assistants API, panga uhamishaji wako kwenda Responses API. Bado unaweza kufikia assistants waliopo katika Assistants Playground wakati API bado inapatikana.

Msaidizi ni nini?

Msaidizi ni AI iliyoundwa kwa kusudi maalumu inayotumia miundo ya OpenAI na inayoweza kufikia faili, kuhifadhi mifululizo ya mazungumzo kwa matumizi ya baadaye na kuita zana.

Mfululizo wa mazungumzo ni nini?

Mfululizo wa mazungumzo ni kipindi cha mazungumzo kati ya msaidizi na mtumiaji. Mifululizo ya mazungumzo hurahisisha uundaji wa programu kwa kuhifadhi historia ya ujumbe na kuipunguza mazungumzo yanapozidi urefu wa muktadha unaoweza kushughulikiwa na muundo.

Zana ya Utafutaji wa Faili ni nini?

Zana ya file_search hutumia mbinu kadhaa bora za urejeshaji wa taarifa bila kuhitaji usanidi wa ziada, ili kukusaidia kutoa data sahihi kutoka kwenye faili zako na kuimarisha majibu ya muundo.

Kwa chaguomsingi, zana ya file_search hutumia mipangilio ifuatayo:

  • Ukubwa wa kipande: tokeni 800

  • Mwingiliano wa vipande: tokeni 400

  • Muundo wa upachikaji: text-embedding-3-large wenye vipimo 256

  • Idadi ya juu zaidi ya vipande vinavyoongezwa kwenye muktadha: 20

Kuna vikomo gani vya kupakia faili?

Vikomo vya kupakia faili ni:

  • MB 512 kwa kila faili

  • Tokeni milioni 5 kwa kila faili

  • Faili 10,000 kwa kila hifadhi ya vekta

  • Hifadhi 1 ya vekta kwa kila msaidizi

  • Hifadhi 1 ya vekta kwa kila mfululizo wa mazungumzo

Kikomo cha jumla cha hifadhi kwa kila mradi katika shirika ni GB 100.

Zana ya Utafutaji wa Faili ina mapungufu gani?

Tunafahamu mapungufu machache ambayo tunajitahidi kuyatatua kwa kuongeza uwezo katika miezi ijayo:

  1. Kwa sasa hakuna njia ya kubadilisha mipangilio ya ugawaji katika vipande, upachikaji au urejeshaji wa taarifa.

  2. Hatuauni uchanganuzi wa picha zilizo ndani ya hati.

  3. Hatuauni urejeshaji wa taarifa kutoka kwenye faili zenye miundo maalumu ya data (kama faili za .csv au .jsonl). Angalia aina za faili zinazotumika.

Vikomo vya idadi ya maombi kwa Assistants API ni vipi?

Vikomo vya idadi ya maombi kwa Assistants API havitegemei kiwango cha matumizi na muundo. Badala yake, kuna vikomo vya chaguomsingi kulingana na aina ya ombi, isipokuwa katika hali chache:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: maombi 300 kwa dakika

Kifasiri cha Msimbo katika API kinatozwa vipi?

Kifasiri cha Msimbo kinatozwa $0.03 kwa kila kipindi. Msaidizi wako akiita Kifasiri cha Msimbo kwa wakati mmoja katika mifululizo ya mazungumzo miwili tofauti, vipindi viwili vya Kifasiri cha Msimbo vitaundwa (2 * $0.03). Kwa chaguomsingi, kila kipindi huendelea kutumika kwa saa moja. Hii inamaanisha kuwa utalipa ada hii mara moja tu ikiwa mtumiaji wako ataendelea kutoa maagizo kwa Kifasiri cha Msimbo katika mfululizo uleule wa mazungumzo kwa hadi saa moja.

Utafutaji wa Faili katika API unatozwa vipi?

Utafutaji wa Faili unatozwa $0.10 kwa kila GB ya hifadhi ya vekta kwa siku (GB ya kwanza ya hifadhi ni bila malipo). Ukubwa wa hifadhi ya vekta hutegemea ukubwa unaopatikana baada ya faili yako kuchanganuliwa, kugawanywa katika vipande na kupachikwa kama vekta.

Hifadhi zozote za vekta zilizoundwa kabla ya tarehe 17 Aprili 2024 zitakuwa bila malipo hadi mwisho wa 2024. Baada ya hapo:

  • Zitatozwa kwa viwango vya wakati huo (kwa sasa $0.10/GB/siku) ikiwa zimetumika angalau mara moja katika Run iliyoundwa baada ya tarehe 17 Aprili 2024.

  • Zitafutwa ikiwa hazijatumika katika Run hata moja kati ya tarehe 17 Aprili 2024 na 31 Desemba 2024 — hii ni ili usitozwe kwa hifadhi za vekta ambazo huenda uliunda kabla ya tangazo la mabadiliko haya ya bei lakini hukuwahi kuzitumia.

Je, kuna kikomo cha idadi ya assistants ninazoweza kuunda?

Hakuna kikomo cha idadi ya assistants ambayo shirika linaweza kuunda.

Je, utiririshaji unapatikana katika API?

Ndiyo, utiririshaji unapatikana katika Assistants API.

Je, hali ya JSON inapatikana katika Assistants API?

Ndiyo, hali ya JSON inapatikana katika Assistants API kupitia kigezo cha response_format kwenye objekti za Assistants au Run.

Je, Assistants API pia itasimamia maombi ya kuita vitendakazi vya wahusika wengine?

Hapana. Ingawa mgao wa kiutendaji huwezesha muundo kuchagua zana na kuandaa maombi kwa zana hizo katika muundo unaofaa, OpenAI haisimamii utekelezaji wa miito kwa zana za wahusika wengine.

Data ninayotuma kwa OpenAI inashughulikiwa vipi?

Kama ilivyo katika sehemu nyingine za jukwaa letu, data na faili zinazotumwa kwa OpenAI API hazitumiwi kamwe kufunza miundo yetu, na unaweza kufuta data yako wakati wowote unapotaka. Data inayopakiwa kwenye Assistants API huhifadhiwa bila kikomo cha muda hadi mtumiaji aifute mwenyewe.

Je, DALL-E inapatikana kupitia Assistants API?

Kwa sasa, DALL-E haipatikani.

Je, kuna UI ya Assistants API?

Unaweza kuangalia Playground ya Assistants API. Hakikisha uko katika mwonekano wa Assistants kwenye upau wa kando wa kushoto na unatumia muundo unaoendana na Tools unazotaka kuwasha.

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

Kikomo cha herufi kwa maagizo ya msaidizi katika Assistants API ni kipi?

Sehemu ya maagizo ya msaidizi ina kikomo cha herufi 256,000.

Ninapata hitilafu kama vile “Seva imepata hitilafu wakati wa kuchakata ombi lako. Samahani kwa hilo! Unaweza kujaribu kutuma ombi lako tena, au uwasiliane nasi kupitia kituo chetu cha usaidizi katika help.openai.com ikiwa hitilafu itaendelea. ” Nifanye nini?

Ikiwa unapata hitilafu hii, huenda dokeza lako halijaandaliwa ipasavyo. Ikiwa unaendelea kutuma ombi tena lakini halifaulu, jaribu yafuatayo:

  1. hakikisha umepanga upya dokeza lako ili amri zozote zinazofanana na vitendakazi zichukuliwe kuwa vitendakazi

  2. ongeza amri zozote zilizo katika dokeza lako kama kitendakazi kwenye tools

Kwa nini zana yangu ya Utafutaji wa Faili haifanyi kazi vizuri?

Unapotumia zana ya Utafutaji wa Faili, tunapendekeza uweke thamani ya max_prompt_tokens isiyopungua 20,000. Kwa mazungumzo marefu au matumizi ya Utafutaji wa Faili mara nyingi, zingatia kuongeza kikomo hiki hadi 50,000 au, ikiwezekana, kuondoa kabisa vikomo vya max_prompt_tokens ili upate matokeo bora zaidi.

Ninawezaje kutoa maoni?

Tungependa kusikia maoni yako kwenye Jukwaa letu la Wasanidi Programu, kupitia Kituo cha Usaidizi katika help.openai.com, au kwenye Twitter @OpenAIDevs.

Je, makala haya yamekusaidia?