NeboAI
NeboAI
ಪ್ರಾರಂಭಿಸಿ

ಪ್ಲಗಿನ್‌ಗಳು

ಪ್ಲಗಿನ್ ಉದ್ಯೋಗಿಗಳಿಗೆ ಕೆಲಸ ಮಾಡಲು ಏನನ್ನಾದರೂ ನೀಡುತ್ತದೆ: ಆನ್‌ಲೈನ್ ಸೇವೆ, ವ್ಯಾಪಾರ ವ್ಯವಸ್ಥೆ, ಅಥವಾ ಕಂಪ್ಯೂಟರ್‌ನಲ್ಲಿರುವ ಪ್ರೋಗ್ರಾಂ. ನೀವು ಅದನ್ನು ಕಮಾಂಡ್-ಲೈನ್ ಬೈನರಿಯಾಗಿ ಬಿಲ್ಡ್ ಮಾಡುತ್ತೀರಿ ಮತ್ತು plugin.json ಮ್ಯಾನಿಫೆಸ್ಟ್ ಮೂಲಕ ವಿವರಿಸುತ್ತೀರಿ. ಉದ್ಯೋಗಿಗಳು ಅದರ ಕಮಾಂಡ್‌ಗಳನ್ನು ಕರೆಯುತ್ತಾರೆ, ಮತ್ತು Nebo ಇನ್‌ಸ್ಟಾಲೇಶನ್, ಪ್ರತಿ ಉದ್ಯೋಗಿಯ ಖಾತೆಗಳು ಮತ್ತು ಅಪ್‌ಡೇಟ್‌ಗಳನ್ನು ನೋಡಿಕೊಳ್ಳುತ್ತದೆ.

ಪ್ಲಗಿನ್‌ಗಳು ಹೇಗೆ ಕೆಲಸ ಮಾಡುತ್ತವೆ

ಪ್ಲಗಿನ್ ಎಂದರೆ ಒಂದು ಎಕ್ಸಿಕ್ಯೂಟಬಲ್ ಜೊತೆಗೆ ಒಂದು ಮ್ಯಾನಿಫೆಸ್ಟ್. ಕರೆಗಳ ನಡುವೆ Nebo ಯಾವುದೇ ಪ್ಲಗಿನ್ ಪ್ರಕ್ರಿಯೆಯನ್ನು ನಡೆಯುತ್ತಾ ಇಡುವುದಿಲ್ಲ. ಉದ್ಯೋಗಿ ಪ್ಲಗಿನ್ ಬಳಸಿದ ಪ್ರತಿ ಬಾರಿ, Nebo ಬೈನರಿಯನ್ನು ಒಂದು ಕಮಾಂಡ್ ಮತ್ತು ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳೊಂದಿಗೆ ಪ್ರಾರಂಭಿಸುತ್ತದೆ, ಅದು ಮುಗಿಯುವವರೆಗೆ ಕಾಯುತ್ತದೆ, ಮತ್ತು ಔಟ್‌ಪುಟ್ ಅನ್ನು ಉದ್ಯೋಗಿಗೆ ಮರಳಿಸುತ್ತದೆ.

  • ಕಮಾಂಡ್‌ಗಳು ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳು. ಉದ್ಯೋಗಿ notes search ನಂತಹ ಕಮಾಂಡ್ ಮತ್ತು ಹೆಸರಿಸಿದ ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳನ್ನು ಆಯ್ಕೆಮಾಡುತ್ತಾರೆ. Nebo ಪ್ರತಿ ಆರ್ಗ್ಯುಮೆಂಟ್ ಅನ್ನು --name value ಆಗಿ ರವಾನಿಸುತ್ತದೆ. ಶೆಲ್ ಇಲ್ಲ, ಆದ್ದರಿಂದ ಪೈಪ್‌ಗಳು ಮತ್ತು ರೀಡೈರೆಕ್ಟ್‌ಗಳು ಎಂದಿಗೂ ಅನ್ವಯಿಸುವುದಿಲ್ಲ.
  • ಔಟ್‌ಪುಟ್ stdout ಆಗಿದೆ. ಫಲಿತಾಂಶಗಳನ್ನು stdout ಗೆ ಬರೆಯಿರಿ. JSON ಚೆನ್ನಾಗಿ ಕೆಲಸ ಮಾಡುತ್ತದೆ.
  • ಸಾಮಾನ್ಯ ಕರೆಗಳಿಗೆ ಸ್ಟ್ಯಾಂಡರ್ಡ್ ಇನ್‌ಪುಟ್ ಮುಚ್ಚಿರುತ್ತದೆ. ಹುಕ್‌ಗಳು, ರೂಟ್‌ಗಳು ಮತ್ತು ಚಾಟ್ ಪ್ರೊವೈಡರ್‌ಗಳು stdin ಬಳಸುತ್ತವೆ; plugin.json ಉಲ್ಲೇಖ ನೋಡಿ.

ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿರುವ ಮತ್ತು ಸಕ್ರಿಯಗೊಳಿಸಿದ ಪ್ರತಿ ಪ್ಲಗಿನ್ ಉದ್ಯೋಗಿಗಳಿಗೆ plugin__<slug> ಹೆಸರಿನ ಒಂದು ಟೂಲ್ ಆಗಿ ಕಾಣಿಸುತ್ತದೆ. ಉದ್ಯೋಗಿ ಅದನ್ನು ಹೀಗೆ ಕರೆಯುತ್ತಾರೆ:

{
  "command": "notes search",
  "args": { "query": "quarterly plan", "limit": "5" },
  "display": "Search notes for the quarterly plan"
}

Nebo ರನ್ ಮಾಡುವುದು:

notes-sync notes search --query "quarterly plan" --limit 5
ಪ್ಯಾರಾಮೀಟರ್ಪ್ರಕಾರಅರ್ಥ
commandಸ್ಟ್ರಿಂಗ್, ಅಗತ್ಯಪ್ಲಗಿನ್ ಕಮಾಂಡ್ ಮತ್ತು ಯಾವುದೇ ಸ್ಥಾನಿಕ ಪದಗಳು.
argsಸ್ಟ್ರಿಂಗ್‌ಗಳ ಆಬ್ಜೆಕ್ಟ್ಹೆಸರಿಸಿದ ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳು. ಪ್ರತಿಯೊಂದೂ --key value ಆಗುತ್ತದೆ.
timeoutintegerಕಾಯಬೇಕಾದ ಸೆಕೆಂಡುಗಳು. ಡೀಫಾಲ್ಟ್ 120, ಮ್ಯಾನಿಫೆಸ್ಟ್‌ನ permissions.maxTimeoutSeconds ಮಿತಿಯೊಳಗೆ.
displaystringಕರೆಗೆ ಅನುಮೋದನೆ ಬೇಕಾದಾಗ ಮಾಲೀಕರು ನೋಡುವ ವಾಕ್ಯ.

ನಿಮ್ಮ ಮೊದಲ ಪ್ಲಗಿನ್ ಬಿಲ್ಡ್ ಮಾಡಿ

ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳಿಂದ ತನ್ನ ಕಮಾಂಡ್ ಅನ್ನು ಓದಿ ಫಲಿತಾಂಶವನ್ನು ಮುದ್ರಿಸುವ ಬೈನರಿಯನ್ನು ಯಾವುದೇ ಭಾಷೆಯಲ್ಲಿ ಬರೆಯಿರಿ. ನಂತರ ಅದನ್ನು ಬಾಟ್‌ನ ಬಳಕೆದಾರ ಪ್ಲಗಿನ್‌ಗಳ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ plugin.json ಪಕ್ಕದಲ್ಲಿ ಇಡಿ.

<data>/user/plugins/notes-sync/
├── plugin.json      # runtime manifest
├── notes-sync       # your binary, named after the slug
└── skills/          # optional: skills that teach employees to use it
    └── notes-sync/
        └── SKILL.md
{
  "id": "notes-sync",
  "slug": "notes-sync",
  "name": "Notes Sync",
  "version": "0.1.0",
  "description": "Search, read and create notes in Example Notes.",
  "platforms": {}
}

id, slug, name, version ಮತ್ತು platforms ಅಗತ್ಯ. ಬಳಕೆದಾರ ಪ್ಲಗಿನ್‌ಗಳ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ platforms ಮ್ಯಾಪ್ ಖಾಲಿಯಾಗಿರಬಹುದು: Nebo slug ಹೆಸರಿನ ಬೈನರಿಯನ್ನು plugin.json ಪಕ್ಕದಲ್ಲಿ, ನಂತರ target/release/ ಮತ್ತು target/debug/ ನಲ್ಲಿ ಹುಡುಕುತ್ತದೆ. ನೀವು ಪ್ರಕಟಿಸುವಾಗ, ನೀವು ಅಪ್‌ಲೋಡ್ ಮಾಡುವ ಪ್ರತಿ ಬೈನರಿಗೆ ಮಾರುಕಟ್ಟೆ platforms ಅನ್ನು ತುಂಬುತ್ತದೆ.

<data> ಎಂದರೆ macOS ನಲ್ಲಿ ~/Library/Application Support/Nebo, Windows ನಲ್ಲಿ %APPDATA%\Nebo, ಮತ್ತು Linux ನಲ್ಲಿ ~/.local/share/nebo, ಅಥವಾ NEBO_HOME ನ ಮೌಲ್ಯ. ಬಳಕೆದಾರ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿರುವ ಪ್ಲಗಿನ್ ಅದೇ slug ಇರುವ ಮಾರುಕಟ್ಟೆ ಪ್ಲಗಿನ್ ಅನ್ನು ಅತಿಕ್ರಮಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ಹೊಸ ಬಿಲ್ಡ್ ಪರೀಕ್ಷಿಸಲು ಅದೇ ಸರಿಯಾದ ಸ್ಥಳ.

ಅದನ್ನು ಬಳಸಲು ಉದ್ಯೋಗಿಗಳಿಗೆ ಕಲಿಸಿ

plugin.json ಪಕ್ಕದಲ್ಲಿ skills/ ಫೋಲ್ಡರ್ ಇಡಿ. ಅದರಲ್ಲಿರುವ ಪ್ರತಿ ಸ್ಕಿಲ್ ಪ್ಲಗಿನ್ ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿರುವವರೆಗೆ ಪ್ರತಿ ಉದ್ಯೋಗಿಗೆ ಲಭ್ಯವಿರುತ್ತದೆ, ಮತ್ತು ಪ್ಲಗಿನ್ ಅನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಅವಲಂಬನೆಯಾಗಿ ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ. ಯಾವ ಕಮಾಂಡ್‌ಗಳಿವೆ, ಅವು ಏನನ್ನು ಮರಳಿಸುತ್ತವೆ, ಮತ್ತು ಪ್ರತಿಯೊಂದನ್ನು ಯಾವಾಗ ಬಳಸಬೇಕು ಎಂದು ಹೇಳಲು ಸ್ಕಿಲ್ ಬಳಸಿ. ಪ್ಲಗಿನ್‌ನ ಟೂಲ್ ವಿವರಣೆ ಮೊದಲು ಅವುಗಳತ್ತ ತೋರಿಸುವಂತೆ ಅತ್ಯಂತ ಉಪಯುಕ್ತ ಸ್ಕಿಲ್‌ಗಳನ್ನು entrySkills ನಲ್ಲಿ ಹೆಸರಿಸಿ.

ಮಾರುಕಟ್ಟೆ ಪಟ್ಟಿ ಪ್ರತ್ಯೇಕ ಫೈಲ್, PLUGIN.md. Nebo ಅದನ್ನು ರನ್ ಸಮಯದಲ್ಲಿ ಓದುವುದಿಲ್ಲ; ಅದು ಜನರು ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡುವ ಮೊದಲು ನೋಡುವ ಪುಟ. ಪ್ಲಗಿನ್ ಬಿಡುಗಡೆ ಮಾಡುವುದು ನೋಡಿ.

ಎನ್ವಿರಾನ್‌ಮೆಂಟ್

ಪ್ರತಿ ಕರೆಯು ಲೋಡರ್ ಮತ್ತು ಶೆಲ್-ಇಂಜೆಕ್ಷನ್ ವೇರಿಯಬಲ್‌ಗಳನ್ನು ತೆಗೆದ ಬಾಟ್‌ನ ಎನ್ವಿರಾನ್‌ಮೆಂಟ್ ಅನ್ನು ಆನುವಂಶಿಕವಾಗಿ ಪಡೆಯುತ್ತದೆ, ನಂತರ ಈ ಮೌಲ್ಯಗಳನ್ನು ಸೇರಿಸುತ್ತದೆ. ನಂತರದ ನಮೂದುಗಳಿಗೆ ಆದ್ಯತೆ.

ವೇರಿಯಬಲ್ಮೌಲ್ಯ
auth.env ಕೀಗಳುಮ್ಯಾನಿಫೆಸ್ಟ್‌ನಿಂದ ಡೀಫಾಲ್ಟ್‌ಗಳು.
<SLUG>_BINಈ ಪ್ಲಗಿನ್‌ನ ಬೈನರಿಯ ಪಾತ್, ಮತ್ತು ಅದು ಅವಲಂಬಿಸಿರುವ ಪ್ರತಿ ಪ್ಲಗಿನ್‌ನ ಪಾತ್. slug ಅನ್ನು ದೊಡ್ಡಕ್ಷರಗಳಿಗೆ ಬದಲಿಸಿ ಹೈಫನ್‌ಗಳನ್ನು ಅಂಡರ್‌ಸ್ಕೋರ್‌ಗಳಾಗಿ ಮಾಡಲಾಗುತ್ತದೆ.
NEBO_DATA_DIRಪ್ಲಗಿನ್‌ನ ಸ್ವಂತ ಡೇಟಾ ಫೋಲ್ಡರ್, <data>/appdata/plugins/<slug>/. ಇದು ಕಾರ್ಯನಿರತ ಡೈರೆಕ್ಟರಿಯೂ ಹೌದು, ಮತ್ತು ಅನ್‌ಇನ್‌ಸ್ಟಾಲ್ ನಂತರವೂ ಉಳಿಯುತ್ತದೆ.
PATHಮೊದಲು ಪ್ಲಗಿನ್ ಫೋಲ್ಡರ್‌ಗಳು, ನಂತರ ಆನುವಂಶಿಕ ಪಾತ್.
ಸೆಟ್ಟಿಂಗ್‌ಗಳುconfigSchema ಫೀಲ್ಡ್‌ಗಳಿಗೆ ಮಾಲೀಕರು ಉಳಿಸಿದ ಮೌಲ್ಯಗಳು.
NEBO_AGENT_IDಕರೆ ಮಾಡುತ್ತಿರುವ ಉದ್ಯೋಗಿ.
profileDirEnvಪ್ಲಗಿನ್ ಖಾತೆಗಳನ್ನು ಬೆಂಬಲಿಸುವಾಗ, ಈ ಉದ್ಯೋಗಿ ಮತ್ತು ಖಾತೆಯ ಖಾತೆ ಫೋಲ್ಡರ್.

permissions.envAllow ಮತ್ತು permissions.envDeny ಬಾಟ್‌ನಿಂದ ಪ್ಲಗಿನ್ ಆನುವಂಶಿಕವಾಗಿ ಪಡೆಯುವುದನ್ನು ಸೀಮಿತಗೊಳಿಸುತ್ತವೆ. ಅವು ಪ್ಲಗಿನ್‌ನ ಸ್ವಂತ ದೃಢೀಕರಣ ವೇರಿಯಬಲ್‌ಗಳನ್ನು ಎಂದಿಗೂ ತೆಗೆದುಹಾಕುವುದಿಲ್ಲ.

ಖಾತೆಗಳು ಮತ್ತು ರುಜುವಾತುಗಳು

ಸೇವೆಗೆ ಸೈನ್ ಇನ್ ಮಾಡುವ ಪ್ಲಗಿನ್ ಪ್ರತಿ ಉದ್ಯೋಗಿಗೆ ಒಂದು ಖಾತೆ ಇಟ್ಟುಕೊಳ್ಳಬೇಕು. ಲೆಕ್ಕಪತ್ರ ನಿರ್ವಾಹಕರು ಹಣಕಾಸು ಲಾಗಿನ್‌ನಿಂದ ಮತ್ತು ಸಹಾಯಕರು ತಮ್ಮದೇ ಲಾಗಿನ್‌ನಿಂದ ಸೈನ್ ಇನ್ ಮಾಡುತ್ತಾರೆ, ಮತ್ತು ಯಾರೂ ಇನ್ನೊಬ್ಬರ ಟೋಕನ್‌ಗಳನ್ನು ನೋಡುವುದಿಲ್ಲ. ನೀವು ಇದನ್ನು ಮ್ಯಾನಿಫೆಸ್ಟ್‌ನಲ್ಲಿ ಘೋಷಿಸುತ್ತೀರಿ; ಉಳಿದದ್ದನ್ನು Nebo ಮಾಡುತ್ತದೆ.

"auth": {
  "type": "env",
  "label": "Example Notes account",
  "env": { "EXAMPLE_NOTES_TOKEN": "" },
  "commands": { "login": "auth login", "status": "auth status", "logout": "auth logout" },
  "profileDirEnv": "EXAMPLE_NOTES_CONFIG_DIR"
},
"capabilities": {
  "configSchema": [
    { "key": "EXAMPLE_NOTES_TOKEN", "label": "API token", "fieldType": "password", "secret": true, "required": true }
  ]
}
  1. auth.env ರುಜುವಾತುಗಳನ್ನು ಹೆಸರಿಸುತ್ತದೆ. capabilities.configSchema ಅವುಗಳಿಗೆ ಲೇಬಲ್ ನೀಡುತ್ತದೆ ಮತ್ತು ಸಂಪರ್ಕ ಫಾರ್ಮ್‌ನಲ್ಲಿ ಅವುಗಳ ಕ್ರಮವನ್ನು ಹೊಂದಿಸುತ್ತದೆ.
  2. auth.profileDirEnv ನಿಮ್ಮ ಪ್ಲಗಿನ್ ತನ್ನ ರುಜುವಾತು ಫೋಲ್ಡರ್‌ಗಾಗಿ ಓದುವ ವೇರಿಯಬಲ್ ಅನ್ನು ಹೆಸರಿಸುತ್ತದೆ. Nebo ಪ್ರತಿ ಉದ್ಯೋಗಿ ಮತ್ತು ಖಾತೆಗೆ ಒಂದು ಫೋಲ್ಡರ್ ರಚಿಸುತ್ತದೆ ಮತ್ತು ಪ್ರತಿ ಕರೆಯಲ್ಲೂ ಆ ವೇರಿಯಬಲ್ ಅನ್ನು ಹೊಂದಿಸುತ್ತದೆ.
  3. ಮಾಲೀಕರು ಖಾತೆಯನ್ನು ಸಂಪರ್ಕಿಸಿದಾಗ, Nebo ಮಾಲೀಕರು ಟೈಪ್ ಮಾಡಿದ ಮೌಲ್ಯಗಳು ಮತ್ತು ಖಾತೆ ಫೋಲ್ಡರ್ ಹೊಂದಿಸಿ ನಿಮ್ಮ login ಕಮಾಂಡ್ ಅನ್ನು ರನ್ ಮಾಡುತ್ತದೆ. ನಿಮ್ಮ ಪ್ಲಗಿನ್ ತನಗೆ ಬೇಕಾದ್ದನ್ನು ಆ ಫೋಲ್ಡರ್‌ನಲ್ಲಿ ಉಳಿಸುತ್ತದೆ. Nebo ಆ ಮೌಲ್ಯಗಳನ್ನು ಇಟ್ಟುಕೊಳ್ಳುವುದಿಲ್ಲ.
  4. ನಿಮ್ಮ status ಕಮಾಂಡ್ {"authenticated": true} ನಂತಹ JSON ಅನ್ನು ಮುದ್ರಿಸುತ್ತದೆ. ಟೋಕನ್ ಅವಧಿ ಮುಗಿದಾಗ, ನೀವು refresh ಘೋಷಿಸಿದ್ದರೆ Nebo ಅದನ್ನು ಚಲಾಯಿಸುತ್ತದೆ.

ಬ್ರೌಸರ್ ಸೈನ್ ಇನ್‌ಗಾಗಿ, type ಅನ್ನು oauth_cli ಎಂದು ಹೊಂದಿಸಿ ಮತ್ತು login ಪ್ರೊವೈಡರ್‌ನ ಸೈನ್ ಇನ್ URL ಅನ್ನು ಮುದ್ರಿಸುವಂತೆ ಅಥವಾ ತೆರೆಯುವಂತೆ ಮಾಡಿ. ಉದ್ಯೋಗಿಗಳು ಎಂದಿಗೂ ತಾವಾಗಿಯೇ ಸೈನ್ ಇನ್ ಮಾಡುವುದಿಲ್ಲ: ಕರೆಗೆ ಲಾಗಿನ್ ಬೇಕಾದಾಗ, ಮಾಲೀಕರು ಸಂಪರ್ಕ ಕಾರ್ಡ್ ನೋಡುತ್ತಾರೆ. ಹಲವು ಖಾತೆಗಳಿರುವ ಉದ್ಯೋಗಿ ಕಮಾಂಡ್‌ಗೆ --account <label> ಸೇರಿಸಿ ಒಂದನ್ನು ಆಯ್ಕೆಮಾಡುತ್ತಾರೆ. ನಿಮ್ಮ ಬೈನರಿ ನೋಡುವ ಮೊದಲೇ Nebo ಆ ಫ್ಲ್ಯಾಗ್ ಅನ್ನು ತೆಗೆದುಹಾಕುತ್ತದೆ.

ಸೇವೆಯ ಹೆಸರಿಡಿ, ಆಕಾರದ್ದಲ್ಲ. ಪ್ಲಗಿನ್‌ನ ಹೆಸರು ಅದು ಯಾವುದಕ್ಕೆ ಸಂಪರ್ಕಿಸುತ್ತದೆ ಎಂದು ಹೇಳುತ್ತದೆ, ಉದಾಹರಣೆಗೆ "Example Notes". ಪ್ಲಗಿನ್ ಹೆಸರಿನಲ್ಲಿ ಎಂದಿಗೂ "CLI" ಸೇರಿಸಬೇಡಿ; ಉದ್ಯೋಗಿಗಳು ಮತ್ತು ಮಾಲೀಕರಿಗೆ ಅದು ಸಂಪರ್ಕ, ಕಮಾಂಡ್ ಲೈನ್ ಅಲ್ಲ.

ಮುಂದೆ

  • plugin.json ಉಲ್ಲೇಖ: ಈವೆಂಟ್‌ಗಳು, ಹುಕ್‌ಗಳು ಮತ್ತು ಟೈಪ್ ಮಾಡಿದ ಕಾರ್ಯಾಚರಣೆಗಳು ಸೇರಿದಂತೆ ಪ್ರತಿ ಫೀಲ್ಡ್.
  • ಪ್ಲಗಿನ್ ಬಿಡುಗಡೆ ಮಾಡುವುದು: ಪ್ಲ್ಯಾಟ್‌ಫಾರ್ಮ್‌ಗಳು, ಬೈನರಿಗಳು, ಸಹಿ ಮತ್ತು ಅಪ್‌ಡೇಟ್‌ಗಳು.
  • ಪ್ರಕಟಣೆ: ಪ್ರತಿ ಆರ್ಟಿಫ್ಯಾಕ್ಟ್‌ಗಾಗಿ ಮಾರುಕಟ್ಟೆ ಪ್ರಕ್ರಿಯೆ.