NeboAI
NeboAI
Zacznij

Dokumentacja agent.json

agent.json zawiera wszystko o pracowniku, co nie jest prozą: wymagane funkcje, pytania do właściciela, sposób przechowywania pamięci, operacje, które zawsze wymagają zatwierdzenia, oraz przepływy pracy, które uruchamia. Każde pole jest opcjonalne.

Przykład

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

Pola

PoleTypZnaczenie
requires.interfaceslista ciągów znakówFunkcje potrzebne roli, takie jak mail czy ledger. Przyznawane przy zatrudnieniu; każda operacja wymagająca zatwierdzenia nadal pozostaje pozycją do zatwierdzenia. Zobacz Funkcje i zatwierdzenia.
requires.pluginslista ciągów znakówWtyczki instalowane razem z pracownikiem. Używaj tylko wtedy, gdy rola naprawdę zależy od jednej wtyczki; lepiej wskazać funkcję.
requires.toolslista ciągów znakówNarzędzia ładowane do sesji pracownika od pierwszej tury. Nigdy nie pomija to zatwierdzania.
skillslista ciągów znakówUmiejętności ze sklepu do zainstalowania i używania: @org/skills/name, opcjonalnie z @version, albo kod SKIL-. Umiejętności z własnego folderu skills/ pakietu nie wymagają wpisu.
inputslistPytania, na które właściciel odpowiada przy zatrudnieniu. Zobacz Dane wejściowe.
memoryobjectJak przechowywane są rozmowy i pamięć. Zobacz Persona i pamięć.
subscribeslista ciągów znakówObszary faktów firmowych, które pracownik odczytuje ponownie, gdy się zmienią, np. finance.ar.*.
ceilingmapOperacja → "approval". Ta operacja zawsze wymaga zgody właściciela dla tego pracownika. Żadna inna wartość nie jest akceptowana.
workflowsmapNazwa przepływu pracy → przepływ pracy. Zobacz Przepływy pracy.
toolslistNarzędzia HTTP serwowane przez sidecar aplikacji. Zobacz Narzędzia sidecar.
scopesmapNazwane grupy tools, skills i plugins. Wtyczki (plugins) danego zakresu są opisywane pracownikowi, gdy ten zakres jest aktywny.

Dane wejściowe

Pole wejściowe to pytanie, na które właściciel odpowiada przy zatrudnianiu. Odpowiedzi są widoczne dla pracownika w sekcji „Configured Inputs” i wypełniają symbole zastępcze {{key}} w wyzwalaczach obserwowania i folderów.

{
  "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"
}
PoleDomyślnieZnaczenie
keywymaganeNazwa używana w symbolach zastępczych. name jest akceptowane jako zamiennik.
labelz keyPytanie wyświetlane właścicielowi.
typetexttext, textarea, number, select, checkbox lub radio.
requiredfalseOznacza pytanie, na które właściciel musi odpowiedzieć.
defaultbrakWstępnie wypełniona odpowiedź. Niedozwolona przy pytaniu o kwotę.
placeholder, descriptionbrakTekst pomocy.
optionsbrakDla select i radio: obiekty {value, label} lub zwykłe ciągi znaków.
idbrakStała nazwa faktu z kropkami, np. finance.ap.invoice_mailbox, aby inni pracownicy mogli z niego korzystać.
scopecompanycompany: wspólny fakt firmowy. seat: tylko to zatrudnienie.
missingbrakCo pracownik robi, dopóki pytanie nie ma odpowiedzi.
moneyfalseOznacza kwotę pieniędzy. Pytanie o kwotę nie może mieć wartości domyślnej.

Narzędzia sidecar

Aplikacja z sidecarem udostępnia swojemu pracownikowi punkty końcowe HTTP jako narzędzia. Nebo rejestruje każdy wpis jako app__<app>__<name> i wysyła wywołania do sidecara pod method i path. Zobacz Sidecar aplikacji.

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

Przepływy pracy

Każdy klucz w workflows nazywa jeden przepływ pracy; nazwa jest jego identyfikatorem. Pełny format opisują strony Przepływy pracy, Wyzwalacze i Aktywności.