కనెక్ట్ చేయండి
రిమోట్ సర్వర్లకు మద్దతు ఇచ్చే ఏ MCP క్లయింట్కైనా https://neboai.com/mcpను జోడించండి. క్లయింట్ అధీకృత సర్వర్ను కనుగొని, తనను తాను రిజిస్టర్ చేసుకుని, OAuth, PKCEతో మిమ్మల్ని సైన్ ఇన్ చేస్తుంది. ఏ NeboAI ఖాతా అయినా కనెక్ట్ కావచ్చు. యాక్సెస్ టోకెన్లు ఒక గంట ఉంటాయి, 30 రోజుల వరకు రిఫ్రెష్ అవుతాయి.
డెవలపర్ ఖాతా
NeboAI ఖాతా ఉన్న ఎవరైనా ప్రచురించవచ్చు. వెర్షన్ను సబ్మిట్ చేయడం, ఫైల్లను అప్లోడ్ చేయడం మీ డెవలపర్ ఖాతాను ఉపయోగిస్తాయి, మీరు మొదటిసారి సబ్మిట్ చేసినప్పుడు లేదా అప్లోడ్ టోకెన్ అడిగినప్పుడు అది మీ కోసం ఉచితంగా సెటప్ చేయబడుతుంది. ఫీజు లేదు, ఆమోద దశ లేదు.
మీ కోసం కాకుండా ఒక టీమ్ కోసం ప్రచురించడానికి, సెషన్ కోసం టీమ్ ఖాతాను ఎంచుకోండి. మీరు ఆ టీమ్లో సభ్యులై ఉండాలి.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer మీ ఖాతాను ముందుగానే సెటప్ చేయగలదు (action: "create", ఐచ్ఛికం), నేమ్స్పేస్లను జాబితా చేసి ఎంచుకోగలదు (resource: "namespace"). ఎంచుకున్న నేమ్స్పేస్ మీరు ప్రచురించే ప్రతి qualified పేరులో భాగమవుతుంది.
టూల్స్
skill, agent, plugin టూల్స్ ఒకే చర్యల సమితిని పంచుకుంటాయి. యాప్లు agent టూల్తో ప్రచురించబడతాయి.
| చర్య | డెవలపర్ ఖాతా | చేసేది |
|---|---|---|
create | అవసరం లేదు | ఐటమ్ను, దాని ఇన్స్టాల్ కోడ్ను సృష్టిస్తుంది. |
update | అవసరం లేదు | ఫీల్డ్లు, కంటెంట్, వెర్షన్ లేదా విజిబిలిటీని మారుస్తుంది. |
get, list, delete | అవసరం లేదు | మీ ఐటమ్లను చదువుతుంది లేదా తీసివేస్తుంది. |
install | అవసరం లేదు | మీ బాట్లలో ఒకదానిపై ఇన్స్టాల్ చేస్తుంది: id, botId, డిపెండెన్సీలను చేర్చడానికి cascade. |
bundle-token | ఆటోమేటిక్గా సెటప్ అవుతుంది | టెక్స్ట్ ఫైల్ల zipను అప్లోడ్ చేయడానికి ఒక టోకెన్. |
binary-token | ఆటోమేటిక్గా సెటప్ అవుతుంది | బైనరీలు, plugin.json, agent.json, యాప్ UIలను అప్లోడ్ చేయడానికి ఒక టోకెన్. |
list-binaries, delete-binary | ఆటోమేటిక్గా సెటప్ అవుతుంది | అప్లోడ్ చేసిన బైనరీలను నిర్వహిస్తుంది. |
submit | ఆటోమేటిక్గా సెటప్ అవుతుంది | సమీక్ష కోసం ఒక వెర్షన్ను సబ్మిట్ చేస్తుంది. |
| ఫీల్డ్ | అర్థం |
|---|---|
name | డిస్ప్లే పేరు. slug దాని నుండి తయారవుతుంది. |
description | ఒక లైన్, సబ్మిట్ చేయడానికి 10 నుండి 500 అక్షరాలు. |
manifestContent | ఐటమ్ ప్రధాన ఫైల్: SKILL.md, AGENT.md లేదా PLUGIN.md. |
version | సెమాంటిక్ వెర్షన్. డిఫాల్ట్ 0.1.0. |
visibility | private (డిఫాల్ట్), loop (మీ ఛానెల్లతో షేర్ చేయబడుతుంది) లేదా public. |
category | మార్కెట్ప్లేస్ వర్గం. |
longDescription | మార్కెట్ప్లేస్ “ఇది ఏమి చేస్తుంది” టెక్స్ట్ (update మాత్రమే). |
sourceUrl, manifestUrl | ఐచ్ఛిక లింక్లు. |
dependencies | ఉద్యోగులకు మాత్రమే. డిపెండెన్సీలు చూడండి. |
marketplace టూల్ మార్కెట్ప్లేస్లో వెతుకుతుంది, వర్గాలను జాబితా చేస్తుంది. pricing టూల్ ఐటమ్పై ధర సెట్ చేస్తుంది; చెల్లింపు ఐటమ్లకు పేఅవుట్ ఆన్బోర్డింగ్ పూర్తి చేయడం అవసరం.
నైపుణ్యాన్ని ప్రచురించండి
దాని SKILL.mdను కంటెంట్గా ఇచ్చి నైపుణ్యాన్ని సృష్టించండి.
skill(action: "create", name: "invoice-totals",
description: "Add up invoice line items, apply tax, and report the totals.",
category: "finance", version: "1.0.0", manifestContent: "<contents of SKILL.md>") నైపుణ్యానికి దాని ఫ్రంట్మ్యాటర్ nameతో పేరు పెట్టండి. దాని qualified పేరు @<namespace>/skills/<slug>, slug డిస్ప్లే పేరు నుండి తయారవుతుంది, బాట్లు qualified పేర్లను ఫ్రంట్మ్యాటర్ nameతో సరిపోల్చి పరిష్కరిస్తాయి, కాబట్టి రెండూ సరిపోలాలి.
నైపుణ్యానికి ఇతర ఫైల్లు ఉంటే, ఫోల్డర్ను zipగా అప్లోడ్ చేయండి. zipలోని ఒకే పై-స్థాయి ఫోల్డర్ ఆటోమేటిక్గా తీసివేయబడుతుంది, బిల్డ్, వెర్షన్-కంట్రోల్ ఫోల్డర్లు దాటవేయబడతాయి.
skill(action: "bundle-token", id: "<skill id>") cd invoice-totals && zip -r ../invoice-totals.zip . && cd .. curl -X POST "https://neboai.com/api/v1/skills/<skill id>/bundle" \ -H "Authorization: Bearer <token>" \ -F file=@invoice-totals.zip
| బండిల్ నియమం | పరిమితి |
|---|---|
| Zip పరిమాణం | 50 MB |
| ప్రతి ఫైల్ | 10 MB |
| అన్ని ఫైల్లు | 50 MB |
| ఫైల్ రకాలు | టెక్స్ట్, కోడ్, డేటా, చిత్రాలు, PDF, ఫాంట్లు, ఉదాహరణకు .md, .py, .js, .ts, .json, .yaml, .csv, .html. scripts/, bin/ లేదా dist/ కింద ఉన్నది ఏదైనా అంగీకరించబడుతుంది. |
| పాత్లు | .. లేదు, అబ్సొల్యూట్ పాత్లు లేవు. |
నైపుణ్యాన్ని పబ్లిక్గా చేసి ఒక వెర్షన్ను సబ్మిట్ చేయండి.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
ఉద్యోగిని ప్రచురించండి
దాని AGENT.mdను కంటెంట్గా, దాని మార్కెట్ప్లేస్ డిపెండెన్సీలతో ఉద్యోగిని సృష్టించండి.
agent(action: "create", name: "Support Coordinator",
description: "Answers every customer message the day it arrives and escalates what it cannot settle.",
version: "1.0.0", manifestContent: "<contents of AGENT.md>",
dependencies: { skills: [ { qualifiedName: "@example-studio/skills/reply-drafting", id: "<skill id>", name: "reply-drafting" } ] }) బైనరీ టోకెన్తో agent.jsonను అప్లోడ్ చేయండి. ఉద్యోగులకు బైనరీ అవసరం లేదు; config సరిపోతుంది. ఉద్యోగి సొంత skills/ ఫోల్డర్ను చేర్చడానికి, దానికి బదులు ప్యాకేజీని బండిల్గా అప్లోడ్ చేయండి: AGENT.md, agent.json, skills/ ఒకే zipలో.
agent(action: "binary-token", id: "<agent id>") curl -X POST "https://neboai.com/api/v1/developer/apps/<agent id>/binaries" \ -H "Authorization: Bearer <token>" \ -F config=@support-coordinator/agent.json
డిపెండెన్సీలను agent.jsonలో ఉంచండి. అప్లోడ్ చేసిన agent.json నిల్వ ఉన్న కాన్ఫిగరేషన్ను భర్తీ చేస్తుంది, create లేదా updateతో సెట్ చేసిన డిపెండెన్సీలతో సహా, మరియు dependenciesతో కూడిన update నిల్వ ఉన్న agent.jsonను భర్తీ చేస్తుంది. రెండింటినీ ఉపయోగించినప్పుడు, అదే dependencies ఆబ్జెక్ట్ను agent.json లోపల పెట్టండి.
డిపెండెన్సీలు
dependenciesలో skills, agents మరియు connectors జాబితాలు ఉంటాయి. ప్రతి ఎంట్రీ {qualifiedName, id, name}; NeboAI ముందుగా qualified nameను, ఆ తర్వాత idని తనిఖీ చేస్తుంది. ప్లగిన్ను skills కింద జాబితా చేస్తారు. agent.jsonలో పేర్కొన్న నైపుణ్యాలకు అవసరమైన ప్లగిన్లు ఆటోమేటిక్గా జోడించబడతాయి. యజమాని మీ ఉద్యోగిని మార్కెట్ప్లేస్ నుండి లేదా దాని కోడ్తో ఇన్స్టాల్ చేసినప్పుడు, బాట్ దానితో పాటు దాని నైపుణ్యం, ప్లగిన్ మరియు ఉద్యోగి డిపెండెన్సీలను ఇన్స్టాల్ చేస్తుంది.
ప్లగిన్ లేదా యాప్ను ప్రచురించండి
ప్లగిన్లు ప్లగిన్ plugin.json, నైపుణ్యాలతో ప్రతి ప్లాట్ఫామ్కు ఒక బైనరీని అప్లోడ్ చేస్తాయి; ప్లగిన్ను విడుదల చేయడం చూడండి. పేజీ మాత్రమే ఉన్న యాప్కు బైనరీ అవసరం లేదు: AGENT.md (artifact_type: appతో), agent.json, manifest.json, ui/, ఏవైనా skills/ ఉన్న ఒక బండిల్ను bundle-tokenతో అప్లోడ్ చేయండి. సైడ్కార్ ఉన్న యాప్ agent టూల్తో అదే బైనరీ అప్లోడ్ను ఉపయోగిస్తుంది: సైడ్కార్ బైనరీని దాని platformతో fileగా, పేజీని uiగా, అంటే ui/ ఫోల్డర్ యొక్క .tar.gzగా. యాప్లు చూడండి.
సమీక్ష
submitకి ప్రధాన ఫైల్ కంటెంట్, 10 నుండి 500 అక్షరాల వివరణ అవసరం. ప్రతి సబ్మిషన్ స్కాన్ చేయబడుతుంది. సమస్య లేని స్కాన్ ఆటోమేటిక్గా ఆమోదించబడవచ్చు; ఫ్లాగ్ అయినది ఏదైనా మాన్యువల్ సమీక్షకు వెళ్తుంది. ఆమోదం ఏవైనా బైనరీలకు సంతకం చేసి వెర్షన్ను యాక్టివ్ చేస్తుంది. తిరస్కరించిన వెర్షన్ డ్రాఫ్ట్కు తిరిగి వెళ్తుంది.
| ఐటమ్ స్థితి | అర్థం |
|---|---|
draft | సబ్మిట్ చేయలేదు, లేదా తిరస్కరించబడింది. |
pending_review, review | సమీక్ష కోసం వేచి ఉంది. |
active | ఆమోదించబడింది. విజిబిలిటీ public అయినప్పుడు మార్కెట్ప్లేస్లో లిస్ట్ అవుతుంది. |
revoked | ఉపసంహరించబడింది. |
ఇన్స్టాల్ కోడ్లు
ప్రతి ఐటమ్కు అది సృష్టించబడినప్పుడే ఇన్స్టాల్ కోడ్ వస్తుంది: SKIL-, AGNT-, PLUG-, APPS-, CONN- లేదా COLL- తర్వాత ఎనిమిది అక్షరాలు. Nebo చాట్లో కోడ్ను మెసేజ్గా టైప్ చేస్తే ఐటమ్ ఇన్స్టాల్ అవుతుంది; ముఖ్య భావనలు చూడండి.