NeboAI
NeboAI
Anza

Marejeleo ya agent.json

agent.json hushikilia kila kitu kuhusu mfanyakazi ambacho si maandishi ya kawaida: uwezo anaohitaji, maswali anayomuuliza mmiliki, jinsi kumbukumbu yake inavyohifadhiwa, shughuli zipi daima zinahitaji idhini, na mitiririko ya kazi anayoiendesha. Kila sehemu ni ya hiari.

Mfano

{
  "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." }
      ]
    }
  }
}

Sehemu

SehemuAinaMaana
requires.interfacesorodha ya stringsUwezo ambao nafasi inahitaji, kama vile mail au ledger. Hutolewa wakati wa kuajiri; kila shughuli inayohitaji idhini hubaki kuwa kipengee cha idhini. Tazama Uwezo na Idhini.
requires.pluginsorodha ya stringsProgramu-jalizi zinazosakinishwa pamoja na mfanyakazi. Tumia tu nafasi inapotegemea kweli programu-jalizi moja; pendelea uwezo.
requires.toolsorodha ya stringsZana zinazopakiwa kwenye kipindi cha mfanyakazi tangu zamu yake ya kwanza. Hii kamwe haipiti idhini.
skillsorodha ya stringsUjuzi wa soko wa kusakinisha na kutumia: @org/skills/name, kwa hiari @version, au msimbo wa SKIL-. Ujuzi ulio katika folda ya skills/ ya kifurushi chenyewe hauhitaji kuingizwa.
inputslistMaswali ambayo mmiliki hujibu wakati wa kuajiri. Tazama Maingizo.
memoryobjectJinsi mazungumzo na kumbukumbu vinavyohifadhiwa. Tazama Haiba na Kumbukumbu.
subscribesorodha ya stringsMaeneo ya taarifa za kampuni ambayo mfanyakazi huyasoma tena yanapobadilika, kama vile finance.ar.*.
ceilingmapShughuli kwa "approval". Shughuli hiyo daima humuuliza mmiliki kwa mfanyakazi huyu. Hakuna thamani nyingine inayokubaliwa.
workflowsmapJina la mtiririko wa kazi kwa mtiririko wa kazi. Tazama Mitiririko ya kazi.
toolslistZana za HTTP zinazotolewa na sidecar ya programu. Tazama Zana za sidecar.
scopesmapMakundi yenye majina ya tools, skills na plugins. plugins za scope huelezwa kwa mfanyakazi scope hiyo inapokuwa hai.

Maingizo

Ingizo ni swali ambalo mmiliki hujibu wakati wa kuajiri. Majibu yanaonekana kwa mfanyakazi chini ya "Configured Inputs" na kujaza nafasi za {{key}} katika vichochezi vya ufuatiliaji na vya folda.

{
  "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"
}
SehemuChaguo-msingiMaana
keyinahitajikaJina linalotumika katika placeholders. name inakubaliwa kama mbadala.
labelkutoka keySwali linaloonyeshwa kwa mmiliki.
typetexttext, textarea, number, select, checkbox au radio.
requiredfalseHuweka alama kwamba swali ni lazima lijibiwe na mmiliki.
defaulthakunaJibu lililojazwa mapema. Haliruhusiwi kwa swali la pesa.
placeholder, descriptionhakunaMaandishi ya msaada.
optionshakunaKwa select na radio: vitu vya {value, label} au strings za kawaida.
idhakunaJina thabiti lenye nukta kwa taarifa hiyo, kama vile finance.ap.invoice_mailbox, ili wafanyakazi wengine waweze kuishiriki.
scopecompanycompany: taarifa ya kampuni inayoshirikiwa. seat: kwa mwajiriwa huyu pekee.
missinghakunaKile mfanyakazi anachofanya wakati swali bado halijajibiwa.
moneyfalseHuweka alama kwenye kiasi cha pesa. Swali la pesa haliwezi kuwa na chaguo-msingi.

Zana za sidecar

Programu yenye sidecar hufichua endpoints za HTTP kwa mfanyakazi wake kama zana. Nebo husajili kila kipengee kama app__<app>__<name> na hutuma maombi kwa sidecar kwenye method na path. Tazama Sidecar ya Programu.

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

Mitiririko ya kazi

Kila ufunguo chini ya workflows hutaja mtiririko mmoja wa kazi; jina ndilo kitambulisho chake. Muundo kamili uko kwenye Mitiririko ya kazi, Vichochezi na Shughuli.