QuickAgent उपयोगकर्ता मार्गदर्शिका
QuickAgent एक स्थानीय-प्रथम AI एजेंट कार्यक्षेत्र है। यह लक्ष्य को एक स्थायी Run में बदलता है, उस Run को Workspace Profile के साथ सीमित करता है, संवेदनशील कार्रवाइयों से पहले समीक्षा माँगता है और सत्यापित परिणामों को Artifacts में रखता है।
आरंभ करें
- खोलें Settings > AI, एक प्रदाता जोड़ें और उसका कनेक्शन परीक्षण चलाएँ।
- खोलें Settings > Workspace Profiles। चुनें कि कौन-से प्रदाता, टूल, कनेक्शन, फ़ाइल रूट, Knowledge स्रोत और Memory स्कोप उपयोग किए जा सकते हैं।
- चुनें New Chat, प्रोफ़ाइल चुनें और बातचीत के ऊपर दिखाया गया प्रदाता गंतव्य पुष्टि करें।
- परिणाम का वर्णन करें। इस Run के लिए केवल आवश्यक फ़ाइलें, फ़ोल्डर, मीडिया, Knowledge या Memory जोड़ें।
- योजना, अनुमोदन, Critical पुष्टि और Data Send Preview दिखाई देने पर उनकी समीक्षा करें।
- Timeline में कार्य की प्रगति देखें। पूरा हुआ आउटपुट यहाँ से खोलें Artifacts और ऑडिट ट्रेल यहाँ देखें इतिहास.
इंटरफ़ेस अवलोकन
| अनुभाग | इसका उपयोग किस लिए है |
|---|---|
| Chats | वार्तालाप, प्रदाता गंतव्य, Context Tray, योजनाएँ, अनुमोदन और सक्रिय Run Timeline। |
| Runs | हर नियोजित, चल रहे, रुके हुए, निर्धारित, विफल या पूर्ण कार्य। |
| Approval Inbox | लंबित कार्रवाई, Critical और Data Send समीक्षाएँ जिन्हें आपके निर्णय की आवश्यकता है। |
| Artifacts | Runs द्वारा बनाई गई सत्यापित फ़ाइलें, रिपोर्ट, लॉग, मीडिया, तालिकाएँ और ऑपरेशन मैनिफ़ेस्ट। |
| Automations | शेड्यूल, मॉनिटर, वेबहुक, ऐप इवेंट और Shortcut/App Intent ट्रिगर। |
| Skills | टाइप किए गए इनपुट, अनुमत टूल, आवश्यक कनेक्शन, जोखिम और आउटपुट वाले पुन: उपयोग योग्य निर्देश। |
| Connections | प्रदाता, ब्राउज़र प्रोफ़ाइल, फ़ाइल/VFS रूट, SSH, MCP, HTTP/SaaS, होम ब्रिज और सूचना चैनल। |
| Knowledge | इंडेक्स किए गए फ़ोल्डर, QuickNote सामग्री, वेब क्लिप, PDFs और Office स्रोत। |
| इतिहास | केवल-परिशिष्ट सुरक्षा निर्णय, टूल कार्रवाइयाँ, गंतव्य और टाइमस्टैम्प। |
| सेटिंग्स | रूप-रंग, भाषा, AI, टूल, सुरक्षा, Workspace Profiles, शॉर्टकट, अनुमतियाँ, Help और Pro। |
प्रदाता और Workspace Profiles
जब ऑपरेटिंग सिस्टम संगत क्षमता उपलब्ध कराता है, तब QuickAgent System AI का उपयोग कर सकता है; साथ ही Ollama, LM Studio या DeskLLM जैसे स्थानीय प्रदाता, LAN या कस्टम OpenAI-संगत एंडपॉइंट और Anthropic या Gemini जैसे कॉन्फ़िगर किए गए क्लाउड प्रदाता भी उपयोग किए जा सकते हैं। उपलब्धता लाइव क्षमता परीक्षण से निर्धारित होती है; केवल प्रदाता का नाम होने का अर्थ यह नहीं कि वह तैयार है।
Workspace Profile Run का अनुमति-आवरण है। यह चयनित प्रदाता/मॉडल, अनुमत टूल, कनेक्शन, फ़ाइल रूट, Knowledge स्रोत, Memory स्कोप, सुरक्षा ओवरराइड और बजट का स्नैपशॉट लेता है। बाद में कॉन्फ़िगरेशन बदलने पर स्नैपशॉट पुराना हो जाता है और समीक्षा आवश्यक होती है।
Runs, अनुमोदन और पुनर्प्राप्ति
Run नियंत्रण
- रोकें स्थायी चेकपॉइंट पर सहयोगात्मक रूप से रोकने का अनुरोध करता है।
- फिर से शुरू करें उसी Run और पूर्ण हो चुके कार्य को जारी रखता है।
- Stop प्रदाता और टूल कार्य रद्द करता है। रोके गए या अनिश्चित बाहरी प्रभाव को सफलता के रूप में रिपोर्ट नहीं किया जाता।
- पुनः प्रयास करें केवल तब उपलब्ध है जब QuickAgent सुरक्षित पुनःप्रयास सीमा पहचान सके।
सुरक्षा स्तर
| स्तर | अर्थ |
|---|---|
| सुरक्षित | सक्रिय प्रोफ़ाइल के भीतर पढ़ें, निरीक्षण करें या रूपांतरित करें। |
| अनुमोदित करें | सामान्य लेखन या बाहरी कार्रवाई की समीक्षा करें। |
| पुष्टि करें | उच्च-प्रभाव या उलटने में अधिक कठिन परिवर्तन की समीक्षा करें। |
| Critical | हर बार सशक्त पुष्टि; नियम इसे कभी स्वतः अनुमोदित नहीं करते। |
अनुमोदन सटीक लक्ष्य, गंतव्य, प्रस्तावित आर्ग्युमेंट, जोखिम और Undo स्थिति दिखाता है। यदि आप कोई आर्ग्युमेंट संपादित करते हैं, तो QuickAgent संपादित कार्रवाई को फिर से सत्यापित और जोखिम-जाँचता है।
मल्टी-एजेंट Runs
जटिल लक्ष्य एक योजनाकार, टाइप किए गए विशेषज्ञ कार्यकर्ता, एक समीक्षक और एक सुरक्षा समीक्षक का उपयोग कर सकते हैं। Timeline प्रत्येक हैंडऑफ़, समीक्षा, पुनःप्रयास, फ़ॉलबैक और अंतिम-प्रतिक्रिया सीमा दिखाता है। कार्यकर्ताओं को केवल Skill टूल, Workspace Profile टूल, भूमिका टूल और वर्तमान में सक्रिय टूल के चार-तरफ़ा प्रतिच्छेदन तक पहुँच मिलती है।
वैश्विक और प्रति-भूमिका बजट आमंत्रणों, समय, लागत, नेटवर्क बाइट्स और टोकन सीमित करते हैं। बजट पूरा होने पर QuickAgent रुक जाता है। यह वर्तमान और प्रस्तावित सीमाएँ दिखाता है और स्पष्ट समीक्षा के बाद ही उन्हें बढ़ाता है। अनुमोदित बजट और पूर्ण भूमिका इतिहास पुनःआरंभ के बाद भी बने रहते हैं।
संदर्भ, Knowledge और AI Memory
Context Tray
फ़ाइलें, फ़ोल्डर, चित्र, वीडियो फ़्रेम, ऑडियो, वॉइस नोट, QuickNote सामग्री, Knowledge या Workspace Memory जोड़ें। QuickAgent समर्थित सामग्री निकालता या सारांशित करता है और दिखाता है कि कोई अनुलग्नक सीधे प्रदाता को भेजा जाएगा या नहीं।
Knowledge
Knowledge स्रोत चैट से अलग इंडेक्स किए जाते हैं। Run केवल अपने Workspace Profile द्वारा अनुमत स्रोत खोज सकता है और उद्धरण अपनी स्रोत पहचान बनाए रखते हैं।
Memory
Memory जानबूझकर रखी जाती है, स्वचालित चैट इतिहास नहीं है। User, Workspace, Project और Tool/Connection स्कोप अलग हैं। हर बनाने, संपादित करने या हटाने के अनुरोध के लिए नया अनुमोदन मिलता है और अनुमोदन पूर्वावलोकन स्कोप तथा सटीक प्रस्तावित मान दिखाता है।
टूल और कनेक्शन
लाइव कैटलॉग में फ़ाइल/VFS संचालन; Office, PDF और संरचित डेटा; मीडिया और OCR; ब्राउज़र तथा कंप्यूटर उपयोग; विकास कमांड; SSH; MCP; HTTP और SaaS; स्मार्ट-होम ब्रिज; सूचनाएँ; शेड्यूल; मॉनिटर; और स्वचालन नियंत्रण शामिल हैं। कनेक्टेड MCP सर्वर स्कीमा सत्यापन और QuickAgent जोखिम पुनर्मूल्यांकन के बाद गतिशील टूल जोड़ सकते हैं।
Settings > Tools दिखाता है कि कोई टूल तैयार या अक्षम क्यों है। सामान्य कारणों में अनुपस्थित कनेक्शन, ऑपरेटिंग-सिस्टम अनुमति, असमर्थित प्लेटफ़ॉर्म, Workspace Profile प्रतिबंध, अपरीक्षित एंडपॉइंट या अनुपलब्ध प्रदाता क्षमता शामिल हैं।
Automations
प्लेटफ़ॉर्म समर्थित होने पर स्वचालन समय, फ़ाइल/फ़ोल्डर, वेब, वेबहुक, ईमेल, कैलेंडर, नेटवर्क, होस्ट, डिवाइस, सेंसर, स्थान, ऐप इवेंट, Shortcut/App Intent, कमांड या मैन्युअल ट्रिगर से शुरू हो सकते हैं। एक ट्रिगर सामान्य Run बनाता है; वह Workspace Profile, अनुमोदन, Critical या Data Send जाँचों को बायपास नहीं करता।
- डेस्कटॉप मॉनिटरिंग केवल ऐप प्रक्रिया चलने तक जारी रहती है।
- मोबाइल प्लेटफ़ॉर्म ऐप के अग्रभूमि में लौटने पर विलंबित कार्य पुनर्प्राप्त करते हैं।
- जब ऑपरेटिंग-सिस्टम डिलीवरी आवश्यक हो तो Shortcut/App Intent या विश्वसनीय इवेंट रिले का उपयोग करें।
- कतारबद्ध इवेंट, रोकना, रद्द करना और हटाना स्पष्ट रहते हैं ताकि इवेंट चुपचाप त्यागे न जाएँ।
Skills और Skill Packs
Skill परिणाम-केंद्रित प्रॉम्प्ट, टाइप किए गए वेरिएबल, प्रदाता अनुशंसा, अनुमत टूल, आवश्यक कनेक्शन और क्षमताएँ, अधिकतम जोखिम तथा अपेक्षित Artifacts संग्रहीत करता है। उपयोग से पहले QuickAgent इनपुट और प्रभावी अनुमतियाँ दिखाता है; पूर्वावलोकन स्वयं अनुमति प्रदान नहीं करता।
सात अंतर्निर्मित Packs Office, Coding, Smart Home, Research, Browser Automation, Personal Admin और Incident Response के लिए वास्तविक Skills प्रदान करते हैं। आप Skills को इंस्टॉल, अपडेट, अनइंस्टॉल, अनुकूलित, डुप्लिकेट, आयात और निर्यात कर सकते हैं। आयातित JSON को विश्वास, प्रकाशक, हस्ताक्षर, अनुमति, जोखिम, प्लेटफ़ॉर्म और विरोधाभास का पूर्वावलोकन मिलता है। “Keep both” किसी अन्य प्रकाशक का विश्वास विरासत में लेने के बजाय एक अहस्ताक्षरित स्थानीय व्युत्पन्न बनाता है।
Artifacts, इतिहास और Undo
Artifacts आउटपुट बाइट्स, मेटाडेटा, संस्करण, उत्पत्ति, स्रोत Run और ऑपरेशन मैनिफ़ेस्ट रखते हैं। प्लेटफ़ॉर्म क्षमता के आधार पर आप उन्हें खोल, साझा, निर्यात या प्रकट कर सकते हैं। पात्र संचालन समीक्षा किया हुआ Undo दिखाते हैं; विनाशकारी या अनिश्चित कार्य कभी स्वचालित रूप से दोहराया नहीं जाता।
इतिहास केवल-परिशिष्ट है। इसे Safe, Approve, Confirm या Critical के अनुसार फ़िल्टर करें और बाहरी रिकॉर्ड की आवश्यकता होने पर ऑडिट निर्यात करें।
सेटिंग्स
- सामान्य: रूप-रंग, भाषा, Workspace Profiles, शॉर्टकट, Help और अनुमतियाँ।
- AI: प्रदाता, एंडपॉइंट, मॉडल, क्रेडेंशियल और लाइव परीक्षण।
- टूल: कैटलॉग की तैयारी, प्लेटफ़ॉर्म समर्थन और सेटअप कारण।
- सुरक्षा: अनुमोदन नियम, Data Send व्यवहार, डिवाइस प्रमाणीकरण और स्कोप वाली Memory नीति।
- उन्नत: समस्या-निवारण के लिए पुनर्प्राप्ति और निदान।
कीबोर्ड शॉर्टकट
macOS पर, ऐप प्रदर्शित Ctrl शॉर्टकट को जहाँ उचित हो वहाँ प्लेटफ़ॉर्म की Command कुंजी से मैप करता है। इन-ऐप Shortcuts पृष्ठ प्रामाणिक है और अनुकूलन का समर्थन करता है।
| शॉर्टकट | कार्रवाई |
|---|---|
| Ctrl + N | New Chat |
| Ctrl + L | कंपोज़र पर फ़ोकस करें |
| Ctrl + Shift + Space | सक्रिय Run को रोकें या फिर से शुरू करें |
| Ctrl + . | सक्रिय Run रोकें |
| Ctrl + 1 … 9 | History के माध्यम से Chats खोलें |
| Ctrl + , | Settings खोलें |
| F1 | Help & Privacy खोलें |
| Esc | कोई संवाद बंद करें या वर्तमान गैर-विनाशकारी इंटरैक्शन रद्द करें |
प्लेटफ़ॉर्म नोट्स
| प्लेटफ़ॉर्म | महत्वपूर्ण सीमाएँ |
|---|---|
| macOS | Debug और Release में सैंडबॉक्स किया गया। फ़ाइल पहुँच चयनित रूट/सुरक्षा-स्कोप्ड बुकमार्क का उपयोग करती है। Screen Recording और Accessibility अलग सिस्टम अनुमतियाँ हैं। स्थानीय प्रक्रिया और Shortcut एकीकरण क्षमता-परीक्षित रहते हैं। |
| Windows | फ़ाइल, Office/PDF/डेटा, ब्राउज़र, विकास, रिमोट और डेस्कटॉप-नियंत्रण सुविधाएँ इंस्टॉल किए गए रनटाइम और अनुमतियों पर निर्भर करती हैं। Apple-विशिष्ट एकीकरण स्पष्ट कारण के साथ अनुपलब्ध हैं। |
| iPhone / iPad | फ़ाइलें सिस्टम पिकर का उपयोग करती हैं। कैमरा, माइक्रोफ़ोन, वाणी, फ़ोटो, स्थानीय नेटवर्क और सूचनाएँ संदर्भ के अनुसार माँगी जाती हैं। पृष्ठभूमि मॉनिटरिंग की गारंटी नहीं है; Shortcuts/App Intents या अग्रभूमि कैच-अप का उपयोग करें। |
| Android | फ़ाइलें और फ़ोल्डर Storage Access Framework का उपयोग करते हैं। पृष्ठभूमि कार्य Android प्रतिबंधों का पालन करता है। केवल किसी सेवा के घोषित होने के कारण अभिगम्यता-आधारित इनपुट नियंत्रण को कभी स्वीकृत नहीं माना जाता। |
| वेब | मूल स्थायित्व की आवश्यकता वाली सुविधाओं के लिए केवल-सत्र भंडारण का उपयोग करता है और असमर्थित डिवाइस, फ़ाइल-रूट, स्थानीय-प्रक्रिया और पृष्ठभूमि क्षमताओं को स्पष्ट रूप से अक्षम करता है। |
सुझाव & तरकीबें
समस्या निवारण
| समस्या | क्या जाँचें |
|---|---|
| प्रदाता नहीं चला सकता | Settings > AI खोलें। कॉन्फ़िगरेशन, प्रमाणीकरण, मॉडल क्षमता, एंडपॉइंट पहुँच, टाइमआउट और रेट-लिमिट विवरण जाँचें, फिर कनेक्शन परीक्षण चलाएँ। |
| एक टूल अक्षम है | Settings > Tools खोलें और लाइव कारण पढ़ें। वर्तमान प्लेटफ़ॉर्म, अनुमति, कनेक्शन परीक्षण, Workspace Profile और चयनित रूट की समीक्षा करें। |
| एक Run अटका हुआ लगता है | Runs और Timeline खोलें। यह रुका हुआ हो सकता है, इनपुट, अनुमोदन, Critical पुष्टि, Data Send समीक्षा या बजट समीक्षा की प्रतीक्षा कर रहा हो सकता है। Stop उपलब्ध रहता है। |
| कोई अनुमति बदली | Help > Overview या Settings खोलें, फिर सिस्टम सेटिंग्स खोलें। लौटने के बाद प्रभावित कनेक्शन या टूल का पुनः परीक्षण करें। |
| कोई बाहरी कार्रवाई अनिश्चित है | लक्ष्य सिस्टम की जाँच करें। जब तक आप यह सत्यापित न कर लें कि पुनः प्रयास उचित है, Run को रोककर रखें या Stop करें। |
| कोई Automation पृष्ठभूमि में सक्रिय नहीं हुआ | मोबाइल ऑपरेटिंग सिस्टम मनमाने अंतराल पर पोलिंग की गारंटी नहीं देते। बाद की प्रक्रिया पूरी करने के लिए ऐप को अग्रभूमि में लौटाएँ या Shortcut/App Intent अथवा विश्वसनीय इवेंट स्रोत कॉन्फ़िगर करें। |
| कोई Artifact खुल या निर्यात नहीं हो पा रहा है | जाँचें कि उसके बाइट अभी उपलब्ध हैं या नहीं, प्लेटफ़ॉर्म उस कार्रवाई का समर्थन करता है या नहीं, और चुने गए गंतव्य की अनुमति अभी भी मान्य है या नहीं। |
गोपनीयता, अनुमतियाँ और लाइसेंस
QuickAgent वार्तालाप, Runs, अनुमोदन, Knowledge मेटाडेटा, Skills और सेटिंग्स को स्थानीय रूप से संग्रहीत करता है। क्रेडेंशियल प्लेटफ़ॉर्म-सुरक्षित स्टोरेज का उपयोग करते हैं। सामग्री केवल आपके कॉन्फ़िगर किए गए प्रदाता या कनेक्टेड सेवा के माध्यम से डिवाइस से बाहर जाती है, और बाहरी भेजने के लिए गंतव्य-सचेत पूर्वावलोकन मिलता है।
अनुमतियाँ संदर्भ के अनुसार माँगी जाती हैं: फ़ाइलें/फ़ोल्डर, फ़ोटो, कैमरा, माइक्रोफ़ोन, वाक् पहचान, स्थानीय नेटवर्क, सूचनाएँ, स्क्रीन रिकॉर्डिंग और एक्सेसिबिलिटी/इनपुट नियंत्रण स्वतंत्र हैं। अनुमति हटाने पर प्रभावित क्षमता अनुपलब्ध हो जाती है; गलत सफलता प्रदर्शित नहीं होती।
खोलें Settings > Help & Privacy वर्तमान प्लेटफ़ॉर्म क्षमता तालिका के लिए और ओपन-सोर्स लाइसेंस पैकेज और बंडल किए गए नेटिव नोटिस के लिए।