Sopọ̀
Fi https://neboai.com/mcp kún oníbàárà MCP èyíkéyìí tí ó ṣe àtìlẹ́yìn fún àwọn sáfà jíjìn. Oníbàárà náà ń ṣàwárí sáfà ìfúnláṣẹ, ó ń forúkọ ara rẹ̀ sílẹ̀, ó sì ń mú ọ wọlé pẹ̀lú OAuth àti PKCE. Àkọọ́lẹ̀ NeboAI èyíkéyìí lè sopọ̀. Àwọn token ààyè ń wà fún wákàtí kan, wọ́n sì ń sọ dọ̀tun fún ọjọ́ 30.
Àkọọ́lẹ̀ olùgbéejáde
Ẹnikẹ́ni tí ó ní àkọọ́lẹ̀ NeboAI lè ṣe àtẹ̀jáde. Fífi ẹ̀dà ránṣẹ́ àti gbígbé fáìlì sókè ń lo àkọọ́lẹ̀ olùgbéejáde rẹ, tí a ṣètò fún ọ, lọ́fẹ̀ẹ́, ní ìgbà àkọ́kọ́ tí o bá fi nǹkan ránṣẹ́ tàbí béèrè fún token ìgbésókè. Kò sí owó kankan, kò sì sí ìgbésẹ̀ ìfọwọ́sí.
Láti ṣe àtẹ̀jáde fún ẹgbẹ́ kan dípò ara rẹ, yan àkọọ́lẹ̀ ẹgbẹ́ náà fún ìgbà ìjíròrò náà. O gbọ́dọ̀ jẹ́ ọmọ ẹgbẹ́ náà.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer tún lè ṣètò àkọọ́lẹ̀ rẹ ṣáájú (action: "create", àṣàyàn), ó sì ń ṣe àtòjọ àti yíyan àwọn namespace (resource: "namespace"). Namespace tí a yàn ń di apá kan gbogbo orúkọ kíkún tí o bá ṣe àtẹ̀jáde.
Àwọn irinṣẹ́
Àwọn irinṣẹ́ skill, agent àti plugin ń pín àkójọ action kan. A ń ṣe àtẹ̀jáde àwọn áàpù pẹ̀lú irinṣẹ́ agent.
| Action | Àkọọ́lẹ̀ olùgbéejáde | Ohun tí ó ń ṣe |
|---|---|---|
create | kò nílò | Ó ń ṣẹ̀dá ohun náà àti kóòdù ìfisórí-ẹ̀rọ rẹ̀. |
update | kò nílò | Ó ń yí àwọn pápá, àkóónú, ẹ̀dà tàbí ìhàn padà. |
get, list, delete | kò nílò | Ó ń ka àwọn ohun rẹ tàbí ó ń yọ wọ́n kúrò. |
install | kò nílò | Ó ń fi sórí ọ̀kan nínú àwọn bot rẹ: id, botId, àti cascade láti fi àwọn ohun tí ó gbára lé kún un. |
bundle-token | a ṣètò rẹ̀ fúnra rẹ̀ | Token fún gbígbé zip ti àwọn fáìlì ọ̀rọ̀ sókè. |
binary-token | a ṣètò rẹ̀ fúnra rẹ̀ | Token fún gbígbé binary, plugin.json, agent.json àti UI áàpù sókè. |
list-binaries, delete-binary | a ṣètò rẹ̀ fúnra rẹ̀ | Ó ń ṣàkóso àwọn binary tí a gbé sókè. |
submit | a ṣètò rẹ̀ fúnra rẹ̀ | Ó ń fi ẹ̀dà kan ránṣẹ́ fún àyẹ̀wò. |
| Pápá | Ìtumọ̀ |
|---|---|
name | Orúkọ ìfihàn. A ń ṣe slug láti inú rẹ̀. |
description | Ìlà kan, àmì 10 sí 500 láti fi ránṣẹ́. |
manifestContent | Fáìlì pàtàkì ohun náà: SKILL.md, AGENT.md tàbí PLUGIN.md. |
version | Ẹ̀dà semantic. Ìpìlẹ̀ 0.1.0. |
visibility | private (ìpìlẹ̀), loop (tí a pín pẹ̀lú àwọn Ìkànnì rẹ) tàbí public. |
category | Ẹ̀ka ọjà. |
longDescription | Ọ̀rọ̀ “Ohun tí ó ń ṣe” nínú ọjà (update nìkan). |
sourceUrl, manifestUrl | Àwọn ìjápọ̀ àṣàyàn. |
dependencies | Àwọn òṣìṣẹ́ nìkan. Wo Àwọn ohun tí ó gbára lé. |
Irinṣẹ́ marketplace ń wá nínú ọjà, ó sì ń ṣe àtòjọ àwọn ẹ̀ka. Irinṣẹ́ pricing ń ṣètò iye owó lórí ohun kan; àwọn ohun olówó nílò parí ìṣètò ìsanwó-jáde.
Ṣe àtẹ̀jáde ọgbọ́n kan
Ṣẹ̀dá ọgbọ́n náà pẹ̀lú SKILL.md rẹ̀ gẹ́gẹ́ bí àkóónú.
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>") Dárúkọ ọgbọ́n náà pẹ̀lú name nínú frontmatter rẹ̀. Orúkọ kíkún rẹ̀ ni @<namespace>/skills/<slug>, pẹ̀lú slug tí a ṣe láti orúkọ ìfihàn, àwọn bot sì ń yanjú orúkọ kíkún pẹ̀lú name frontmatter, nítorí náà méjèèjì gbọ́dọ̀ bá ara wọn mu.
Bí ọgbọ́n náà bá ní àwọn fáìlì míì, gbé fódà náà sókè gẹ́gẹ́ bí zip. A ń yọ fódà òkè kan ṣoṣo nínú zip kúrò fúnra rẹ̀, a sì ń fo àwọn fódà kíkọ́ àti ìṣàkóso ẹ̀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
| Òfin àpapọ̀ | Òdiwọ̀n |
|---|---|
| Ìwọ̀n zip | 50 MB |
| Fáìlì kọ̀ọ̀kan | 10 MB |
| Gbogbo fáìlì | 50 MB |
| Àwọn irú fáìlì | Ọ̀rọ̀, kóòdù, dátà, àwòrán, PDF àti fọ́ǹtì, bí .md, .py, .js, .ts, .json, .yaml, .csv, .html. A ń gba ohunkóhun lábẹ́ scripts/, bin/ tàbí dist/. |
| Àwọn ọ̀nà | Kò sí .., kò sì sí ọ̀nà pípé. |
Sọ ọgbọ́n náà di gbangba kí o sì fi ẹ̀dà kan ránṣẹ́.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Ṣe àtẹ̀jáde òṣìṣẹ́ kan
Ṣẹ̀dá òṣìṣẹ́ náà pẹ̀lú AGENT.md rẹ̀ gẹ́gẹ́ bí àkóónú àti àwọn ohun ọjà tí ó gbára lé.
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" } ] }) Gbé agent.json sókè pẹ̀lú binary token. Àwọn òṣìṣẹ́ kò nílò binary; config ti tó. Láti fi fódà skills/ òṣìṣẹ́ náà fúnra rẹ̀ kún un, gbé àpò náà sókè gẹ́gẹ́ bí àpapọ̀ dípò: AGENT.md, agent.json àti skills/ nínú zip kan.
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
Pa àwọn ohun tí ó gbára lé mọ́ sínú agent.json. agent.json tí a gbé sókè ń rọ́pò ìṣètò tí a tọ́jú, títí kan àwọn ohun tí ó gbára lé tí a ṣètò pẹ̀lú create tàbí update, update pẹ̀lú dependencies sì ń rọ́pò agent.json tí a tọ́jú. Nígbà tí o bá lo méjèèjì, fi object dependencies kan náà sínú agent.json.
Àwọn ohun tí ó gbára lé
dependencies ní àwọn àkójọ skills, agents àti connectors. Ohun kọ̀ọ̀kan jẹ́ {qualifiedName, id, name}; NeboAI máa ń kọ́kọ́ ṣàyẹ̀wò orúkọ kíkún, lẹ́yìn náà id. A máa ń to plugin sábẹ́ skills. A máa ń fi àwọn plugin tí àwọn ọgbọ́n tí a dárúkọ nínú agent.json nílò kún un fúnra rẹ̀. Nígbà tí olúwa kan bá fi òṣìṣẹ́ rẹ sórí ẹ̀rọ láti ọjà tàbí pẹ̀lú kóòdù rẹ̀, bot náà máa ń fi àwọn ọgbọ́n, plugin àti òṣìṣẹ́ tí ó gbára lé sórí ẹ̀rọ pẹ̀lú rẹ̀.
Ṣe àtẹ̀jáde plugin tàbí áàpù kan
Àwọn plugin ń gbé binary kan sókè fún pẹpẹ kọ̀ọ̀kan pẹ̀lú plugin.json àti àwọn ọgbọ́n plugin náà; wo Fífi plugin jáde. Áàpù tí ó jẹ́ ojú-ìwé nìkan kò nílò binary: gbé àpapọ̀ kan sókè pẹ̀lú bundle-token tí ó ní AGENT.md (pẹ̀lú artifact_type: app), agent.json, manifest.json, ui/ àti skills/ èyíkéyìí. Áàpù tí ó ní sidecar ń lo ìgbésókè binary kan náà pẹ̀lú irinṣẹ́ agent: binary sidecar gẹ́gẹ́ bí file pẹ̀lú platform rẹ̀, àti ojú-ìwé gẹ́gẹ́ bí ui, .tar.gz ti fódà ui/. Wo Àwọn áàpù.
Àyẹ̀wò
submit nílò àkóónú fáìlì pàtàkì àti àpèjúwe tí ó ní àmì 10 sí 500. A ń yẹ ìfiránṣẹ́ kọ̀ọ̀kan wò. Àyẹ̀wò tí kò ní ìṣòro lè gba ìfọwọ́sí fúnra rẹ̀; ohunkóhun tí a sàmì sí ń lọ fún àyẹ̀wò ọwọ́. Ìfọwọ́sí ń fọwọ́ sí àwọn binary èyíkéyìí, ó sì ń mú ẹ̀dà náà ṣiṣẹ́. Ẹ̀dà tí a kọ̀ ń padà sí àkọ́pamọ́.
| Ipò ohun náà | Ìtumọ̀ |
|---|---|
draft | A kò tíì fi ránṣẹ́, tàbí a ti kọ̀ ọ́. |
pending_review, review | Ó ń dúró de àyẹ̀wò. |
active | A ti fọwọ́ sí i. Ó wà nínú àkọsílẹ̀ ọjà nígbà tí ìhàn bá jẹ́ public. |
revoked | A ti yọ ọ́ kúrò. |
Àwọn kóòdù ìfisórí-ẹ̀rọ
Gbogbo ohun inú ọjà ló ń gba kóòdù ìfisórí-ẹ̀rọ rẹ̀ nígbà tí a bá ṣẹ̀dá rẹ̀: SKIL-, AGNT-, PLUG-, APPS-, CONN- tàbí COLL- tí àmì mẹ́jọ tẹ̀lé. Títẹ kóòdù náà gẹ́gẹ́ bí ìránṣẹ́ nínú ìjíròrò Nebo ń fi ohun náà sórí ẹ̀rọ; wo Àwọn èrò pàtàkì.