Ակնարկ

Agents API-ն հասանելի է բետա տարբերակով։ Այն մշակողներին թույլ է տալիս ստեղծել հավելվածներ՝ OpenAI-ի կողմից կառավարվող Codex ագենտով, որը կարող է կատարել բազմաքայլ աշխատանք և այն շարունակել նույն աշխատաշրջանում։

Ձեր հավելվածը տրամադրում է առաջադրանքը, գործիքներն ու կազմաձևումը։ OpenAI-ն կառավարում է ագենտի աշխատաշրջանը և համակարգում նրա մոդելի ու գործիքների փոխգործակցությունը։

Ի՞նչ կարող է անել ագենտը։

Կախված իր գործիքներից և կատարման միջավայրից՝ ագենտը կարող է գործարկել կոդ, խմբագրել ֆայլեր, օգտագործել MCP կապեր և ֆայլեր ստեղծել ձեր հավելվածի համար։ Նույն աշխատաշրջանում կարող եք ուղարկել լրացուցիչ հրահանգներ կամ շարունակել մեկ այլ առաջադրանքով։

Աջակցվող հնարավորություններին և օրինակներին ծանոթանալու համար տեսեք Agents API-ի ակնարկը։

Ինչպե՞ս սկսել։

1. OpenAI հարթակի ձեր նախագծում ստեղծեք հավելվածի API բանալի։ Տրամադրեք api.agents.read և api.agents.write թույլտվությունները՝ աշխատաշրջանների համար, ինչպես նաև api.responses.write թույլտվությունը՝ մոդելին ուղղված հարցումների համար։

2. Հետևեք արագ մեկնարկի ուղեցույցին՝ ագենտը կազմաձևելու, աշխատաշրջան ստեղծելու և առաջադրանք ուղարկելու համար։

3. Հետևեք աշխատաշրջանի իրադարձություններին՝ ընթացքին և արդյունքներին ծանոթանալու համար։ Պահեք աշխատաշրջանի ID-ն, եթե ցանկանում եք շարունակել աշխատանքը։

Ձեր API բանալին պահեք ագենտի մեկուսացված միջավայրից դուրս։ Հարցումների համար պահանջվում է OpenAI-Beta: agents=v1 վերնագիրը։ OpenAI-ի SDK-ներն այս վերնագիրն ավելացնում են ինքնաբերաբար։

Իմ ագենտին մեկուսացված միջավայր պե՞տք է։

Ընտրեք առաջադրանքին համապատասխան միջավայրը․

• Առանց միջավայրի․ ագենտը պատասխանում է հարցերին կամ օգտագործում արտաքին գործիքներ՝ առանց ներկառուցված հրամանային միջավայրի հրամանների կամ աշխատանքային տարածքի ֆայլերի կարիքի։

• OpenAI-ում տեղակայված մեկուսացված միջավայր․ ագենտին անհրաժեշտ է գործարկել սկրիպտներ կամ աշխատել ֆայլերի հետ, և դուք ցանկանում եք, որ OpenAI-ն կառավարի նրա մեկուսացված միջավայրը։

• Ինքնուրույն տեղակայված մեկուսացված միջավայր․ ձեզ անհրաժեշտ է սեփական ենթակառուցվածք, ծրագրային ապահովում կամ մասնավոր ցանց։ Ձեր հավելվածը կառավարում է միջավայրի կյանքի ցիկլը։

Կազմաձևման մանրամասները տեսեք Agents API-ի ճարտարապետության նկարագրության մեջ։

Որտե՞ղ կարող եմ ուսումնասիրել աշխատաշրջանը։

Բացեք հարթակի կառավարման վահանակի «Գրանցամատյաններ» բաժինը, ընտրեք «Ագենտներ» և որոնեք աշխատաշրջանի ID-ն։ Կարող եք ուսումնասիրել հաղորդակցման փուլերը, գործիքների կանչերը և ենթաագենտների գործողությունները։

Դիտարկելիության ուղեցույցը նաև բացատրում է, թե ինչպես դիտել թոքենների օգտագործման գրանցված տվյալները։

Ի՞նչ անել, եթե իրադարձությունների հոսքի կապն ընդհատվի։

Կրկին փորձելուց առաջ առբերեք առկա աշխատաշրջանը և դրանում պահպանված տարրերը։ Սա կօգնի ստուգել, թե ինչ է տեղի ունեցել, նախքան նոր աշխատանք ուղարկելը։

Հաղորդակցման փուլի ավարտը չի նշանակում, որ բոլոր գործիքները հաջողությամբ են աշխատել։ Ուսումնասիրեք հաղորդված արդյունքը։ Միայն այն փաստը, որ աշխատաշրջանը սպասման վիճակում է, չի հաստատում առաջադրանքի հաջող ավարտը։

Ինչպե՞ս է հաշվարկվում օգտագործման վճարը։

Մոդելին ուղղված հարցումների համար կիրառվում են ընտրված մոդելի API-ի սակագները։ OpenAI-ի գործիքների և OpenAI-ում տեղակայված մեկուսացված միջավայրերի համար կիրառվում են գործիքների և կոնտեյներների համապատասխան սակագները։

Գործող սակագները տեսեք API-ի գնացանկում։

Ինչպե՞ս են կառավարվում աշխատաշրջանի տվյալներն ու ֆայլերը։

Agents API-ն պահպանում է աշխատաշրջանի վիճակը, որպեսզի աշխատանքը հնարավոր լինի շարունակել հաղորդակցման հաջորդ փուլերում։ Կարող եք ջնջել աշխատաշրջաններն ու հրապարակված արտեֆակտները, երբ դրանք այլևս անհրաժեշտ չեն։ Աշխատաշրջանը ջնջելուց առաջ պահեք ձեզ անհրաժեշտ բոլոր ֆայլերը։

Agents API-ն ներկայում աջակցում է տվյալների մշակման հավելվածին միայն Միացյալ Նահանգներում։ Այն չի աջակցում «ոչ մի պահվող տվյալ» ռեժիմին, նույնիսկ երբ օգտագործում եք ինքնուրույն տեղակայված մեկուսացված միջավայր։ Տվյալների կառավարման մանրամասները տեսեք Agents API-ի փաստաթղթերում։