Jikọọ
Gbakwunye https://neboai.com/mcp na onye ahịa MCP ọ bụla na-akwado sava dị anya. Onye ahịa ahụ na-achọpụta sava ikike, na-edebanye onwe ya, ma na-abanye gị site na OAuth na PKCE. Akaụntụ NeboAI ọ bụla nwere ike ijikọ. Token ohere na-adịru otu awa ma na-emelite ruo ụbọchị 30.
Akaụntụ onye mmepe
Onye ọ bụla nwere akaụntụ NeboAI nwere ike ibipụta. Izipu ụdị na ibulite faịlụ na-eji akaụntụ onye mmepe gị, nke a na-ahaziri gị, n'efu, na nke mbụ i zipuru ma ọ bụ rịọ token mbulite. Enweghị ụgwọ na enweghị nzọụkwụ nkwado.
Iji bipụta maka otu kama maka onwe gị, họrọ akaụntụ otu ahụ maka oge mkparịta ụka ahụ. Ị ga-abụrịrị onye otu ahụ.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer nwekwara ike ịhazi akaụntụ gị tupu oge eruo (action: "create", nhọrọ) ma na-edepụta ma na-ahọrọ namespace (resource: "namespace"). Namespace a họọrọ na-aghọ akụkụ nke aha zuru ezu ọ bụla ị na-ebipụta.
Ngwaọrụ
Ngwaọrụ skill, agent na plugin na-ekekọrịta otu omume. A na-eji ngwaọrụ agent ebipụta ngwa.
| Omume | Akaụntụ onye mmepe | Na-eme |
|---|---|---|
create | achọghị ya | Na-emepụta ihe ahụ na koodu ịwụnye ya. |
update | achọghị ya | Na-agbanwe mpaghara, ọdịnaya, ụdị ma ọ bụ ọhụhụ. |
get, list, delete | achọghị ya | Na-agụ ma ọ bụ na-ewepụ ihe ndị i mepụtara. |
install | achọghị ya | Na-awụnye n'otu n'ime bot gị: id, botId, na cascade iji tinye ihe ọ dabere na ha. |
bundle-token | a na-ahazi ya n'onwe ya | Token maka ibulite zip nke faịlụ ederede. |
binary-token | a na-ahazi ya n'onwe ya | Token maka ibulite binary, plugin.json, agent.json na UI ngwa. |
list-binaries, delete-binary | a na-ahazi ya n'onwe ya | Na-ejikwa binary e bulitere. |
submit | a na-ahazi ya n'onwe ya | Na-ezipu ụdị maka nyocha. |
| Mpaghara | Ihe ọ pụtara |
|---|---|
name | Aha ngosi. A na-esi na ya emepụta slug. |
description | Otu ahịrị, mkpụrụedemede 10 ruo 500 iji zipu. |
manifestContent | Faịlụ bụ isi nke ihe ahụ: SKILL.md, AGENT.md ma ọ bụ PLUGIN.md. |
version | Ụdị semantic. Ndabara 0.1.0. |
visibility | private (ndabara), loop (a na-ekekọrịta ya na Ọwa gị) ma ọ bụ public. |
category | Ụdị n'ahịa. |
longDescription | Ederede “Ihe ọ na-eme” nke ahịa (naanị update). |
sourceUrl, manifestUrl | Njikọ nhọrọ. |
dependencies | Naanị ndị ọrụ. Lee Ihe ọ dabere na ha. |
Ngwaọrụ marketplace na-achọ n'ahịa ma na-edepụta ụdị. Ngwaọrụ pricing na-esetịpụ ọnụ ahịa n'ihe; ihe a na-akwụ ụgwọ chọrọ imezu nhazi ịkwụ ụgwọ.
Bipụta nka
Mepụta nka ahụ na SKILL.md ya dị ka ọdịnaya.
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>") Kpọọ nka ahụ aha site na name nke frontmatter ya. Aha zuru ezu ya bụ @<namespace>/skills/<slug>, ebe e si n'aha ngosi mepụta slug, bot na-edozikwa aha zuru ezu megide name nke frontmatter, ya mere ha abụọ ga-adakọrịrị.
Ọ bụrụ na nka ahụ nwere faịlụ ndị ọzọ, bulite folda ahụ dị ka zip. A na-ewepụ otu folda elu dị na zip ahụ n'onwe ya, a na-agafekwa folda iwu na njikwa ụdị.
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
| Iwu ngwugwu | Oke |
|---|---|
| Nha zip | 50 MB |
| Faịlụ ọ bụla | 10 MB |
| Faịlụ niile | 50 MB |
| Ụdị faịlụ | Ederede, koodu, data, foto, PDF na mkpụrụedemede, dị ka .md, .py, .js, .ts, .json, .yaml, .csv, .html. A na-anabata ihe ọ bụla dị n'okpuru scripts/, bin/ ma ọ bụ dist/. |
| Ụzọ | Enweghị .. na enweghị ụzọ zuru oke. |
Mee ka nka ahụ bụrụ nke ọha ma zipu ụdị.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Bipụta onye ọrụ
Mepụta onye ọrụ ahụ na AGENT.md ya dị ka ọdịnaya na ihe ọ dabere na ha n'ahịa.
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" } ] }) Bulite agent.json site na token binary. Ndị ọrụ achọghị binary; config zuru ezu. Iji tinye folda skills/ nke onye ọrụ ahụ, bulite ngwugwu ahụ dị ka bundle kama: AGENT.md, agent.json na skills/ n'otu 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
Debe ihe ọ dabere na ha na agent.json. agent.json e bulitere na-anọchi nhazi echekwara, gụnyere ihe ọ dabere na ha e setịpụrụ site na create ma ọ bụ update, update nwere dependencies na-anọchikwa agent.json echekwara. Mgbe i ji ha abụọ, tinye otu object dependencies ahụ n'ime agent.json.
Ihe ọ dabere na ha
dependencies nwere ndepụta skills, agents na connectors. Ihe ọ bụla dị na ya bụ {qualifiedName, id, name}; NeboAI na-ebu ụzọ nyochaa qualified name, emesịa id. A na-edepụta plugin n'okpuru skills. A na-agbakwunye plugin ndị nka a kpọrọ aha na agent.json chọrọ n'onwe ha. Mgbe onye nwe ya tinyere onye ọrụ gị site n'ahịa ma ọ bụ site na koodu ya, bot ahụ na-etinye nka, plugin na ndị ọrụ ọ dabere na ha ya na ya.
Bipụta plugin ma ọ bụ ngwa
Plugin na-ebulite otu binary kwa ikpo okwu ya na plugin.json na nka plugin ahụ; lee Iziga plugin. Ngwa nwere naanị ibe achọghị binary: bulite otu bundle site na bundle-token nwere AGENT.md (ya na artifact_type: app), agent.json, manifest.json, ui/ na skills/ ọ bụla. Ngwa nwere sidecar na-eji otu mbulite binary ahụ site na ngwaọrụ agent: binary sidecar dị ka file ya na platform ya, na ibe ahụ dị ka ui, .tar.gz nke folda ui/. Lee Ngwa.
Nyocha
submit chọrọ ọdịnaya faịlụ bụ isi na nkọwa nke mkpụrụedemede 10 ruo 500. A na-enyocha nzipu ọ bụla. Nnyocha dị ọcha nwere ike ịbụ nke a kwadoro n'onwe ya; ihe ọ bụla a kara akara na-aga na nyocha n'aka. Nkwado na-abịanye aka na binary ọ bụla ma mee ka ụdị ahụ rụọ ọrụ. Ụdị a jụrụ na-alaghachi na draft.
| Ọnọdụ ihe ahụ | Ihe ọ pụtara |
|---|---|
draft | E zipughị ya, ma ọ bụ a jụrụ ya. |
pending_review, review | Na-echere nyocha. |
active | A kwadoro ya. E depụtara ya n'ahịa mgbe ọhụhụ bụ public. |
revoked | E wepụrụ ya. |
Koodu ịwụnye
Ihe ọ bụla na-enweta koodu ịwụnye ya mgbe e mepụtara ya: SKIL-, AGNT-, PLUG-, APPS-, CONN- ma ọ bụ COLL- sochiri ya mkpụrụedemede asatọ. Ịpịnye koodu ahụ dị ka ozi na nkata Nebo na-awụnye ihe ahụ; lee Echiche ndị bụ isi.