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로 스크립트를 실행하며, 스크립트는 전달된 인수를 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.

다음 단계