მიმოხილვა

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-ები ამ ჰედერს ავტომატურად ამატებს.

სჭირდება ჩემს აგენტს იზოლირებული გარემო?

აირჩიეთ დავალების შესაბამისი გარემო:

• გარემოს გარეშე: აგენტი პასუხობს კითხვებს ან იყენებს გარე ხელსაწყოებს ისე, რომ ჩაშენებული shell ბრძანებები ან სამუშაო სივრცის ფაილები არ სჭირდება.

• OpenAI-ზე განთავსებული იზოლირებული გარემო: აგენტს სჭირდება სკრიპტების გაშვება ან ფაილებთან მუშაობა და გსურთ, რომ მის იზოლირებულ გარემოს OpenAI მართავდეს.

• საკუთარ ინფრასტრუქტურაზე განთავსებული იზოლირებული გარემო: გჭირდებათ საკუთარი ინფრასტრუქტურა, პროგრამული უზრუნველყოფა ან კერძო ქსელი. გარემოს სასიცოცხლო ციკლს თქვენი აპლიკაცია მართავს.

კონფიგურაციის დეტალები იხილეთ Agents API-ის არქიტექტურის აღწერაში.

სად შემიძლია სესიის დათვალიერება?

გახსენით ჟურნალები პლატფორმის მართვის პანელში, აირჩიეთ აგენტები და მოძებნეთ სესიის ID. შეგიძლიათ შეამოწმოთ სვლები, ხელსაწყოების გამოძახებები და ქვეაგენტების აქტივობა.

დაკვირვებადობის სახელმძღვანელო ასევე განმარტავს, როგორ ნახოთ ტოკენების მოხმარების აღრიცხული მონაცემები.

რა უნდა გავაკეთო, თუ მოვლენების ნაკადთან კავშირი გაწყდება?

ხელახლა ცდამდე გამოითხოვეთ არსებული სესია და მასში შენახული ელემენტები. ეს დაგეხმარებათ, დამატებითი სამუშაოს გაგზავნამდე შეამოწმოთ, რა მოხდა.

სვლის დასრულება არ ნიშნავს, რომ ყველა ხელსაწყომ წარმატებით იმუშავა. შეამოწმეთ დაბრუნებული შედეგი. მხოლოდ ის, რომ სესია უმოქმედოა, არ ადასტურებს დავალების წარმატებით დასრულებას.

როგორ გამოითვლება მოხმარების საფასური?

მოდელისადმი მოთხოვნები არჩეული მოდელის API ტარიფებით ფასდება. OpenAI-ის ხელსაწყოებსა და OpenAI-ზე განთავსებულ იზოლირებულ გარემოებზე ვრცელდება ხელსაწყოებისა და კონტეინერების შესაბამისი ტარიფები.

მიმდინარე ტარიფები იხილეთ API-ის ფასების გვერდზე.

როგორ იმართება სესიის მონაცემები და ფაილები?

Agents API ინახავს სესიის მდგომარეობას, რათა მუშაობა მომდევნო სვლებშიც გაგრძელდეს. შეგიძლიათ წაშალოთ სესიები და გამოქვეყნებული არტეფაქტები, როცა ისინი აღარ დაგჭირდებათ. სესიის წაშლამდე შეინახეთ ყველა საჭირო ფაილი.

ამჟამად Agents API-ში მონაცემთა ადგილმდებარეობად მხოლოდ შეერთებული შტატებია მხარდაჭერილი. მასში მონაცემთა ნულოვანი შენარჩუნება მხარდაჭერილი არ არის, არც მაშინ, როცა საკუთარ ინფრასტრუქტურაზე განთავსებულ იზოლირებულ გარემოს იყენებთ. მონაცემთა კონტროლის დეტალები იხილეთ Agents API-ის დოკუმენტაციაში.