Plugins och färdigheter

Plugins

Vad är plugins?

Plugins är TypeScript-moduler som utökar Neotasks funktionalitet under körningstid. De kan lägga till nya meddelandekanaler, agentverktyg, RPC-metoder, CLI-kommandon, bakgrundstjänster och färdigheter.

Officiella plugins

Meddelandekanaler:

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

Funktioner:

• Röstsamtal, SIP-telefonistöd för inkommande/utgående röstsamtal
• Minne (LanceDB), Långtidsminne med vektorsimilaritetssökning
• MCP Native, Model Context Protocol-serverintegration för att brygga externa verktyg

Autentiseringsleverantörer:

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

Plug-in-kapaciteter

Plugins kan registrera:

• RPC-metoder, Anpassade WebSocket-metoder för klienter att anropa
• HTTP-hanterare, Anpassade HTTP-slutpunkter på Gateway
• Agentverktyg, Nya verktyg med typade scheman som agenter kan anropa
• CLI-kommandon, Ytterligare kommandoradskommandon
• Bakgrundstjänster, Långlivade processer hanterade av Gateway
• Färdigheter, Färdighetskataloger som medföljer plug-inet
• Autosvarkommandon, Kommandon som körs utan AI-agentinblandning

Plug-insäkerhet

Neotask kontrollerar plugins i flera steg innan de körs:

• Signerade och verifierade. Paket i den publika Construct-katalogen publiceras av Neotask, granskas automatiskt före release och signeras med Neotasks releasenyckel. Innan Neotask installerar ett paket kontrolleras signaturen mot nycklar som är inbyggda i Neotask och nedladdningens SHA-256-hash verifieras.
• Inga installationsskript. Construct-paket levereras med sina beroenden, så installationen kör aldrig någon pakethanterare eller något installationsskript. När en annan plugininstallation använder npm är installationsskript avstängda.
• Skanning vid installation. Plugins som installeras utanför Construct skannas efter farlig kod, och kritiska fynd stoppar installationen.
• Licens per release. Ett Construct-plugin laddas bara så länge ditt konto har en giltig behörighet för just den releasen. Återkallade releaser laddas inte.
• Godkännanden för agentåtgärder. Agenters verktygsanrop, även verktyg som plugins lägger till, kontrolleras mot din godkännandepolicy, och åtgärder som kräver ditt godkännande väntar på det. Programvara som en agent vill installera utanför Neotasks medföljande installationsrecept visar alltid det exakta kommandot och väntar på ditt godkännande.
• Valfri sandlåda. Du kan köra en agents verktyg i en isolerad Docker-container i stället för direkt på din dator. Sandlådan är avstängd som standard; se Säkerhet för hur du slår på den.

Inbyggda plugins körs i Gateway-processen, så ett plugin som du installerar utanför Construct är kod som du väljer att köra. Använd plugins.allow för att ange vilka plugins som får laddas.

Färdigheter

Vad är färdigheter?

Färdigheter är modulära kapaciteter som lär agenter nya arbetsflöden. Varje färdighet är en markdown-fil (SKILL.md) med instruktioner som injiceras i agentens kontext när de är relevanta.

Färdighetsplatser (prioritetsordning)

1. Arbetsytefärdigheter, <workspace>/skills/ (högsta prioritet)
2. Hanterade färdigheter, ~/.neotask/skills/
3. Medföljande färdigheter, Levereras med Neotask
4. Plug-in-färdigheter, Färdigheter paketerade med installerade plugins
5. Extra kataloger, Ytterligare konfigurerade sökvägar (lägsta prioritet)

När flera färdigheter delar samma namn vinner platsen med högst prioritet.

Färdighetsfunktioner

• Användaranropbar, Utlös färdigheter direkt med snedstreckskommandon (t.ex. /docker-build)
• Modellanropbar, Färdigheter som agenten kan anropa på egen hand när de är relevanta
• Kommandodirigering, Färdigheter som mappas till specifika verktyg
• Kravgrindning, Färdigheter laddas bara när deras krav är uppfyllda (nödvändiga binärer, konfigurationsnycklar, miljövariabler, plugins)

Skapa färdigheter

Skapa en SKILL.md-fil med YAML frontmatter som definierar färdighetens metadata och instruktioner:

Frontmatter-fält:

• name, Färdighetsidentifierare
• description, Vad färdigheten gör
• homepage, Länk till dokumentation
• user-invocable, Om användare kan utlösa den direkt
• disable-model-invocation, Förhindra agenten från att anropa den autonomt
• command-dispatch, Verktyg att dirigera till
• metadata.neotask.requires, Förutsättningar (bins, config, env, plugins)

Innehåll: Markdown-instruktioner som lär agenten hur man använder färdigheten, inklusive exempel och riktlinjer.

Färdighetskatalog

Bläddra bland tillgängliga färdigheter i färdighetskatalogen.

Färdighetskategorier

Färdigheter täcker ett brett spektrum av kapaciteter: