NeboAI
NeboAI
はじめる

例

以下の例はどれも完全で、書かれたとおりに読み込まれます。1つをコピーし、フォルダ名とnameフィールドを一緒に変更して、指示を書き換えてください。

指示と参考ファイル

最もシンプルで役に立つスキルは、指示と、社員が必要なときにだけ読む参考ファイル1つです。トリガーは、社員の一覧にあるスキルの項目に言葉を加え、さまざまな言い方の依頼に一致しやすくします。

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でスクリプトを実行し、引数を渡します。スクリプトはその引数をSKILL_ARGSからJSONとして読み取ります。スクリプトが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.

次へ