OpenAI
ఈ పేజీ మెషిన్ ట్రాన్స్‌లేషన్‌తో అనువదించబడింది. అసలు ఇంగ్లీష్ ఆర్టికల్‌ను చూడండి.

OpenAI APIలో ఫంక్షన్ కాలింగ్

ఫంక్షన్ కాలింగ్ అంటే ఏమిటి, మరియు అది OpenAI APIలో ఎలా పనిచేస్తుంది?

అప్డేట్ చేయబడిన: 8 days ago

మార్చి 11, 2025 నాటికి, మా కొత్త ఏజెంట్స్ ప్లాట్‌ఫారమ్ యొక్క ప్రాథమిక భాగాలను విడుదల చేశాము. వివరాల కోసం, మా Responses API, Web Search, File Search, మరియు Computer Use వంటి Tools, అలాగే Agents SDK with Tracing కోసం మా API డాక్స్ చూడండి.

ఫంక్షన్ కాలింగ్ OpenAI మోడల్‌లను బాహ్య టూల్స్ మరియు సిస్టమ్‌లకు కనెక్ట్ చేయడానికి మిమ్మల్ని అనుమతిస్తుంది. AI అసిస్టెంట్‌లకు సామర్థ్యాలు కల్పించడం, లేదా మీ అప్లికేషన్‌లు మరియు LLMల మధ్య లోతైన ఇంటిగ్రేషన్‌లను నిర్మించడం వంటి అనేక విషయాలకు ఇది ఉపయోగకరం.

మా ఫంక్షన్ కాలింగ్ డెవలపర్ గైడ్లో మరింత తెలుసుకోండి.

జూన్ 2024లో, మేము స్ట్రక్చర్డ్ అవుట్‌పుట్స్‌ను ప్రారంభించాము. మీ ఫంక్షన్ నిర్వచనంలో strict: trueగా సెట్ చేసి దాన్ని ఆన్ చేసినప్పుడు, ఫంక్షన్ కాల్ కోసం మోడల్ జనరేట్ చేసిన ఆర్గ్యుమెంట్‌లు మీరు ఫంక్షన్ నిర్వచనంలో అందించిన JSON స్కీమాతో ఖచ్చితంగా సరిపోతాయని స్ట్రక్చర్డ్ అవుట్‌పుట్స్ హామీ ఇస్తుంది.

అక్టోబర్ 2024లో, మేము ‘ఏదైనా జనరేట్ చేయండి’ ఫీచర్‌ను ప్రారంభించాము; ఇది డెవలపర్‌లు ఒక ఫంక్షన్‌ను వివరించడానికి, దాన్ని నేరుగా పేస్ట్ చేయడానికి లేదా మీ కోడ్‌ను పేస్ట్ చేసి చెల్లుబాటు అయ్యే ఫంక్షన్ స్కీమాను జనరేట్ చేయడానికి అనుమతిస్తుంది. ‘ఏదైనా జనరేట్ చేయండి’ గురించి ఇక్కడ ఉన్న సహాయ కేంద్ర కథనంలో మరింత తెలుసుకోండి.

నేను ఫంక్షన్ కాలింగ్‌ను ఎలా ఉపయోగించగలను?

ఫంక్షన్ కాలింగ్ అనేక ఉపయోగ సందర్భాలకు ఉపయోగపడుతుంది, ఉదాహరణకు:

  • డేటాను తెచ్చుకునేలా అసిస్టెంట్‌లను ఎనేబుల్ చేయడం:

  • చర్యలు తీసుకునేలా అసిస్టెంట్‌లను ఎనేబుల్ చేయడం:

  • గణన చేయగలిగేలా అసిస్టెంట్‌లను ఎనేబుల్ చేయడం:

  • సమృద్ధమైన వర్క్‌ఫ్లోలను నిర్మించడం:

  • ముడి టెక్స్ట్‌ను తెచ్చుకుని, తరువాత దానిని స్ట్రక్చర్డ్ డేటాగా మార్చి డేటాబేస్‌లో సేవ్ చేసే డేటా ఎక్స్‌ట్రాక్షన్ పైప్‌లైన్.

ఫంక్షన్ కాలింగ్‌కు Responses APIలో మద్దతు ఉంది; ఇది ఇంతకు ముందు చాట్ కంప్లీషన్స్ API మరియు Assistants API మధ్య విభజించబడిన సామర్థ్యాలను ఏకీకృతం చేస్తుంది.

నేను JSON మోడ్‌ను ఎలా ఉపయోగించగలను?

JSON మోడ్ ఆన్‌లో ఉన్నప్పుడు, మీరు గుర్తించి తగిన విధంగా నిర్వహించాల్సిన కొన్ని ఎడ్జ్ కేసులు మినహా, మోడల్ అవుట్‌పుట్ చెల్లుబాటు అయ్యే JSON అవుతుందని నిర్ధారించబడుతుంది.

చాట్ కంప్లీషన్స్ APIతో JSON మోడ్‌ను అభ్యర్థించడానికి, మద్దతు ఉన్న మోడల్‌లలో response_formatను { "type": "json_object" }గా సెట్ చేయండి. Responses APIతో, వర్తించే చోట text.formatను { "type": "json_object" }గా సెట్ చేయండి, ఉదాహరణకు text: { "format": { "type": "json_object" } }. ఏ APIలో అయినా, మోడల్/సందేశం/టూల్‌కు సంబంధించిన ముందస్తు అవసరాలు నెరవేరినప్పుడు మాత్రమే JSON మోడ్ పనిచేస్తుంది (ఉదాహరణకు, మోడల్ json_objectకు మద్దతు ఇస్తుంది, సంభాషణలో JSON ఉత్పత్తి చేయడానికి సూచనలు ఉంటాయి, మరియు ఏవైనా టూల్ పరిమితులు అనుకూలంగా ఉంటాయి). ఎఫెక్టివ్ ఇన్‌పుట్ కాంటెక్స్ట్‌లో కనీసం ఒక అభ్యర్థన సందేశం లేదా ఇన్‌పుట్ సందేశం తప్పనిసరిగా కేస్-ఇన్‌సెన్సిటివ్ రూపంలో jsonను కలిగి ఉండాలి, ఉదాహరణకు JSON, json, లేదా Json; లేకపోతే, API లోపాన్ని తిరిగి ఇస్తుంది. Responsesలో, అగ్ర-స్థాయి సూచనల ఫీల్డ్ ఒక్కటే ఈ వాలిడేషన్‌ను సంతృప్తి పరచదు. అనుకూల మోడల్‌లు/పాత్‌లలో ఫంక్షన్ కాలింగ్ ఉపయోగించినప్పుడు, ఫంక్షన్-కాల్ ఆర్గ్యుమెంట్‌లకు JSON పరిమితులు ఆటోమేటిక్‌గా వర్తించబడతాయి; అననుకూల మోడల్‌లు లేదా టూల్/రెస్పాన్స్-ఫార్మాట్ కలయికలు తిరస్కరించబడవచ్చు లేదా JSON-పరిమితి ఉన్న శాంప్లింగ్‌ను ఉపయోగించకపోవచ్చు.

ముఖ్యమైన గమనికలు:

  • JSON మోడ్‌ను ఉపయోగిస్తున్నప్పుడు, సంభాషణలోని ఏదో ఒక సందేశం ద్వారా, ఉదాహరణకు మీ సిస్టమ్ సందేశం ద్వారా, JSON ఉత్పత్తి చేయమని మీరు ఎల్లప్పుడూ మోడల్‌కు సూచించాలి. JSON జనరేట్ చేయడానికి మీరు స్పష్టమైన సూచనను చేర్చకపోతే, మోడల్ ముగియని ఖాళీ స్థలాల స్ట్రీమ్‌ను జనరేట్ చేయవచ్చు మరియు అభ్యర్థన టోకెన్ పరిమితిని చేరేవరకు నిరంతరం నడుస్తూ ఉండవచ్చు. మీరు మర్చిపోకుండా ఉండటానికి, సంబంధిత ఇన్‌పుట్ సందేశాలు లేదా సూచనలు కేస్-ఇన్‌సెన్సిటివ్‌గా ఏదో ఒక రూపంలో json పదాన్ని కలిగి లేకపోతే JSON మోడ్ అభ్యర్థనలను తిరస్కరిస్తుంది.

  • JSON మోడ్ అవుట్‌పుట్ ఏదైనా నిర్దిష్ట స్కీమాతో సరిపోతుందని హామీ ఇవ్వదు; అది చెల్లుబాటు అయ్యేదిగా ఉండి లోపాలు లేకుండా పార్స్ అవుతుందని మాత్రమే హామీ ఇస్తుంది. అది మీ స్కీమాతో సరిపోతుందని నిర్ధారించడానికి మీరు స్ట్రక్చర్డ్ అవుట్‌పుట్స్‌ను ఉపయోగించాలి, లేదా అది సాధ్యం కాకపోతే, అవుట్‌పుట్ మీకు కావలసిన స్కీమాతో సరిపోతుందని నిర్ధారించడానికి మీరు వాలిడేషన్ లైబ్రరీని మరియు అవసరమైతే మళ్లీ ప్రయత్నాలను ఉపయోగించాలి.

  • మోడల్ అవుట్‌పుట్ పూర్తిస్థాయి JSON ఆబ్జెక్ట్ కాకపోవడానికి దారితీసే ఎడ్జ్ కేసులను మీ అప్లికేషన్ గుర్తించి నిర్వహించాలి (కింద చూడండి).

ఈ వ్యాసం ఉపయోగకరంగా ఉందా?