NeboAI
NeboAI
شروع کنید

بسته‌های کارمند

بسته کارمند نقشی را توصیف می‌کند که یک شرکت می‌تواند استخدام کند: کارمند مسئول چه چیزهایی است، چطور کار می‌کند، به چه نوع سیستم‌هایی نیاز دارد و چه کارهایی را خودش انجام می‌دهد. آن را به‌صورت پوشه‌ای با یک AGENT.md می‌نویسید و، وقتی نقش به چیزی بیش از چت نیاز دارد، یک agent.json.

بسته

support-coordinator/
├── AGENT.md        # required: who the employee is and how it works
├── agent.json      # optional: capabilities, inputs, workflows, memory
└── skills/         # optional: skills only this employee uses
    └── reply-drafting/
        └── SKILL.md
فایلالزامیهدف
AGENT.mdبلهشخصیت: کارمند کیست، چطور کار می‌کند و قوانینش چیست. شخصیت و حافظه را ببینید.
agent.jsonخیرتوانایی‌هایی که لازم دارد، پرسش‌هایی برای مالک، گردش‌کارها، تنظیمات حافظه و سقف‌های تأیید. مرجع agent.json را ببینید.
skills/خیرمهارت‌ها در قالب استاندارد SKILL.md. فقط همین کارمند آن‌ها را می‌بیند.
manifest.jsonفقط برنامه‌هاهویت با "type": "app". فروشگاه هنگام بسته‌بندی یک کارمند، manifest خودش را می‌نویسد.
ui/فقط برنامه‌هاصفحه برنامه. برنامه‌ها را ببینید.

نوشتن بسته

با شخصیت شروع کنید. frontmatter نام کارمند را می‌آورد و یک توضیح یک‌خطی می‌دهد؛ بدنه دستورالعمل‌هایی به نثر ساده است.

---
name: Support Coordinator
description: Answers every customer message the day it arrives and escalates what it cannot settle.
---

# Support Coordinator

You answer customer email for the company. Reply within the configured window,
in the company's voice, and keep every thread moving until the customer has an answer.

## How you work
- Read the whole thread before you reply.
- Use the reply-drafting skill for every customer reply.
- When a message is about money, draft a proposal for the owner instead of promising anything.

## Rules
- Never promise a refund, a discount or a date you cannot confirm.

وقتی نقش به یک سیستم، یک تنظیم از طرف مالک، یا کاری که بدون درخواست انجام می‌دهد نیاز دارد، agent.json را اضافه کنید. این نمونه به توانایی mail نیاز دارد، هنگام استخدام یک سؤال می‌پرسد و به هر پیام تازه به‌محض رسیدن پاسخ می‌دهد.

{
  "requires": { "interfaces": ["mail"] },
  "inputs": [
    {
      "key": "reply_window_hours",
      "label": "Reply within (hours)",
      "type": "number",
      "id": "support.reply_window_hours",
      "scope": "company",
      "default": 24
    }
  ],
  "workflows": {
    "new-mail": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "description": "Handle each customer message as it arrives.",
      "activities": [
        {
          "id": "reply",
          "intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
        }
      ]
    }
  }
}

watch نام توانایی mail را می‌آورد، نه یک محصول را. در زمان اجرا به افزونه‌ای تبدیل می‌شود که مالک برای ایمیل وصل کرده است. برای محرک‌ها و فعالیت‌ها گردش‌کارها را ببینید.

بارگذاری روی یک بات

پوشه را در <data>/user/agents/<name>/ بگذارید. Nebo فایل‌های AGENT.md، agent.json و manifest.json را زیر نظر دارد و حدود یک ثانیه پس از هر تغییر کارمند را دوباره بارگذاری می‌کند. حذف پوشه کارمند را غیرفعال می‌کند اما سابقه‌اش را نگه می‌دارد.

Nebo کارمندان را از سه منبع بارگذاری می‌کند و منبع‌های بعدی اولویت دارند: کارمندان داخلی Nebo، بسته‌های مهروموم‌شده فروشگاه در <data>/nebo/agents/ و پوشه‌های <data>/user/agents/. یک کارمند هم می‌تواند با ابزارهای create_employee و update_employee خود برایتان بسته بسازد یا تغییر دهد، که همان پوشه را می‌نویسند.

هنگام استخدام چه اتفاقی می‌افتد

وقتی مالکی کارمند شما را از فروشگاه یا با کد AGNT- استخدام می‌کند، Nebo:

  1. نیازهای بسته را بدون پرسیدن از مدل می‌خواند: هر توانایی در requires.interfaces، هر افزونه در requires.plugins و هر توانایی یا افزونه‌ای که یک محرک watch نام می‌برد.
  2. برای این نیازها یک جمله رضایت به مالک نشان می‌دهد و هنگام استخدام، آن‌ها را به‌صورت مجوزهای دائمی به این کارمند می‌دهد. عملیاتی که به تأیید نیاز دارند همان‌طور باقی می‌مانند. توانایی‌ها و تأییدها را ببینید.
  3. وابستگی‌ها را نصب می‌کند: افزونه‌های requires.plugins، مهارت‌های فروشگاهی که در skills و فعالیت‌ها نام برده شده‌اند، و وابستگی‌هایی که هنگام انتشار بسته اعلام شده‌اند.
  4. پرسش‌های inputs را از مالک می‌پرسد و از طریق صندوق ورودی درباره هر توانایی‌ای که هنوز اتصالی ندارد به او اطلاع می‌دهد.

گردش‌کاری که توانایی‌اش اتصالی ندارد نگه داشته می‌شود و همراه با دلیل، به‌عنوان افت‌کرده علامت می‌خورد. به‌محض اینکه مالک سیستمی را وصل کند، شروع به کار می‌کند.

Nebo چه چیزهایی را بررسی می‌کند

Nebo فایل agent.json را با سهل‌گیری می‌خواند. کلیدهای ناشناخته نادیده گرفته می‌شوند. گردش‌کاری که با طرح‌واره جور نباشد کنار گذاشته می‌شود و مالک در صندوق ورودی اطلاعیه‌ای می‌گیرد که اجرا نخواهد شد؛ بقیه کارمند همچنان بارگذاری می‌شود. این مشکلات کل فایل را رد می‌کنند:

  • یک محرک event با فهرست sources خالی.
  • دو فعالیت با id یکسان در یک گردش‌کار.
  • ورودی‌ای با scope غیر از company یا seat، یا یک پرسش مالی با مقدار پیش‌فرض.
  • مقدار ceiling غیر از "approval".
  • درخت تماس تلفنی‌ای که دقیقاً یک خوشامدگویی و دست‌کم یک قصد نام‌دار نداشته باشد.

برخی بررسی‌ها هنگام شروع گردش‌کار انجام می‌شوند نه هنگام بارگذاری، مثل پارامترهایی که هر نوع فعالیت لازم دارد. فعالیت‌ها را ببینید.

مسئولیت‌ها را بنویسید، نه ابزارها را. بسته کارمند توانایی‌هایی مثل ledger یا mail را نام می‌برد و هرگز یک محصول، شرکت یا صنعت مشخص را نه. مالک تعیین می‌کند کدام سیستم هر توانایی را پر کند، پس یک بسته به کار همه شرکت‌هایی می‌آید که استخدامش می‌کنند.

بعدی