Katalog
Každý provozní moment, který tento repozitář drží, zúžený kterýmkoli z fasetů, které hlásí sám katalog, s publikem, oblastmi, odvozenými filtry a počty. Výchozí je veřejný katalog; předejte status=any pro koncepty také.
- query
- behaviorally_verified
- vyžaduje se měření výkonu
- cache procesu (max_entries=32)
- Nástroj MCP majordomus_why
- zdroj MCP {"name": "why", "uri": "majordomus://why"}
- $ why list
Parametry dotazu
| název | typ | povinné | popis | příklady |
|---|---|---|---|---|
| publikum | string | ne | Jen okamžiky, které toto publikum pozná. | by-audience: "agency" |
| oblast | string | ne | Pouze okamžiky v této provozní oblasti. | |
| štítek | string | ne | Pouze momenty s touto značkou. | |
| závažnost | string | ne | Jen okamžiky této závažnosti. | |
| četnost | string | ne | Jen okamžiky této frekvence. | |
| životní cyklus | string | ne | Pouze momenty v této fázi práce. | |
| schopnost | string | ne | Jen okamžiky jmenující tuto schopnost exekutoru. | |
| command | string | ne | Jen okamžiky, které jmenují tento příkaz. | |
| zvýrazněné | boolean | ne | Pouze okamžiky, které úvodní stránka uvádí. | |
| status | string | ne | Jen okamžiky s tímto stavem. Bez hodnoty se myslí veřejné (`stable`); `any` předá vše, co katalog obsahuje. | |
| q | string | ne | Text bez ohledu na velikost písmen, párovaný proti identitě, titulkům, háčku, shrnutí, štítkům, aliasům, signálům, příkladům a tělu. | hledání: "context" |
Vyzkoušejte
Port je ten, který server zalogoval; 8741 je ten, o který žádá jako první. Hodnoty jsou první příklad operace.
curl -s "http://127.0.0.1:8741/api/v1/why?audience=agency&q=context"
Testováno v apps/majordomus-cli/tests/http_serve.rs, který přehrává routu s těmito hodnotami proti serveru na skutečném socketu.
Odpovědi
| status | tělo | význam |
|---|---|---|
| 200 | CatalogueView | Katalog: výsledek. |
| 400 | ErrorBody | invalid_input: Vstup neodpovídá schématu: parametr špatného typu, neznámý parametr nebo hodnota, kterou schopnost odmítne. |
| 404 | ErrorBody | not_found: Vstup pojmenovává něco, co repozitář nemá. |
| 500 | ErrorBody | internal: Schopnost selhala z vlastního důvodu; zpráva ho pojmenovává. |
| výchozí | ErrorBody | Jakékoli jiné selhání, které transport hlásí: 405 method_not_allowed pro jinou metodu na této cestě, 400 invalid_input pro tělo, které není objektem JSON. |