इसे असली टूल्स दें
जोड़ सिर्फ़ डेमो था। इस सेक्शन में असली में उपयोगी टूल्स लगाएं: फ़ाइलें पढ़ना-लिखना, कमांड चलाना, वेबपेज खींचना। यह करने के बाद आपके पास myagent का पहला उपयोगी वर्शन होगा, और आप जानेंगे कि इसे गड़बड़ करने से कैसे रोकें।
पूरा कोड myagent.zip डाउनलोड करें, अनज़िप करके myagent डायरेक्टरी में जाएं। इस सेक्शन में agent.py का पहला आधा हिस्सा देखें।
टूल मात्र साधारण फ़ंक्शन है
def list_dir(path="."):
return "\n".join(sorted(p.name + ("/" if p.is_dir() else "") for p in Path(path).iterdir()))
def read_file(path):
return Path(path).read_text(encoding="utf-8")[:8000]
def fetch_url(url):
req = urllib.request.Request(url, headers={"User-Agent": "myagent/1.0"})
html = urllib.request.urlopen(req, timeout=20).read().decode("utf-8", "ignore")
text = re.sub(r"<script.*?</script>|<style.*?</style>|<[^>]+>", " ", html, flags=re.S)
return re.sub(r"\s+", " ", text)[:6000]ध्यान दें कि हर टूल का रिटर्न वैल्यू truncate कर दिया गया है (8000 अक्षर, 6000 अक्षर)। टूल का नतीजा वैसे ही बातचीत में डाला जाता है, एक बड़ी फ़ाइल मॉडल का कॉन्टेक्स्ट भर सकती है।
ख़तरनाक टूल्स, पहले पूछें
फ़ाइल लिखना और कमांड चलाना आपके कंप्यूटर को बदलता है। फ़ंक्शन में पहले एक बार पूछें:
def ask(question): # 危险操作先问人
return input(f"\n⚠️ {question} [y/N] ").strip().lower() == "y"
def run_shell(command):
if not ask(f"运行命令:{command}"):
return "用户拒绝了运行。"
r = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=60)
return (r.stdout + r.stderr)[-4000:] or f"(没有输出,退出码 {r.returncode})"मना करना भी कोई एरर नहीं है, बल्कि एक लाइन "उपयोगकर्ता ने चलाने से मना किया" मॉडल को वापस दी जाती है, ताकि वह कोई और तरीक़ा अपनाए या आपसे पूछे।
हमने सच में आज़माया, इससे कहा कि "worklog फ़ोल्डर हटा दो", और पुष्टि के समय n टाइप किया:
[1] list_dir({"path": "./worklog"})
[2] run_shell({"command": "rm -rf ./worklog"})
⚠️ कमांड चलाएं: rm -rf ./worklog [y/N] n
Agent: क्या आप वाक़ई worklog फ़ोल्डर हटाना चाहते हैं? यह काम फ़ाइलें हमेशा के लिए हटा देगा और वापस नहीं लाई जा सकेंगी। सलाह है कि पहले फ़ाइलों का बैकअप लें…फ़ोल्डर अब भी मौजूद है। इसीलिए पिछले सेक्शन में कहा गया था कि "मॉडल सिर्फ़ अनुरोध करता है, चलाने की ताक़त आपके हाथ में है": परमिशन कंट्रोल यहीं लिखा जाता है।
मॉडल को बताएं कि कौन-कौन से टूल्स हैं
हर टूल के साथ एक विवरण दें। टूल बढ़ने पर हाथ से JSON Schema लिखना बहुत लंबा हो जाता है, एक छोटा फ़ंक्शन लिखें जो जनरेट करे:
def spec(tool_name, desc, **params):
return {"type": "function", "function": {"name": tool_name, "description": desc, "parameters": {
"type": "object", "properties": {k: {"type": "string", "description": v} for k, v in params.items()},
"required": list(params)}}}
TOOLS = [
spec("list_dir", "列出目录里的文件", path="目录路径"),
spec("read_file", "读取一个文本文件的内容", path="文件路径"),
spec("write_file", "写入文本文件(会先请用户确认)", path="文件路径", content="完整内容"),
spec("run_shell", "在终端运行一条命令(会先请用户确认)", command="要运行的命令"),
spec("fetch_url", "抓取网页并返回纯文本", url="网址"),
]हमारे लिखे पहले वर्शन में इस फ़ंक्शन का पहला पैरामीटर name नाम था, नतीजा spec("load_skill", ..., name="技能名") सीधे एरर देता था got multiple values for argument 'name': टूल के अपने पैरामीटर का नाम भी name था। इसलिए इसे बदलकर tool_name कर दिया।
एक बार चलाएं
python agent.py "看看 worklog 文件夹里有哪些文件"आपको यह दिखना चाहिए:
[1] list_dir({"path": "worklog"})
Agent: worklog फ़ोल्डर में ये फ़ाइलें हैं:
- 11-16.txt
- 11-18.txt
- 11-20.txtमॉडल ग़लतियाँ करता है, इसलिए एरर वापस देना ज़रूरी है
कोर्स के होमपेज वाली असली रन में, मॉडल ने पहली बार फ़ाइल पढ़ते समय /worklog/11-16.txt लिखा (शुरू में एक अतिरिक्त स्लैश), और यह मिला:
出错了:FileNotFoundError: [Errno 2] No such file or directory: '/worklog/11-16.txt'क्योंकि हमने एरर वैसे ही वापस दिया, उसका अगला क़दम list_dir से देखना था, फिर ./worklog/11-16.txt से सही पढ़ा। अगर प्रोग्राम यहीं क्रैश हो जाता, तो पूरा टास्क फ़ेल हो जाता।
Anthropic ने "Building effective agents" में उल्लेख किया कि वे प्रॉम्प्ट्स को निखारने से ज़्यादा समय टूल्स को निखारने में लगाते हैं, जैसे टूल को बदलकर निरपेक्ष पथ (absolute path) अनिवार्य कर देना। टूल के विवरण और लौटाई गई जानकारी जितनी स्पष्ट होगी, मॉडल उतनी ही कम गलतियाँ करेगा।
खोजेंटूल डिज़ाइन करते समय……
एक पर क्लिक करके देखें।
आपकी परीक्षायूज़र ने पुष्टि करते समय rm -rf मना कर दिया, प्रोग्राम को क्या करना चाहिए?
इसकी जाँच करें
- मैंने
list_dirसफलतापूर्वक चलाया, फ़ाइल सूची देखी - मैंने एक बार
run_shellको अस्वीकार करने की कोशिश की, फ़ाइल सुरक्षित रही - मैं टूल डिज़ाइन करने के चार मुख्य बिंदु बता सकता हूँ
अगला भाग: मेमोरी: इसे संदर्भ याद रखने दें।