NeboAI
NeboAI
Începe

Exemple

Fiecare exemplu de mai jos este complet și se încarcă așa cum este scris. Copiază unul, redenumește împreună folderul și câmpul name și schimbă instrucțiunile.

Instrucțiuni și un fișier de referință

Cea mai simplă abilitate utilă înseamnă instrucțiuni plus un fișier de referință pe care angajatul îl citește doar când are nevoie de el. Declanșatoarele adaugă cuvinte la intrarea abilității din lista angajatului, ceea ce îl ajută să recunoască cereri formulate în moduri diferite.

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

O abilitate care rulează un script

Folosește un script când munca cere răspunsuri exacte, de exemplu calcule sau conversii de fișiere. Angajatul îl rulează cu execute, transmițând argumente pe care scriptul le citește ca JSON din SKILL_ARGS. Tot ce afișează scriptul în stdout este rezultatul. Acest script folosește doar biblioteca standard 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,
}))

Un secret și acces la rețea

Scripturile nu au acces la rețea decât dacă abilitatea declară capabilitatea network, și atunci doar la registrele de pachete și la domeniile din metadata.allowed_domains. Un secret declarat în metadata.secrets ajunge ca variabilă de mediu numită după key. Pentru că secretul este obligatoriu, execute refuză să ruleze până când proprietarul îl setează.

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

O abilitate care folosește un plugin

Când o abilitate are nevoie de un anumit plugin, listează-l sub plugins. Dacă pluginul nu este instalat, abilitatea se încarcă totuși, marcată ca degradată, ca proprietarul să vadă ce lipsește. Preferă să scrii o abilitate în jurul capabilității și să lași angajatul să folosească orice conexiune are; declară un plugin doar când instrucțiunile chiar depind de el.

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

Mai departe