NeboAI
NeboAI
شروع کنید

نمونه‌ها

هر نمونه زیر کامل است و همان‌طور که نوشته شده بارگذاری می‌شود. یکی را کپی کنید، نام پوشه و فیلد name را با هم تغییر دهید و دستورالعمل‌ها را عوض کنید.

دستورالعمل‌ها و یک فایل مرجع

ساده‌ترین مهارت مفید، دستورالعمل‌ها به‌علاوه یک فایل مرجع است که کارمند فقط وقتی لازم دارد می‌خواند. تریگرها واژه‌هایی به ورودی مهارت در فهرست کارمند اضافه می‌کنند که به او کمک می‌کند درخواست‌هایی را که به شکل‌های مختلف بیان شده‌اند تطبیق دهد.

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

مهارتی که اسکریپت اجرا می‌کند

وقتی کار به پاسخ‌های دقیق نیاز دارد، مانند حساب یا تبدیل فایل، از اسکریپت استفاده کنید. کارمند آن را با execute اجرا می‌کند و آرگومان‌هایی می‌فرستد که اسکریپت آن‌ها را به‌صورت JSON از SKILL_ARGS می‌خواند. هر چه اسکریپت در stdout چاپ کند نتیجه است. این اسکریپت فقط از کتابخانه استاندارد 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,
}))

یک راز و دسترسی به شبکه

اسکریپت‌ها به شبکه دسترسی ندارند مگر اینکه مهارت قابلیت network را اعلام کند، و آن هم فقط به مخازن بسته‌ها و دامنه‌های موجود در metadata.allowed_domains. رازی که در metadata.secrets اعلام شده به‌صورت یک متغیر محیطی با نامی که key آن تعیین می‌کند می‌رسد. چون این راز الزامی است، execute تا وقتی مالک آن را تنظیم نکند از اجرا خودداری می‌کند.

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

مهارتی که از یک افزونه استفاده می‌کند

وقتی مهارتی به افزونه خاصی نیاز دارد، آن را زیر plugins فهرست کنید. اگر افزونه نصب نباشد، مهارت همچنان بارگذاری می‌شود و به‌عنوان ناقص علامت می‌خورد تا مالک ببیند چه چیزی کم است. بهتر است مهارت را حول قابلیت بنویسید و بگذارید کارمند از هر اتصالی که دارد استفاده کند؛ فقط وقتی دستورالعمل‌ها واقعاً به یک افزونه وابسته‌اند آن را اعلام کنید.

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

بعدی