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បញ្ជីខ្សែអក្សរPlugin ដែលដំឡើងជាមួយបុគ្គលិក។ ប្រើតែនៅពេលតួនាទីពិតជាពឹងផ្អែកលើ Plugin មួយប៉ុណ្ណោះ ចូលចិត្តប្រើសមត្ថភាពជាង។
requires.toolsបញ្ជីខ្សែអក្សរឧបករណ៍ដែលផ្ទុកចូលវគ្គរបស់បុគ្គលិក តាំងពីវេនដំបូងរបស់វា។ វាមិនដែលរំលងការយល់ព្រមទេ។
skillsបញ្ជីខ្សែអក្សរជំនាញទីផ្សារដែលត្រូវដំឡើង និងប្រើ៖ @org/skills/name ជាជម្រើស @version ឬកូដ SKIL-។ ជំនាញនៅក្នុងថត skills/ ផ្ទាល់របស់កញ្ចប់ មិនត្រូវការធាតុទេ។
inputslistសំណួរដែលម្ចាស់ឆ្លើយនៅពេលជួល។ មើល ទិន្នន័យបញ្ចូល។
memoryobjectរបៀបដែលការសន្ទនា និងការចងចាំត្រូវបានរក្សា។ មើល បុគ្គលិកលក្ខណៈ និងការចងចាំ។
subscribesបញ្ជីខ្សែអក្សរផ្នែកនៃការពិតរបស់ក្រុមហ៊ុន ដែលបុគ្គលិកអានឡើងវិញនៅពេលពួកវាផ្លាស់ប្ដូរ ដូចជា finance.ar.*។
ceilingmapប្រតិបត្តិការទៅ "approval"។ ប្រតិបត្តិការនោះតែងតែសួរម្ចាស់សម្រាប់បុគ្គលិកនេះ។ មិនទទួលយកតម្លៃផ្សេងទៀតទេ។
workflowsmapឈ្មោះលំហូរការងារទៅលំហូរការងារ។ មើល លំហូរការងារ។
toolslistឧបករណ៍ HTTP ដែលផ្ដល់ដោយ sidecar របស់កម្មវិធី។ មើល ឧបករណ៍ Sidecar។
scopesmapក្រុមដែលមានឈ្មោះនៃ tools, skills និង plugins។ plugins របស់វិសាលភាពមួយ ត្រូវបានពិពណ៌នាដល់បុគ្គលិក នៅពេលវិសាលភាពនោះសកម្ម។

ទិន្នន័យបញ្ចូល

ការបញ្ចូល (input) គឺជាសំណួរដែលម្ចាស់ឆ្លើយនៅពេលជួល។ ចម្លើយលេចឡើងដល់បុគ្គលិកនៅក្រោម "Configured Inputs" ហើយបំពេញកន្លែងដាក់ {{key}} នៅក្នុងកត្តាចាប់ផ្ដើម watch និង folder។

{
  "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ត្រូវការឈ្មោះដែលប្រើក្នុង placeholders។ name ត្រូវបានទទួលយកជាជម្រើសបម្រុង។
labelពី keyសំណួរដែលបង្ហាញដល់ម្ចាស់។
typetexttext, textarea, number, select, checkbox ឬ radio។
requiredfalseសម្គាល់សំណួរថាជាសំណួរដែលម្ចាស់ត្រូវតែឆ្លើយ។
defaultគ្មានចម្លើយដែលបំពេញជាមុន។ មិនអនុញ្ញាតលើសំណួរអំពីប្រាក់ទេ។
placeholder, descriptionគ្មានអត្ថបទជំនួយ។
optionsគ្មានសម្រាប់ select និង radio៖ វត្ថុ {value, label} ឬខ្សែអក្សរធម្មតា។
idគ្មានឈ្មោះថេរដែលមានសញ្ញាចុចសម្រាប់ការពិត ដូចជា finance.ap.invoice_mailbox ដើម្បីឱ្យបុគ្គលិកផ្សេងទៀតអាចចែករំលែកវាបាន។
scopecompanycompany៖ ការពិតរួមរបស់ក្រុមហ៊ុន។ seat៖ សម្រាប់តែការជួលនេះប៉ុណ្ណោះ។
missingគ្មានអ្វីដែលបុគ្គលិកធ្វើ ខណៈពេលដែលសំណួរមិនទាន់មានចម្លើយ។
moneyfalseសម្គាល់ចំនួនប្រាក់។ សំណួរអំពីប្រាក់មិនអាចមានតម្លៃលំនាំដើមទេ។

ឧបករណ៍ Sidecar

កម្មវិធីដែលមាន sidecar បង្ហាញ HTTP endpoints ដល់បុគ្គលិករបស់វាជាឧបករណ៍។ Nebo ចុះឈ្មោះធាតុនីមួយៗជា app__<app>__<name> ហើយផ្ញើការហៅទៅ sidecar នៅ method និង path។ មើល App Sidecar។

"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 ដាក់ឈ្មោះលំហូរការងារមួយ ឈ្មោះគឺជាឧបករណ៍សម្គាល់របស់វា។ ទម្រង់ពេញលេញមាននៅលើ លំហូរការងារ កត្តាចាប់ផ្ដើម និង សកម្មភាព។