NeboAI
NeboAI
শুরু করুন

agent.json রেফারেন্স

agent.json-এ থাকে একজন কর্মীর গদ্য ছাড়া বাকি সবকিছু: তার দরকারি সক্ষমতা, মালিককে জিজ্ঞেস করা প্রশ্ন, তার স্মৃতি কীভাবে রাখা হয়, কোন কাজে সবসময় অনুমোদন লাগে, এবং সে কোন ওয়ার্কফ্লো চালায়। প্রতিটি ফিল্ড ঐচ্ছিক।

উদাহরণ

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

ফিল্ড

ফিল্ডধরনঅর্থ
requires.interfacesস্ট্রিংয়ের তালিকাভূমিকাটির দরকারি সক্ষমতা, যেমন mail বা ledger। নিয়োগের সময় দেওয়া হয়; অনুমোদন-নির্ভর প্রতিটি কাজ অনুমোদনের আইটেম হিসেবেই থাকে। সক্ষমতা ও অনুমোদন দেখুন।
requires.pluginsস্ট্রিংয়ের তালিকাকর্মীর সাথে ইনস্টল হওয়া প্লাগইন। শুধু তখনই ব্যবহার করুন, যখন ভূমিকাটি সত্যিই একটি প্লাগইনের ওপর নির্ভর করে; সক্ষমতাকেই অগ্রাধিকার দিন।
requires.toolsস্ট্রিংয়ের তালিকাপ্রথম পালা থেকেই কর্মীর সেশনে লোড হওয়া টুল। এটি কখনও অনুমোদন এড়িয়ে যায় না।
skillsস্ট্রিংয়ের তালিকাইনস্টল ও ব্যবহারের জন্য মার্কেটপ্লেস দক্ষতা: @org/skills/name, চাইলে @version-সহ, অথবা একটি SKIL- কোড। প্যাকেজের নিজস্ব skills/ ফোল্ডারের দক্ষতার জন্য কোনো এন্ট্রি লাগে না।
inputslistনিয়োগের সময় মালিক যে প্রশ্নগুলোর উত্তর দেন। ইনপুট দেখুন।
memoryobjectকথোপকথন ও স্মৃতি কীভাবে রাখা হয়। পারসোনা ও স্মৃতি দেখুন।
subscribesস্ট্রিংয়ের তালিকাপ্রতিষ্ঠানের তথ্যের যে ক্ষেত্রগুলো বদলালে কর্মী আবার পড়ে, যেমন finance.ar.*।
ceilingmapকাজ থেকে "approval"। সেই কাজটি এই কর্মীর জন্য সবসময় মালিককে জিজ্ঞেস করে। অন্য কোনো মান গ্রহণ করা হয় না।
workflowsmapওয়ার্কফ্লোর নাম থেকে ওয়ার্কফ্লো। ওয়ার্কফ্লো দেখুন।
toolslistএকটি অ্যাপের সাইডকারের দেওয়া HTTP টুল। সাইডকার টুল দেখুন।
scopesmaptools, skills ও plugins-এর নামযুক্ত গুচ্ছ। একটি স্কোপ সক্রিয় থাকলে তার plugins কর্মীকে বর্ণনা করে জানানো হয়।

ইনপুট

ইনপুট হলো এমন একটি প্রশ্ন, যার উত্তর মালিক নিয়োগের সময় দেন। উত্তরগুলো কর্মীর কাছে "Configured Inputs"-এর অধীনে দেখা যায় এবং watch ও folder ট্রিগারে {{key}} প্লেসহোল্ডার পূরণ করে।

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
ফিল্ডডিফল্টঅর্থ
keyআবশ্যকপ্লেসহোল্ডারে ব্যবহৃত নাম। বিকল্প হিসেবে name গ্রহণ করা হয়।
labelkey থেকেমালিককে দেখানো প্রশ্ন।
typetexttext, textarea, number, select, checkbox অথবা radio।
requiredfalseপ্রশ্নটিকে এমন হিসেবে চিহ্নিত করে, যার উত্তর মালিককে দিতেই হবে।
defaultনেইআগে থেকে পূরণ করা উত্তর। টাকার প্রশ্নে অনুমোদিত নয়।
placeholder, descriptionনেইসহায়ক টেক্সট।
optionsনেইselect ও radio-র জন্য: {value, label} অবজেক্ট বা সাধারণ স্ট্রিং।
idনেইতথ্যটির একটি স্থির, ডট দেওয়া নাম, যেমন finance.ap.invoice_mailbox, যাতে অন্য কর্মীরা এটি শেয়ার করতে পারে।
scopecompanycompany: প্রতিষ্ঠানের একটি শেয়ার করা তথ্য। seat: শুধু এই নিয়োগের জন্য।
missingনেইপ্রশ্নের উত্তর না পাওয়া পর্যন্ত কর্মী কী করে।
moneyfalseটাকার পরিমাণ চিহ্নিত করে। টাকার প্রশ্নের কোনো ডিফল্ট থাকতে পারে না।

সাইডকার টুল

সাইডকারসহ একটি অ্যাপ তার কর্মীর কাছে HTTP এন্ডপয়েন্টগুলো টুল হিসেবে উন্মুক্ত করে। Nebo প্রতিটি এন্ট্রি app__<app>__<name> হিসেবে রেজিস্টার করে এবং কলগুলো method ও path-এ সাইডকারে পাঠায়। অ্যাপ সাইডকার দেখুন।

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

ওয়ার্কফ্লো

workflows-এর নিচের প্রতিটি কী একটি ওয়ার্কফ্লোর নাম দেয়; নামটিই তার শনাক্তকারী। পূর্ণ ফরম্যাট আছে ওয়ার্কফ্লো, ট্রিগার ও অ্যাক্টিভিটি পাতায়।