అవలోకనం

ఏజెంట్స్ ఏపీఐ బీటా రూపంలో అందుబాటులో ఉంది. OpenAI నిర్వహించే Codex ఏజెంట్‌తో అప్లికేషన్‌లను రూపొందించడానికి ఇది డెవలపర్‌లకు వీలు కల్పిస్తుంది. ఈ ఏజెంట్ అనేక దశల్లో పని చేస్తూ, అదే సెషన్‌లో కొనసాగగలదు.

మీ అప్లికేషన్ పని, సాధనాలు, ఆకృతీకరణను అందిస్తుంది. ఏజెంట్ సెషన్‌ను, దాని మోడల్‌కు సాధనాలకు మధ్య సమన్వయాన్ని OpenAI నిర్వహిస్తుంది.

ఏజెంట్ ఏం చేయగలదు?

తనకు అందుబాటులో ఉన్న సాధనాలు, అమలు వాతావరణాన్ని బట్టి ఏజెంట్ కోడ్‌ను అమలు చేయగలదు, ఫైళ్లను సవరించగలదు, ఎంసీపీ కనెక్షన్‌లను ఉపయోగించగలదు, మీ అప్లికేషన్ కోసం ఫైళ్లను సృష్టించగలదు. మీరు అదనపు సూచనలు పంపవచ్చు లేదా అదే సెషన్‌లో మరో పనిని కొనసాగించవచ్చు.

అందుబాటులో ఉన్న సామర్థ్యాలు, ఉదాహరణల కోసం ఏజెంట్స్ ఏపీఐ అవలోకనాన్ని చూడండి.

నేను ఎలా ప్రారంభించాలి?

1. OpenAI ప్లాట్‌ఫారమ్‌లోని మీ ప్రాజెక్ట్‌లో అప్లికేషన్ ఏపీఐ కీని సృష్టించండి. సెషన్‌ల కోసం api.agents.read, api.agents.write అనుమతులతో పాటు, మోడల్ అభ్యర్థనల కోసం api.responses.write అనుమతిని ఇవ్వండి.

2. ఏజెంట్‌ను ఆకృతీకరించడానికి, సెషన్‌ను సృష్టించడానికి, పనిని అప్పగించడానికి త్వరిత ప్రారంభ మార్గదర్శినిని అనుసరించండి.

3. పురోగతిని, ఫలితాలను సమీక్షించడానికి సెషన్ ఈవెంట్‌లను గమనించండి. మీరు పనిని కొనసాగించాలనుకుంటే సెషన్ ఐడీని భద్రపరచుకోండి.

మీ ఏపీఐ కీని ఏజెంట్ శాండ్‌బాక్స్ వెలుపల ఉంచండి. అభ్యర్థనలకు OpenAI-Beta: agents=v1 హెడర్ అవసరం. OpenAI ఎస్‌డీకేలు ఈ హెడర్‌ను స్వయంచాలకంగా జోడిస్తాయి.

నా ఏజెంట్‌కు శాండ్‌బాక్స్ అవసరమా?

పనికి తగిన వాతావరణాన్ని ఎంచుకోండి:

• వాతావరణం లేకుండా: అంతర్నిర్మిత షెల్ ఆదేశాలు లేదా వర్క్‌స్పేస్ ఫైళ్ల అవసరం లేకుండానే ఏజెంట్ ప్రశ్నలకు సమాధానమిస్తుంది లేదా బాహ్య సాధనాలను ఉపయోగిస్తుంది.

• OpenAI హోస్ట్ చేసే శాండ్‌బాక్స్: ఏజెంట్ స్క్రిప్ట్‌లను అమలు చేయాలి లేదా ఫైళ్లతో పని చేయాలి, దాని శాండ్‌బాక్స్‌ను OpenAI నిర్వహించాలని మీరు కోరుకుంటున్నారు.

• స్వయంగా హోస్ట్ చేసే శాండ్‌బాక్స్: మీకు మీ సొంత మౌలిక వసతులు, సాఫ్ట్‌వేర్ లేదా ప్రైవేట్ నెట్‌వర్క్ అవసరం. వాతావరణం సృష్టి నుంచి తొలగింపు వరకు అన్ని దశలను మీ అప్లికేషన్ నిర్వహిస్తుంది.

ఆకృతీకరణ వివరాల కోసం ఏజెంట్స్ ఏపీఐ నిర్మాణాన్ని చూడండి.

నేను సెషన్‌ను ఎక్కడ సమీక్షించవచ్చు?

ప్లాట్‌ఫారమ్ డ్యాష్‌బోర్డ్‌లోని లాగ్‌లను తెరిచి, ఏజెంట్‌లు ఎంచుకుని, సెషన్ ఐడీ కోసం వెతకండి. మీరు సంభాషణ విడతలు, సాధనాల కాల్‌లు, ఉపఏజెంట్‌ల కార్యకలాపాలను పరిశీలించవచ్చు.

నమోదైన టోకెన్ వినియోగాన్ని ఎలా సమీక్షించాలో కూడా పర్యవేక్షణ మార్గదర్శిని వివరిస్తుంది.

ఈవెంట్‌ల ప్రవాహానికి కనెక్షన్ తెగిపోతే ఏం చేయాలి?

మళ్లీ ప్రయత్నించే ముందు ప్రస్తుత సెషన్‌ను, అందులో భద్రపరిచిన అంశాలను పొందండి. మరింత పని అప్పగించే ముందు ఏం జరిగిందో తెలుసుకోవడానికి ఇది సహాయపడుతుంది.

ఒక సంభాషణ విడత పూర్తయినంత మాత్రాన ప్రతి సాధనం విజయవంతంగా పనిచేసిందని కాదు. నివేదించిన ఫలితాన్ని సమీక్షించండి. సెషన్‌లో కార్యకలాపాలేవీ లేనంత మాత్రాన పని విజయవంతంగా పూర్తయిందని నిర్ధారించలేము.

వినియోగానికి రుసుములు ఎలా లెక్కిస్తారు?

మోడల్ అభ్యర్థనలకు ఎంచుకున్న మోడల్ ఏపీఐ ధరలు వర్తిస్తాయి. OpenAI సాధనాలకు, OpenAI హోస్ట్ చేసే శాండ్‌బాక్స్‌లకు ఆయా సాధనాలు, కంటెయినర్‌ల ధరలు వర్తిస్తాయి.

ప్రస్తుత ధరల కోసం ఏపీఐ ధరలను చూడండి.

సెషన్ డేటాను, ఫైళ్లను ఎలా నిర్వహిస్తారు?

సంభాషణ విడతల మధ్య పని కొనసాగించగలిగేలా ఏజెంట్స్ ఏపీఐ సెషన్ స్థితిని భద్రపరుస్తుంది. ఇక అవసరం లేనప్పుడు సెషన్‌లను, ప్రచురించిన సృష్టి ఫలితాలను తొలగించవచ్చు. సెషన్‌ను తొలగించే ముందు మీకు అవసరమైన ఫైళ్లను భద్రపరచుకోండి.

ఏజెంట్స్ ఏపీఐ ప్రస్తుతం అమెరికా సంయుక్త రాష్ట్రాల్లో మాత్రమే డేటా రెసిడెన్సీకి మద్దతు ఇస్తుంది. మీరు స్వయంగా హోస్ట్ చేసే శాండ్‌బాక్స్‌ను ఉపయోగించినా, ఇది జీరో డేటా రిటెన్షన్‌కు మద్దతు ఇవ్వదు. డేటా నియంత్రణ వివరాల కోసం ఏజెంట్స్ ఏపీఐ పత్రాలను చూడండి.