ማገናኘት
https://neboai.com/mcpን የርቀት አገልጋዮችን ለሚደግፍ ለማንኛውም የMCP ደንበኛ ያክሉ። ደንበኛው የፈቃድ መስጫ አገልጋዩን ያገኛል፣ ራሱን ያስመዘግባል፣ በOAuth እና በPKCEም ያስገባዎታል። ማንኛውም የNeboAI መለያ መገናኘት ይችላል። የመዳረሻ ቶከኖች ለአንድ ሰዓት ይቆያሉ፣ ለ30 ቀናትም ይታደሳሉ።
የገንቢ መለያ
የNeboAI መለያ ያለው ማንኛውም ሰው ማተም ይችላል። ስሪት ማስገባትና ፋይሎችን መስቀል የገንቢ መለያዎን ይጠቀማሉ፣ ይህም ለመጀመሪያ ጊዜ ሲያስገቡ ወይም የስቀላ ቶከን ሲጠይቁ በነፃ ይዘጋጅልዎታል። ክፍያ የለም፣ የማጽደቅ ደረጃም የለም።
ከራስዎ ይልቅ ለቡድን ለማተም፣ ለክፍለ ጊዜው የቡድኑን መለያ ይምረጡ። የቡድኑ አባል መሆን አለብዎት።
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer መለያዎን አስቀድሞ ማዘጋጀትም ይችላል (action: "create"፣ አማራጭ)፣ የስም ቦታዎችንም ይዘረዝራል፣ ይመርጣልም (resource: "namespace")። የተመረጠው የስም ቦታ የሚያትሙት የእያንዳንዱ ሙሉ ስም አካል ይሆናል።
መሣሪያዎች
የ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 | Semantic 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>") ክህሎቱን በfrontmatter nameው ይሰይሙት። ሙሉ ስሙ @<namespace>/skills/<slug> ነው፤ slugው ከሚታየው ስም ይሠራል፣ ቦቶችም ሙሉ ስሞችን ከfrontmatter 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ን በbinary token ይስቀሉ። ሰራተኞች ተፈጻሚ ፋይል አያስፈልጋቸውም፤ config በቂ ነው። የሰራተኛውን የራሱን skills/ አቃፊ ለማካተት፣ በምትኩ ጥቅሉን እንደ bundle ይስቀሉ፤ 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 መጀመሪያ ሙሉ ስሙን፣ ከዚያ IDውን ይፈትሻል። ተሰኪ በskills ስር ይዘረዘራል። በagent.json ውስጥ በተሰየሙ ክህሎቶች የሚፈለጉ ተሰኪዎች በራስ-ሰር ይጨመራሉ። አንድ ባለቤት ሰራተኛዎን ከገበያ ቦታው ወይም በኮዱ ሲጭን፣ ቦቱ የክህሎት፣ የተሰኪ እና የሰራተኛ ጥገኞቹን አብሮ ይጭናል።
ተሰኪ ወይም መተግበሪያ ያትሙ
ተሰኪዎች ለእያንዳንዱ መድረክ አንድ ተፈጻሚ ፋይልን ከተሰኪው plugin.json እና ክህሎቶች ጋር ይሰቅላሉ፤ ተሰኪ ማቅረብን ይመልከቱ። ገጽ ብቻ ያለው መተግበሪያ ተፈጻሚ ፋይል አያስፈልገውም፤ AGENT.md (ከartifact_type: app ጋር)፣ agent.json፣ manifest.json፣ ui/ እና ማናቸውንም skills/ የያዘ አንድ bundle በbundle-token ይስቀሉ። sidecar ያለው መተግበሪያ በagent መሣሪያ ያንኑ የተፈጻሚ ፋይል ስቀላ ይጠቀማል፤ የsidecar ተፈጻሚ ፋይሉን እንደ file ከplatformው ጋር፣ ገጹን ደግሞ እንደ ui፣ የui/ አቃፊ .tar.gz። መተግበሪያዎችን ይመልከቱ።
ግምገማ
submit የዋናውን ፋይል ይዘትና ከ10 እስከ 500 ቁምፊዎች ያለው መግለጫ ያስፈልገዋል። እያንዳንዱ ማስገባት ይቃኛል። ንጹህ ቅኝት በራሱ ሊጸድቅ ይችላል፤ ምልክት የተደረገበት ማንኛውም ነገር ወደ እጅ ግምገማ ይሄዳል። ማጽደቅ ማናቸውንም ተፈጻሚ ፋይሎች ይፈርማል፣ ስሪቱንም ንቁ ያደርገዋል። ውድቅ የተደረገ ስሪት ወደ ረቂቅ ይመለሳል።
| የንጥል ሁኔታ | ትርጉም |
|---|---|
draft | ያልገባ፣ ወይም ውድቅ የተደረገ። |
pending_review, review | ግምገማን በመጠበቅ ላይ። |
active | የጸደቀ። ታይነቱ public ሲሆን በገበያ ቦታው ላይ ይዘረዘራል። |
revoked | የተነሳ። |
የመጫኛ ኮዶች
እያንዳንዱ ንጥል ሲፈጠር የመጫኛ ኮዱን ያገኛል፤ SKIL-፣ AGNT-፣ PLUG-፣ APPS-፣ CONN- ወይም COLL- እና ከዚያ በኋላ ስምንት ቁምፊዎች። ኮዱን በNebo ውይይት ውስጥ እንደ መልዕክት መተየብ ንጥሉን ይጭናል፤ ዋና ጽንሰ ሐሳቦችን ይመልከቱ።