Plugins en vaardigheden

Plugins

Wat zijn plugins?

Plugins zijn TypeScript-modules die de functionaliteit van Neotask uitbreiden tijdens de uitvoering. Ze kunnen nieuwe berichtenkanalen, agenttools, RPC-methoden, CLI-opdrachten, achtergrondservices en vaardigheden toevoegen.

Officiële plugins

Berichtenkanalen:

• Microsoft Teams, Matrix, Nostr, Zalo, Feishu/Lark, LINE, Nextcloud Talk, Mattermost, Tlon, Twitch

Functies:

• Spraakoproep, SIP-telefonie voor inkomende/uitgaande spraakoproepen
• Geheugen (LanceDB), Langetermijngeheugen met vectorgelijkenis-zoeken
• MCP Native, Model Context Protocol-serverintegratie voor het overbruggen van externe tools

Authenticatieproviders:

• Google Antigravity OAuth, Gemini CLI OAuth, Qwen OAuth, Minimax OAuth, VS Code Copilot Proxy

Pluginmogelijkheden

Plugins kunnen registreren:

• RPC-methoden, Aangepaste WebSocket-methoden voor clients om aan te roepen
• HTTP-handlers, Aangepaste HTTP-eindpunten op de Gateway
• Agenttools, Nieuwe tools met getypte schema's die agents kunnen aanroepen
• CLI-opdrachten, Aanvullende opdrachtregelopdrachten
• Achtergrondservices, Langlopende processen beheerd door de Gateway
• Vaardigheden, Vaardighedenmappen gebundeld met de plugin
• Auto-antwoordopdrachten, Opdrachten die worden uitgevoerd zonder betrokkenheid van AI-agent

Pluginbeveiliging

Neotask controleert plugins in meerdere lagen voordat ze draaien:

• Ondertekend en geverifieerd. Pakketten in de openbare Construct-catalogus worden door Neotask gepubliceerd, vóór release automatisch gecontroleerd en ondertekend met de releasesleutel van Neotask. Voordat Neotask er een installeert, controleert het de handtekening met sleutels die in Neotask zijn ingebouwd en verifieert het de SHA-256-hash van de download.
• Geen installatiescripts. Construct-pakketten bevatten hun afhankelijkheden al, dus bij installatie draait er nooit een pakketbeheerder of installatiescript. Als een andere plugininstallatie npm gebruikt, staan installatiescripts uit.
• Gescand bij installatie. Plugins die van buiten Construct worden geïnstalleerd, worden gescand op gevaarlijke code, en kritieke bevindingen blokkeren de installatie.
• Licentie per release. Een Construct-plugin laadt alleen zolang uw account een geldige toestemming voor die release heeft. Ingetrokken releases laden niet.
• Goedkeuringen voor agentacties. Toolaanroepen van agents, inclusief tools die plugins toevoegen, worden getoetst aan uw goedkeuringsbeleid, en acties die uw akkoord nodig hebben wachten daarop. Software die een agent wil installeren buiten de meegeleverde installatierecepten van Neotask toont u altijd de exacte opdracht en wacht op uw goedkeuring.
• Optionele sandbox. U kunt de tools van een agent in een geïsoleerde Docker-container uitvoeren in plaats van rechtstreeks op uw computer. Sandboxing staat standaard uit; zie Beveiliging om het in te schakelen.

Native plugins draaien binnen het Gateway-proces, dus een plugin die u van buiten Construct installeert, is code die u zelf kiest uit te voeren. Gebruik plugins.allow om aan te geven welke plugins mogen laden.

Vaardigheden

Wat zijn vaardigheden?

Vaardigheden zijn modulaire mogelijkheden die agents nieuwe workflows leren. Elke vaardigheid is een markdownbestand (SKILL.md) met instructies die worden ingespoten in de context van de agent wanneer relevant.

Vaardigheidslocaties (prioriteitsvolgorde)

1. Werkruimtevaardigheden, <workspace>/skills/ (hoogste prioriteit)
2. Beheerde vaardigheden, ~/.neotask/skills/
3. Meegeleverde vaardigheden, Meegeleverd met Neotask
4. Pluginvaardigheden, Vaardigheden verpakt met geïnstalleerde plugins
5. Extra mappen, Aanvullend geconfigureerde paden (laagste prioriteit)

Wanneer meerdere vaardigheden dezelfde naam delen, wint de locatie met de hoogste prioriteit.

Vaardighedenfuncties

• Gebruiker-oproepbaar, Vaardigheden direct activeren met schuine-streep-opdrachten (bijv. /docker-build)
• Model-oproepbaar, Vaardigheden die de agent zelf kan aanroepen wanneer relevant
• Opdrachtverzending, Vaardigheden die worden toegewezen aan specifieke tools
• Vereistenbeveiliging, Vaardigheden worden alleen geladen wanneer hun vereisten zijn vervuld (vereiste binaries, configuratiesleutels, omgevingsvariabelen, plugins)

Vaardigheden aanmaken

Maak een SKILL.md-bestand met YAML-frontmatter die de metadata en instructies van de vaardigheid definieert:

Frontmatter-velden:

• name, Vaardigheidsidentificator
• description, Wat de vaardigheid doet
• homepage, Link naar documentatie
• user-invocable, Of gebruikers het direct kunnen activeren
• disable-model-invocation, Voorkomen dat de agent het autonoom aanroept
• command-dispatch, Tool om naar te verzenden
• metadata.neotask.requires, Vereisten (bins, config, env, plugins)

Hoofdtekst: Markdown-instructies die de agent leren hoe de vaardigheid te gebruiken, inclusief voorbeelden en richtlijnen.

Vaardighedencatalogus

Bekijk de beschikbare vaardigheden in de vaardighedencatalogus.

Vaardighedencategorieën

Vaardigheden dekken een breed scala aan mogelijkheden: