接続
リモートサーバーに対応した任意のMCPクライアントにhttps://neboai.com/mcpを追加します。クライアントは認可サーバーを検出し、自身を登録し、OAuthとPKCEであなたをサインインさせます。どのNeboAIアカウントでも接続できます。アクセストークンの有効期間は1時間で、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 | 不要 | 自分のボットの1つにインストールします: id、botId、依存関係も含める場合はcascade。 |
bundle-token | 自動で用意 | テキストファイルのzipをアップロードするためのトークン。 |
binary-token | 自動で用意 | バイナリ、plugin.json、agent.json、アプリのUIをアップロードするためのトークン。 |
list-binaries, delete-binary | 自動で用意 | アップロード済みのバイナリを管理します。 |
submit | 自動で用意 | バージョンを審査に申請します。 |
| フィールド | 意味 |
|---|---|
name | 表示名。スラッグはここから作られます。 |
description | 1行。申請には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で付けます。修飾名は@<namespace>/skills/<slug>で、スラッグは表示名から作られます。ボットは修飾名をフロントマターのnameと照合して解決するので、両者は一致している必要があります。
スキルに他のファイルがある場合は、フォルダをzipとしてアップロードします。zip内の最上位フォルダが1つだけの場合は自動で取り除かれ、ビルド用やバージョン管理用のフォルダはスキップされます。
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/を1つの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とスキルとともに、プラットフォームごとに1つのバイナリをアップロードします。プラグインの出荷をご覧ください。ページだけのアプリにバイナリは不要です。bundle-tokenで、AGENT.md(artifact_type: app付き)、agent.json、manifest.json、ui/、そしてskills/があればそれも含めた1つのバンドルをアップロードします。サイドカーを持つアプリは、agentツールで同じバイナリのアップロードを使います。サイドカーのバイナリをplatform付きのfileとして、ページをui(ui/フォルダの.tar.gz)としてアップロードします。アプリをご覧ください。
審査
submitには、メインファイルの内容と10〜500文字の説明が必要です。申請はそれぞれスキャンされます。問題のないスキャン結果は自動で承認されることがあり、フラグが立ったものは手動の審査に回ります。承認されるとバイナリに署名され、そのバージョンが有効になります。却下されたバージョンは下書きに戻ります。
| アイテムのステータス | 意味 |
|---|---|
draft | 未申請、または却下。 |
pending_review, review | 審査待ち。 |
active | 承認済み。公開範囲がpublicの場合、マーケットプレイスに掲載されます。 |
revoked | 取り下げ済み。 |
インストールコード
アイテムにはすべて、作成時にインストールコードが付きます。SKIL-、AGNT-、PLUG-、APPS-、CONN-、COLL-のいずれかに8文字が続く形式です。Neboのチャットでそのコードをメッセージとして入力すると、アイテムがインストールされます。基本概念をご覧ください。