अच्छे Tools डिज़ाइन करना

Model आपके tool को मैनुअल की तरह पढ़ता है

Tool का नाम, description और parameter docs ही model की उसके बारे में एकमात्र जानकारी हैं। स्पष्ट नाम, हर tool का एक उद्देश्य, और ऐसे descriptions जो बताएँ कब उपयोग करें (और कब नहीं), चतुर कोड से ज़्यादा मायने रखते हैं। नतीजे संक्षिप्त लौटाएँ, सिर्फ़ ज़रूरी fields के साथ।

Agent के हाथ

Tools agent को कर्म करने देते हैं। अच्छा tool design और कड़ी permissions तय करते हैं कि वह कितना उपयोगी और कितना सुरक्षित है।

Tool की परिभाषा

विशिष्ट description और typed, documented parameter देखें। अच्छा error संदेश model को बताता है कि दोबारा कैसे कोशिश करें।

{
  "name": "get_order_status",
  "description": "Look up the status of one order by its numeric ID. Use for questions about shipping or delivery. Does not modify orders.",
  "input_schema": {
    "type": "object",
    "properties": {
      "order_id": { "type": "integer", "description": "The order ID, e.g. 10482" }
    },
    "required": ["order_id"]
  }
}

Errors भी निर्देश हैं

Stack trace की जगह "order_id 99999 नहीं मिला; user से नंबर जाँचने को कहें" लौटाएँ। Model error पढ़कर तय करता है कि आगे क्या करना है।

त्वरित जाँच: सही tool चुनने में model की सबसे ज़्यादा मदद क्या करता है?

• क्या करता है और कब उपयोग करें इसका छोटा, स्पष्ट description
• बहुत लंबा tool नाम
• छिपे हुए side effects
• विशाल outputs लौटाना