NeboAI
NeboAI
Aan de slag

Voorbeelden

Elk voorbeeld hieronder is compleet en laadt zoals het er staat. Kopieer er een, hernoem de map en het naamveld tegelijk, en pas de instructies aan.

Instructies en een naslagbestand

De eenvoudigste nuttige skill bestaat uit instructies plus één naslagbestand dat de medewerker alleen leest wanneer hij het nodig heeft. Triggers voegen woorden toe aan de vermelding van de skill in de lijst van de medewerker, zodat hij verzoeken herkent die op verschillende manieren zijn geformuleerd.

weekly-status/
├── SKILL.md
└── references/
    └── format.md
---
name: weekly-status
description: Write the weekly status update from the week's finished work, open items and risks. Use when someone asks for a weekly update, a status report or a Friday summary.
triggers: [status report, weekly update, friday summary]
---

# Weekly status

1. Collect what was finished this week, what is still open, and anything at risk.
2. Read references/format.md with read_skill_file and follow its layout exactly.
3. Keep each section to five bullets or fewer. Lead with outcomes, not activity.
4. End with the one decision you need from the reader, or write "No decisions needed."

Een skill die een script uitvoert

Gebruik een script als het werk exacte antwoorden vereist, zoals rekenwerk of bestandsconversie. De medewerker voert het uit met execute en geeft argumenten mee die het script als JSON uit SKILL_ARGS leest. Wat het script naar stdout afdrukt, is het resultaat. Dit script gebruikt alleen de standaardbibliotheek van Python.

invoice-totals/
├── SKILL.md
└── scripts/
    └── totals.py
---
name: invoice-totals
description: Add up invoice line items, apply a tax rate, and report the subtotal, tax and total. Use when someone asks to total, check or recalculate an invoice.
version: "1.0.0"
---

# Invoice totals

Never add numbers in your head. Run the script:

execute(skill: "invoice-totals", script: "scripts/totals.py",
        args: { "items": [{ "description": "...", "quantity": 2, "unit_price": 40.0 }], "tax_rate": 0.08 })

Report the subtotal, tax and total from the script's output, and list any line
item the script flagged.
import json
import os

args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
items = args.get("items", [])
rate = float(args.get("tax_rate", 0))

subtotal = 0.0
flagged = []
for item in items:
    qty = item.get("quantity", 0)
    price = item.get("unit_price", 0)
    if qty <= 0 or price < 0:
        flagged.append(item.get("description", "unnamed item"))
        continue
    subtotal += qty * price

tax = round(subtotal * rate, 2)
print(json.dumps({
    "subtotal": round(subtotal, 2),
    "tax": tax,
    "total": round(subtotal + tax, 2),
    "flagged": flagged,
}))

Een geheim en netwerktoegang

Scripts hebben geen netwerktoegang, tenzij de skill de capability network declareert, en dan alleen tot pakketregisters en de domeinen in metadata.allowed_domains. Een geheim dat in metadata.secrets is gedeclareerd, komt binnen als omgevingsvariabele met de naam uit de key. Omdat het geheim verplicht is, weigert execute te draaien tot de eigenaar het heeft ingesteld.

---
name: company-lookup
description: Look up a company's size, industry and headquarters from its web domain. Use when someone asks who a company is or wants a prospect researched.
version: "1.0.0"
capabilities: [network]
metadata:
  allowed_domains: [api.example.com]
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create a key at https://example.com/settings/keys
      required: true
---

# Company lookup

Run scripts/lookup.py with the domain:

execute(skill: "company-lookup", script: "scripts/lookup.py", args: { "domain": "example.com" })

If the script reports that the key is missing, ask the owner to add it with
configure_skill. Report only what the lookup returned; say so when a field is empty.
import json
import os
import urllib.request

domain = json.loads(os.environ.get("SKILL_ARGS", "{}")).get("domain", "")
req = urllib.request.Request(
    "https://api.example.com/v1/companies?domain=" + domain,
    headers={"Authorization": "Bearer " + os.environ["EXAMPLE_API_KEY"]},
)
with urllib.request.urlopen(req, timeout=20) as resp:
    print(resp.read().decode())

Een skill die een plugin gebruikt

Als een skill een specifieke plugin nodig heeft, zet je die onder plugins. Is de plugin niet geïnstalleerd, dan laadt de skill toch, gemarkeerd als beperkt, zodat de eigenaar kan zien wat er ontbreekt. Schrijf een skill bij voorkeur rond de capability en laat de medewerker de verbinding gebruiken die hij heeft; declareer alleen een plugin als de instructies er echt van afhangen.

---
name: month-end-close
description: Walk through the month-end close checklist, reconcile each account and list what still needs the owner. Use at month end or when someone asks to close the books.
version: "1.0.0"
plugins:
  - name: example-ledger
    version: ">=2.0.0"
---

# Month-end close

For each balance-sheet account, in chart-of-accounts order, read its balance and unreconciled transactions from the ledger, reconcile what
matches, and list what does not. Never lock a period yourself; ask the owner.

Volgende