3 में से पाठ 1 · 10 मिनट

टूल कॉल करें

अपने फ़ंक्शन का विवरण दें, मॉडल जो कॉल माँगे उन्हें चलाएँ, और जवाब मिलने तक नतीजे वापस भेजते रहें।

tools में अपने फ़ंक्शन का विवरण दें, और मॉडल अनुमान लगाने के बजाय उनमें से किसी एक को कॉल करके जवाब देता है, जैसे डेटाबेस में कुछ ढूँढना। मॉडल खुद कभी कुछ नहीं चलाता: आपका ऐप फ़ंक्शन चलाता है और नतीजा वापस भेजता है, फिर मॉडल अंतिम जवाब लिखता है।

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "messages": [
      { "role": "user", "content": "What is the weather in London?" }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get current weather by city",
          "parameters": {
            "type": "object",
            "properties": {
              "city": { "type": "string" }
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

Chat Completions पर जवाब में finish_reason: "tool_calls" होता है और assistant संदेश पर एक tool_calls सूची होती है, जिसमें हर कॉल का id, फ़ंक्शन का name और JSON स्ट्रिंग के रूप में arguments होते हैं। हर कॉल चलाएँ, फिर एक अगला अनुरोध भेजें जिसमें बातचीत दोहराई जाए, assistant संदेश बिना बदलाव के हो, और हर कॉल के लिए tool_call_id से मिलाया गया एक role: "tool" संदेश हो। tools दोबारा भेजें। मॉडल या तो जवाब देता है या कोई और टूल कॉल करता है, और आप यही दोहराते हैं। /v1/responses पर कॉल एक function_call आइटम होता है और आपका नतीजा उसी call_id वाला function_call_output आइटम; /v1/messages पर ये tool_use और tool_result ब्लॉक होते हैं।

tool_choice तय करता है कि मॉडल टूल कॉल कर सकता है या नहीं: सिर्फ़ टेक्स्ट के लिए none, मॉडल को फ़ैसला करने देने के लिए auto (या इसे छोड़ दें), कॉल ज़रूरी करने के लिए required, या किसी एक टूल का नाम बताने वाला ऑब्जेक्ट। जब आपके टूल एक-एक करके चलने चाहिए, तो parallel_tool_calls को false सेट करें।

हर कॉल को अविश्वसनीय इनपुट मानें। टूल का नाम एक अनुमति सूची से मिलाएँ, अनजान नाम अस्वीकार करें, और कुछ भी चलाने से पहले पार्स किए गए arguments की जाँच करें। जाँच विफल हो, तो टूल न चलाएँ: टूल नतीजे के रूप में एक छोटी त्रुटि भेजें और मॉडल को दोबारा कोशिश करने दें। stream: true के साथ, पार्स करने से पहले हर argument delta इकट्ठा करें। जिन टूल का type phaseo: से शुरू होता है, जैसे phaseo:web_search या phaseo:datetime, वे Phaseo की ओर चलते हैं, इसलिए आपको executor लिखे बिना अंतिम जवाब मिल जाता है। ये सर्वर टूल बीटा में हैं।

अपनी समझ जाँचें

मॉडल {"id": "42"} के साथ delete_user का कॉल लौटाता है। आपका ऐप सिर्फ़ get_weather परिभाषित करता है। आपके कोड को क्या करना चाहिए?

इसे लागू करें

आपका सपोर्ट बॉट get_order कॉल करता है और फिर जवाब देता है। एक साथी का लूप अगले अनुरोध में सिर्फ़ role: "tool" संदेश भेजता है, और प्रदाता उसे अस्वीकार कर देता है। क्या छूट रहा है?

जवाब दिखाएँ

अगले अनुरोध में पहले बातचीत दोहराई जानी चाहिए, फिर अपने tool_calls के साथ बिना बदलाव का assistant संदेश, फिर हर कॉल के लिए मिलते tool_call_id वाला एक role: "tool" संदेश। tools भी दोबारा भेजें। जिस टूल नतीजे से पहले कोई कॉल नहीं, उसे मिलाने के लिए कुछ नहीं होता।

मुख्य बात

मॉडल माँगता है, आपका ऐप कॉल जाँचकर चलाता है, और मॉडल के अंतिम जवाब देने तक आप कॉल की ID के साथ नतीजा वापस भेजते हैं।

संबंधित लिंक

प्रगति इसी ब्राउज़र में सेव होती है।

आखिरी बार जाँचा गया 17 नवंबर 2026