• AI reference · Area edits

absorb_feedback

Absorb feedback. Mark chosen notes as learned, once the lesson is in the company's guidance.

Where it is

In the edits area (edits, looks, formats, music, scores and the owner's notes on media): open it with tools_for { area: "edits" }, then call it with use_tool { name: "absorb_feedback", args }.

Does it need a yes?

Runs at once, no yes card: it changes only the office's own working state, and nothing reaches anyone. Here: marks notes used, only after the skill fix was proposed.

Inputs

InputTypeNeededAbout
itemsarray of objectyes1 to 50 items
items[].idstringyesformat `^[a-f0-9]{64}$`
items[].expectedRevisionstringnoup to 200 characters
actorstringyes1 to 120 characters
summarystringyes1 to 8,000 characters
evidencearray of objectyes1 to 10 items
evidence[].pathstringyes1 to 300 characters
evidence[].versionintegeryes1 or more
requestIdstringyesformat `^[A-Za-z0-9_.:@-]{6,100}$`
run_idstringnoYour run id from the connector's start, so the output ties back to this session · format `^[A-Za-z0-9_.:@-]{1,120}$`

Example

{
  "name": "absorb_feedback",
  "arguments": {
    "items": [
      {
        "id": "id"
      }
    ],
    "actor": "actor",
    "summary": "Ana has her quote.",
    "evidence": [
      {
        "path": "notes/plan.md",
        "version": 1
      }
    ],
    "requestId": "requestId"
  }
}

When it is refused

  • invalid: The input isn't right. The sentence names the field and the fix; nothing was done. Fix it and call again.
  • not_found: No such thing in this company (a task, file, person, record). Check the number or name, or list first.
  • not_allowed: Not without another step: the owner's yes, your own task held with pick_up, or a setting the owner turns on. The sentence says which.
  • taken: Someone else holds it (another AI on that task). Pick another task.
  • stale: It changed since you read it. Read it again and use the new version.
  • failed: On our side or a service's, never your input. Try again in a minute; if it keeps failing, call report_problem.