Agent reports on the docs
When a docs page turns out wrong, outdated or missing what was needed, an AI agent sends us a short report. We verify every report by running it and fix the page.
What a report holds: the page address, a short quote from it and a description of the problem — what the page says and what actually happened. Your code, data, secrets, file paths and project names never go into a report.
The agent asks you before sending. It shows the finished report at the end of its reply and asks: "Send this report to Layero?" It sends only if you say yes. If you already allowed such reports earlier in the conversation, it sends the next one without asking again.
For AI agents
When to report
Report when a docs.layero.ru page (or search_docs) was wrong, outdated, or
missing something you needed — including when you then found the answer
somewhere else (the CLI's source code, --help, trial and error) — and it
cost you a real detour likely to hit the next agent too. Do not report small
hiccups you solved at once, or problems in the user's own code.
Finish the user's task first, or stop where the problem blocks it.
Ask the user first
End your final reply with the report (template below) and ask the user: "Send this report to Layero?" Send it only after they say yes. If they have already allowed docs reports earlier in this conversation, send the next one without asking again. One report per problem.
What a report contains
Plain text, at most 1000 characters in total:
Page: https://docs.layero.ru/cli/install#login
Quote: "Печатает URL https://app.layero.ru/cli?code=…"
Problem: what the page says vs. what actually happened
Evidence: the command you ran and what it returned
Workaround: what worked instead, or "none"
Effect: what it cost — failed commands, extra searches, minutes
- Page — the page URL with an anchor if the problem is in one section;
noneif no page covered what you needed. - Quote — the shortest exact span that shows the problem; if no page
covered it —
Search: <what you searched for>. - Evidence — the command or call you ran and its output. We verify every report by running it, so this field matters most.
Never include the user's code, data, secrets, tokens, file paths, project names or anything from their environment beyond the command and its output.
How to send it (after the user says yes)
-
MCP. Call
report_docs_issueon the Layero MCP server (https://mcp.layero.ru/mcp). No sign-in is needed. -
HTTP, when you have no MCP:
curl -sS https://api.layero.ru/public/docs-feedback \-H 'content-type: application/json' \-d '{"page":"https://docs.layero.ru/cli/install#login","quote":"…","problem":"…","evidence":"…","workaround":"none","effect":"…","source":"http"}'202with{"ok": true, "id": "…", "status": "queued"}means the report is stored; delivery to our team is retried on our side.400names the field to fix,429means the hourly limit (10 reports) is reached. -
If neither works, show the report to the user at the end of your reply and tell them it can be sent later with the command above.
If the user says no, or told you not to send reports, don't.
After a report is accepted, confirm it to the user in one line.