NeboAI
NeboAI
Kom igång

Exempel

Varje exempel nedan är komplett och laddas som det står. Kopiera ett, byt namn på mappen och fältet name samtidigt, och ändra instruktionerna.

Instruktioner och en referensfil

Den enklaste användbara färdigheten är instruktioner plus en referensfil som medarbetaren läser bara när den behöver den. Utlösare lägger till ord i färdighetens post i medarbetarens lista, vilket hjälper den att matcha förfrågningar som formuleras på olika sätt.

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."

En färdighet som kör ett skript

Använd ett skript när arbetet kräver exakta svar, till exempel räkneoperationer eller filkonvertering. Medarbetaren kör det med execute och skickar argument som skriptet läser som JSON från SKILL_ARGS. Det skriptet skriver till stdout är resultatet. Det här skriptet använder bara Pythons standardbibliotek.

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,
}))

En hemlighet och nätverksåtkomst

Skript har ingen nätverksåtkomst om inte färdigheten anger förmågan network, och då bara till paketregister och domänerna i metadata.allowed_domains. En hemlighet som anges i metadata.secrets kommer fram som en miljövariabel med det namn som dess key anger. Eftersom hemligheten är obligatorisk vägrar execute att köra tills ägaren har angett den.

---
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())

En färdighet som använder ett plugin

När en färdighet behöver ett visst plugin listar du det under plugins. Om pluginet inte är installerat laddas färdigheten ändå, markerad som nedsatt, så att ägaren kan se vad som saknas. Skriv hellre en färdighet kring förmågan och låt medarbetaren använda den anslutning den har; ange ett plugin bara när instruktionerna verkligen är beroende av det.

---
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.

Nästa steg