వినియోగ గైడ్

ప్రారంభించడానికి మీకు API కీ అవసరం లేదు: హోస్ట్ చేయబడిన మోడల్ ఇప్పటికే చేర్చబడింది, మరియు ఉచిత-స్థాయి ఏజెంట్లు ప్లాట్‌ఫారమ్ యొక్క షేర్డ్ పూల్‌లో ఆటోమేటిక్‌గా రన్ అవుతాయి. మీ ప్లాన్ మీ స్వంత ప్రొవైడర్‌ను అనుమతిస్తే, కనెక్ట్ → ప్రొవైడర్లుకు వెళ్లి, ఆంత్రోపిక్, OpenAI, లేదా మరొక మద్దతు ఉన్న ప్రొవైడర్‌ను ఎంచుకుని, ఆ ప్రొవైడర్ డాష్‌బోర్డ్ నుండి మీ స్వంత API కీని పేస్ట్ చేయండి. కీ సేవ్ చేయడానికి ముందు నిజమైన (బిల్ చేయని) కాల్‌తో ధృవీకరించబడుతుంది మరియు నిల్వలో ఎన్‌క్రిప్ట్ చేయబడుతుంది - అది ACTIVE అని చూపించిన తర్వాత, మీ ఏజెంట్లు హోస్ట్ చేసిన పూల్‌కు బదులుగా దానిని ఉపయోగిస్తాయి.

ఆ తర్వాత, సహజమైన నిర్మాణ క్రమం: ఒక ఏజెంట్‌ను సృష్టించండి (నిర్మించండి → ఏజెంట్లు), దానిని ప్లేగ్రౌండ్‌లో ప్రైవేట్‌గా ప్రయత్నించండి (పరీక్షించండి → ప్లేగ్రౌండ్), ఆపై దానిని ఒక వర్క్‌ఫ్లోలోకి చేర్చండి, లేదా నేరుగా ఒక ఛానెల్‌కు (వాట్సాప్, టెలిగ్రామ్, ఇమెయిల్) కనెక్ట్ చేయండి.

సిస్టమ్ ప్రాంప్ట్ లేదా వివరణను అడిగే ఏదైనా ఫీల్డ్ పక్కన ఒక చిన్న ✨ AIని అడగండి బటన్ ఉంటుంది. దానిపై క్లిక్ చేసి, మీకు ఏమి కావాలో ఒక వాక్యంలో వివరించండి (ఉదా. "రీఫండ్‌లు మరియు ఆర్డర్ స్థితిని నిర్వహించే ఒక సపోర్ట్ ఏజెంట్"), మరియు అది టెక్స్ట్‌ను డ్రాఫ్ట్ చేస్తుంది. ఏదీ ఆటోమేటిక్‌గా వర్తించదు - మీరు ఎల్లప్పుడూ సూచనను సమీక్షించి, దీన్ని ఉపయోగించండి క్లిక్ చేయాలి, లేదా పునరుత్పత్తి చేయండి క్లిక్ చేయాలి.

ఏజెంట్ అంటే ఒక AI వ్యక్తిత్వం: ఒక సిస్టమ్ ప్రాంప్ట్, ఒక LLM ప్రొవైడర్/మోడల్, మరియు ఐచ్ఛికంగా ఒక నాలెడ్జ్ బేస్ మరియు పరిమిత సాధనాల సెట్. ఒక సహేతుకమైన సిస్టమ్ ప్రాంప్ట్‌ను ముందుగా పూరించడానికి టెంప్లేట్ (సపోర్ట్ ట్రయేజ్, రీసెర్చ్ అసిస్టెంట్, మొదలైనవి) నుండి ప్రారంభించండి, లేదా మొదటి నుండి ప్రారంభించి, ఒకదాన్ని డ్రాఫ్ట్ చేయడానికి Ask AIని ఉపయోగించండి.

టూల్ యాక్సెస్ మరియు నాలెడ్జ్ యాక్సెస్ రెండూ అనుమతి జాబితాలు: "అపరిమితం" కోసం వాటిని ఖాళీగా వదిలేయండి (ఏజెంట్ మీ టెనెంట్‌లో అందుబాటులో ఉన్న దేనినైనా ఉపయోగించగలదు), లేదా ఏజెంట్‌ను కేవలం వాటికి మాత్రమే పరిమితం చేయడానికి నిర్దిష్ట అంశాలను చెక్ చేయండి. కస్టమర్‌కు కనిపించే దేనికైనా ఇది ముఖ్యం - సాధారణంగా పబ్లిక్ సపోర్ట్ బాట్ ప్రతి అంతర్గత సాధనానికి యాక్సెస్ కలిగి ఉండకూడదు.

.md, PDF, Word, చిత్రాలు (OCR), లేదా ఆడియో/వీడియో (లిప్యంతరీకరించిన) ఫైల్‌లను అప్‌లోడ్ చేయండి మరియు అవి శోధించదగిన వెక్టర్ స్టోర్‌లో చంక్ చేయబడి, పొందుపరచబడతాయి. కలెక్షన్‌లు అనేవి మీరు ఏజెంట్‌లను నెస్ట్ చేసి, స్కోప్ చేయగల ఫోల్డర్‌లు - ఉదా. ఒక "రిటర్న్స్ పాలసీ" కలెక్షన్‌ను కేవలం కొన్ని ఏజెంట్లు మాత్రమే శోధించగలవు, అయితే "పబ్లిక్ FAQ" కలెక్షన్‌ను ప్రతి ఏజెంట్ ఉపయోగించగలదు.

ఏజెంట్‌ను సృష్టించేటప్పుడు "నాలెడ్జ్ బేస్‌ను అటాచ్ చేయండి" అని చెక్ చేస్తేనే (లేదా ఏజెంట్ల పేజీ నుండి తర్వాత టోగుల్ చేస్తేనే) అది దాని నాలెడ్జ్ బేస్‌ను శోధిస్తుంది, మరియు దాని నాలెడ్జ్-యాక్సెస్ అనుమతి జాబితా అనుమతించే కలెక్షన్‌లలో మాత్రమే శోధిస్తుంది.

బహుళ-దశల ఆటోమేషన్ కోసం విజువల్ కాన్వాస్: నోడ్‌లను (ట్రిగ్గర్, ఏజెంట్, నాలెడ్జ్ సెర్చ్, కండిషన్, అవుట్‌పుట్, డివైస్ కంట్రోల్, మరియు మరిన్ని) లాగి, వాటిని కనెక్ట్ చేయండి. ప్రతి నోడ్ దాని వెనుక ఉన్న నిజమైన సేవను పిలుస్తుంది - ఒక వర్క్‌ఫ్లో రన్ నిజంగా మీ ఏజెంట్‌ను పిలుస్తుంది, నిజంగా మీ నాలెడ్జ్ బేస్‌ను శోధిస్తుంది, నిజంగా WhatsApp సందేశాన్ని పంపుతుంది.

వర్క్‌ఫ్లోలు మూడు విధాలుగా ప్రారంభం కావచ్చు: మాన్యువల్‌గా ("రన్" బటన్), ఒక షెడ్యూల్ ప్రకారం (క్రాన్ ఎక్స్‌ప్రెషన్, ఉదా. "ప్రతి ఉదయం 8 గంటలకు"), లేదా మీరు ఏదైనా బాహ్య సిస్టమ్ నుండి కాల్ చేయగల వెబ్‌హుక్ URL ద్వారా. ప్రతి రన్ ఆ వర్క్‌ఫ్లో యొక్క రన్స్ ట్యాబ్ కింద దశలవారీగా లాగ్ చేయబడుతుంది, ఇందులో ఏజెంట్ నోడ్ చేసిన ప్రతి ఒక్క టూల్ కాల్ కూడా ఉంటుంది.

మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్ సర్వర్‌లు మరియు అంతర్నిర్మిత సాధనాల మార్కెట్‌ప్లేస్, వీటిని ఏజెంట్ సంభాషణ మధ్యలో కాల్ చేయగలదు (వెబ్ శోధన, డేటాబేస్, ఫైల్‌సిస్టమ్, మీ స్వంత కస్టమ్ స్క్రిప్ట్‌లు...). మీకు అందుబాటులో ఉండాలనుకునే వాటిని ఎనేబుల్ చేయండి, ఆపై ప్రతి ఏజెంట్ యొక్క టూల్-యాక్సెస్ ఎడిటర్ నుండి ఏ ఏజెంట్లు వాటిని వాస్తవంగా ఉపయోగించవచ్చో స్కోప్ చేయండి. ఇక్కడ ఒక సర్వర్‌ను డిసేబుల్ చేయడం వలన అది ప్రతి ఏజెంట్ అందుబాటులో ఉన్న సాధనాల నుండి వెంటనే తీసివేయబడుతుంది, గతంలో చెక్ చేసిన వాటి నుండి కూడా.

అడ్మిన్ → ఛానెల్‌లు కింద: WhatsAppను Twilio ద్వారా (వేగవంతమైన శాండ్‌బాక్స్ సెటప్, ప్రతి సందేశానికి చిన్న రుసుము) లేదా నేరుగా Meta యొక్క WhatsApp బిజినెస్ ప్లాట్‌ఫారమ్ ద్వారా (మధ్యవర్తి రుసుము లేదు, ఎక్కువ సెటప్ - మీ స్వంత Meta యాప్, సిస్టమ్ యూజర్ టోకెన్, మరియు యాప్ సీక్రెట్) కనెక్ట్ చేయండి. రెండూ కాన్ఫిగర్ చేయబడితే, ప్రత్యక్ష Meta కనెక్షన్ స్వయంచాలకంగా ఉపయోగించబడుతుంది.

ఒక కొత్త ఫోన్ నంబర్ మొదటిసారి సందేశం పంపినప్పుడు, అది పెండింగ్ పంపినవారి జత కింద కనిపిస్తుంది మరియు మీ ఏజెంట్లు దానితో ప్రత్యక్ష సంభాషణ జరపడానికి ముందు ఆమోదించబడాలి - ఇది మీ నంబర్‌కు సందేశం పంపే అపరిచితుడు డిఫాల్ట్‌గా పర్యవేక్షణ లేని AI సంభాషణను పొందకుండా ఆపుతుంది.

పరికరాల పేజీ నుండి మీ టెనెంట్‌కు ఒక ఫోన్‌ను (Android లేదా iOS) జత చేయండి, మరియు ఒక వర్క్‌ఫ్లో యొక్క డివైస్ కంట్రోల్ నోడ్ దానిపై ట్యాప్ చేయగలదు, టైప్ చేయగలదు, యాప్‌లను తెరవగలదు, లేదా స్క్రీన్‌షాట్ తీయగలదు. Android దాని యాక్సెసిబిలిటీ సర్వీస్ ద్వారా పూర్తి ఆటోమేషన్‌కు మద్దతు ఇస్తుంది; iOS ఆపిల్ యొక్క శాండ్‌బాక్సింగ్ ద్వారా కేవలం యాప్‌లను తెరవడానికి మాత్రమే పరిమితం చేయబడింది - ప్రతి ప్లాట్‌ఫారమ్ ఏమి చేయగలదో మరియు చేయలేదో పూర్తి, నిజాయితీగల విశ్లేషణ కోసం మొబైల్ SDK యొక్క CONSTRAINTS.md చూడండి.

వినియోగదారులు: సహచరులను ఆహ్వానించి, పాత్రలను కేటాయించండి (టెనెంట్-అడ్మిన్ మాత్రమే పాత్రలు లేదా ఆధారాలను మార్చగలరు). ఆమోదాలు అనేది హ్యూమన్-ఇన్-ది-లూప్ ఇన్‌బాక్స్ - మీ గార్డ్‌రైల్ పాలసీ ఆమోదం అవసరమని ఫ్లాగ్ చేసే ఏదైనా చర్య (ఉదా. ఒక ఏజెంట్ WhatsApp సందేశం పంపబోతున్నప్పుడు) ఆమోదించబడే వరకు లేదా తిరస్కరించబడే వరకు ఇక్కడ వేచి ఉంటుంది. ఆడిట్ లాగ్ అనేది మీ టెనెంట్‌లో, ఒక వ్యక్తి లేదా ఏజెంట్ ద్వారా తీసుకున్న ప్రతి ముఖ్యమైన చర్య యొక్క పూర్తి, అపెండ్-మాత్రమే రికార్డ్.

"No active providers yet" when creating an agent - you should not see this on a new account: every new account runs on the platform's hosted pool for its first 3 months, and the Free plan does after that. It appears once you are on a paid plan using your own provider - activate one under Connect → Providers.

AIని అడగండి బటన్ లోపం ఇస్తుంది - పైన చెప్పిన కారణమే. మీ ఖాతా హోస్ట్ చేసిన పూల్ నుండి బయట ఉన్నప్పుడు మరియు దానికి స్వంతంగా యాక్టివ్ ప్రొవైడర్ లేనప్పుడు మాత్రమే ఇది విఫలమవుతుంది.

పెండింగ్‌లో ఉన్న WhatsApp/Telegram పంపినవారికి ఎప్పుడూ ప్రత్యుత్తరం రాదు - మీ ఆమోదం కోసం వేచి ఉన్న జత కోసం అడ్మిన్ → ఛానెల్‌లను తనిఖీ చేయండి.

ఒక ఏజెంట్‌కు టూల్ కనిపించడం లేదు - అది MCP టూల్స్ కింద ఎనేబుల్ చేయబడిందని, మరియు ఏజెంట్ యొక్క టూల్-యాక్సెస్ జాబితాలో అది చేర్చబడిందని లేదా ఖాళీగా (అపరిమితం) వదిలివేయబడిందని నిర్ధారించుకోండి.