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

Maswali Yanayoulizwa Mara kwa Mara ya Assistants API (v2)

Ilisasishwa: 14 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.

Assistants API ni nini?

Assistants API huwawezesha wasanidi programu kujenga kwa urahisi assistants wenye nguvu wa AI ndani ya programu zao. API hii huondoa haja ya kudhibiti historia ya mazungumzo na huongeza ufikiaji wa zana zinazopangishwa na OpenAI kama Kifasiri cha Msimbo na File Search. API pia inasaidia mgao wa kiutendaji ulioboreshwa kwa zana za wahusika wengine.

Je, bado ninaweza kutumia Assistants API v1 beta?

Hapana. Kuanzia Desemba 18, 2024 watumiaji hawana tena ufikiaji wa toleo la v1 la Assistant API beta. Kwa sasa tunaunga mkono v2 pekee. Tafadhali angalia 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.

Assistant ni nini?

Assistant huwakilisha AI iliyoundwa kwa kusudi maalum inayotumia miundo ya OpenAI na inaweza kufikia faili, kudumisha nyuzi endelevu, na kuita zana.

Thread ni nini?

Thread ni kipindi cha mazungumzo kati ya assistant na mtumiaji. Threads hurahisisha uundaji wa programu kwa kuhifadhi historia ya ujumbe na kuipunguza mazungumzo yanapokuwa marefu kupita urefu wa muktadha wa muundo.

Zana ya File Search ni nini?

Zana ya `file_search` hutekeleza mbinu kadhaa bora za urejeshaji moja kwa moja ili kukusaidia kutoa data sahihi kutoka kwenye faili zako ili kuboresha majibu ya muundo. Kwa maelezo zaidi, tafadhali soma hati zetu za wasanidi programu.

Kwa chaguomsingi, zana ya file_search hutumia mipangilio ifuatayo:

  • Ukubwa wa kipande: tokeni 800

  • Muingiliano wa vipande: tokeni 400

  • Muundo wa embedding: `text-embedding-3-large` katika vipimo 256

  • Idadi ya juu ya vipande vinavyoongezwa kwenye muktadha: 20

Vikwazo vya kupakia Faili ni vipi?

Vikwazo vya kupakia Faili ni:

  • MB 512 kwa kila faili

  • Tokeni milioni 5 kwa kila faili

  • Faili 10k kwa kila hifadhi ya vekta

  • Hifadhi 1 ya vekta kwa kila assistant

  • Hifadhi 1 ya vekta kwa kila uzi

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

Vikwazo vya zana ya File Search ni vipi?

Tuna vikwazo vichache vinavyojulikana ambavyo tunashughulikia kuongeza usaidizi wake katika miezi ijayo:

  1. Kwa sasa hakuna njia ya kurekebisha mipangilio ya kugawanya vipande, embedding, au urejeshaji.

  2. Hatuauni uchanganuzi wa picha ndani ya hati.

  3. Hatuauni urejeshaji kwenye fomati za faili zilizopangwa (kama faili za .csv au .jsonl). Angalia aina za faili zinazotumika.

Vikomo vya maombi vya Assistants API ni vipi?

Vikomo vya maombi vya Assistants API havihusishwi na ngazi ya matumizi na muundo. Badala yake, kuna vikomo chaguomsingi kulingana na aina ya ombi, pamoja na vighairi vichache:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: maombi 300 kwa dakika

Bei ya Kifasiri cha Msimbo katika API ni gani?

Kifasiri cha Msimbo hugharimu $0.03 / kipindi. Ikiwa msaidizi wako ataita Kifasiri cha Msimbo kwa wakati mmoja katika nyuzi mbili tofauti, hii itaunda vipindi viwili vya Kifasiri cha Msimbo (2 * $0.03). Kila kipindi huwa amilifu kwa chaguomsingi kwa saa moja, maana yake utalipa ada hii mara moja tu ikiwa mtumiaji wako ataendelea kutoa maagizo kwa Kifasiri cha Msimbo katika uzi huo huo kwa hadi saa moja.

Bei ya File Search katika API ni gani?

File Search hugharimu $0.10/GB ya hifadhi ya hifadhi ya vekta kwa siku (GB ya kwanza ya hifadhi ni bure). Ukubwa wa hifadhi ya vekta hutegemea ukubwa unaotokana wa hifadhi ya vekta baada ya faili lako kuchanganuliwa, kugawanywa vipande, na kuwekewa embedding.

Hifadhi zozote za vekta zilizoundwa kabla ya Aprili 17, 2024 zitakuwa bure hadi mwisho wa 2024, kisha zitaweza kuwa:

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

  • Zitafutwa ikiwa hazijatumika katika Run yoyote kati ya Aprili 17, 2024 na Desemba 31, 2024 — hii ni kuepuka utozwe kwa hifadhi za vekta ambazo huenda uliunda kabla ya mabadiliko haya ya bei kutangazwa lakini hukuzitumia kamwe.

Je, kuna kikomo cha idadi ya assistants ninazoweza kuunda?

Hakuna kikomo cha idadi ya assistants ambayo shirika linaweza kuunda.

Je, utiririshaji unapatikana kwenye API?

Ndiyo, utiririshaji unapatikana kwenye Assistants API.

Je, hali ya JSON inapatikana katika Assistants API?

Ndiyo, hali ya JSON inapatikana kwenye Assistants API kupitia kigezo cha response_format kwenye vipengee vya Assistants au Run.

Je, Assistants API pia itasimamia maombi ya miito ya mgao wa kiutendaji ya wahusika wengine?

Hapana. Ingawa mgao wa kiutendaji huwezesha muundo kuchagua zana na kufomati maombi kwa ajili yake, utekelezaji wa miito kwa zana za wahusika wengine hausimamiwi na OpenAI.

Data ninayotuma kwa OpenAI hushughulikiwaje?

Kama ilivyo kwa sehemu nyingine ya jukwaa letu, data na faili zinazopitishwa kwa OpenAI API hazitumiwi kamwe kufunza miundo yetu na unaweza kufuta data yako wakati wowote unapohitaji. Data inayopakiwa kwenye Assistants API huhifadhiwa bila kikomo 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 assistant katika Assistants API ni kipi?

Sehemu ya maagizo ya assistant ina urefu wa juu wa herufi 256,000.

Ninapata hitilafu kama “Seva ilipata hitilafu ilipokuwa ikichakata ombi lako. Samahani kwa hilo! Unaweza kujaribu tena ombi lako, au uwasiliane nasi kupitia Kituo chetu cha Usaidizi kwenye help.openai.com ikiwa hitilafu itaendelea. ” Nifanye nini?

Ikiwa unapata hitilafu hii, huenda inamaanisha dokeza lako halijawekwa ipasavyo. Ikiwa unaendelea kujaribu tena ombi na linashindikana, haya ni baadhi ya mambo ya kujaribu:

  1. hakikisha unaunda upya dokeza lako ili lichukulie amri zozote zinazofanana na function kama functions

  2. ongeza amri zozote katika dokeza lako kama function kwenye tools

Kwa nini zana yangu ya File Search haifanyi kazi vizuri?

Unapotumia zana ya File Search, tunapendekeza kuweka max_prompt_tokens isiwe chini ya 20,000. Kwa mazungumzo marefu au mwingiliano mingi na File Search, zingatia kuongeza kikomo hiki hadi 50,000, au bora zaidi, kuondoa kabisa vikomo vya max_prompt_tokens ili kupata matokeo ya ubora wa juu zaidi. Soma zaidi hapa.

Ninawezaje kutoa maoni?

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

Je, makala haya yamekusaidia?