NeboAI
NeboAI
Mulakan

Contoh

Setiap contoh di bawah adalah lengkap dan dimuatkan seperti yang ditulis. Salin satu, namakan semula folder dan medan nama bersama-sama, dan ubah arahannya.

Arahan dan fail rujukan

Kemahiran berguna yang paling ringkas ialah arahan serta satu fail rujukan yang dibaca oleh pekerja hanya apabila ia memerlukannya. Pencetus menambah perkataan pada entri kemahiran dalam senarai pekerja, yang membantunya memadankan permintaan yang diungkapkan dengan cara berbeza.

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

Kemahiran yang menjalankan skrip

Gunakan skrip apabila kerja memerlukan jawapan yang tepat, seperti aritmetik atau penukaran fail. Pekerja menjalankannya dengan execute, menghantar argumen yang dibaca oleh skrip sebagai JSON daripada SKILL_ARGS. Apa sahaja yang dicetak oleh skrip ke stdout ialah hasilnya. Skrip ini hanya menggunakan pustaka 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,
}))

Rahsia dan akses rangkaian

Skrip tidak mempunyai akses rangkaian kecuali kemahiran mengisytiharkan keupayaan network, dan itu pun hanya kepada pendaftaran pakej dan domain dalam metadata.allowed_domains. Rahsia yang diisytiharkan dalam metadata.secrets tiba sebagai pemboleh ubah persekitaran yang dinamakan oleh key-nya. Oleh kerana rahsia itu wajib, execute enggan berjalan sehingga pemilik menetapkannya.

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

Kemahiran yang menggunakan plugin

Apabila kemahiran memerlukan plugin tertentu, senaraikannya di bawah plugins. Jika plugin tidak dipasang, kemahiran masih dimuatkan, ditandakan sebagai terdegradasi, supaya pemilik dapat melihat apa yang tiada. Lebih baik tulis kemahiran berdasarkan keupayaan dan biarkan pekerja menggunakan apa jua sambungan yang ada padanya; isytiharkan plugin hanya apabila arahan benar-benar bergantung padanya.

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

Seterusnya