ask_user

Wenn ein Agent eine Entscheidung von dir braucht, fragt er mit einer Rückfrage-Karte: die Frage, ein Button pro Auswahl und Platz für eine Antwort als freier Text. Du antwortest mit einem Tippen, von jedem Gerät aus, und der Agent macht mit deiner Antwort weiter.

Hinter der Karte steht ein Tool, das der Agent aufruft. Welches, hängt vom Provider ab: Manche bringen ein eigenes Frage-Tool mit, das OAR in eine Karte verwandelt; für die anderen stellt OAR eines namens ask_user bereit. Es ist das einzige Agent-Tool, bei dem sich die Provider in mehr als dem Namen unterscheiden.

Was du siehst #

• Eine Karte in der Konversation mit der Frage und ihren Auswahlmöglichkeiten. Eine Auswahl antwortet mit einem Klick.
• Eine Frage, die mehrere Antworten erlaubt, zeigt Häkchen und einen Button Reply with selection (Mit Auswahl antworten). Die Antwort listet jede angehakte Auswahl auf, dazu alles, was du getippt hast.
• Eine Anfrage nach mehreren Werten auf einmal erscheint als Formular mit je einem Feld.
• Eine Push-Benachrichtigung, wenn du sie für Fragen eingeschaltet hast.
• Der Turn wartet, solange die Karte offen ist. Ein Turn, der auf eine Karte wartet, wird nie als hängend behandelt.

Nach Provider #

Grok hat keine Rückfrage-Karten. Sein Agent-Protokoll bietet keinen Weg, den Benutzer zu fragen, daher kann ein Grok-Agent nur im Text seiner Antwort fragen und auf deine nächste Nachricht warten.

Auf der SDK-Engine von Copilot hat jede Karte mit zwei oder mehr Auswahlmöglichkeiten auch einen Schalter Select several (Mehrere auswählen), sodass du mehr als eine Antwort geben kannst, auch wenn der Agent nicht danach gefragt hat.

Wie lange eine Karte wartet #

Eine Karte wartet 8 Stunden auf eine Antwort, auf der Extension-Engine von Copilot 2 Stunden. Danach erfährt der Agent, dass niemand geantwortet hat, und macht gemäß dem Relay-Modus der Konversation weiter.

Was Agents gesagt bekommen #

• Über das Frage-Tool zu fragen, nie als einfacher Text in einer Antwort. Eine Frage als einfacher Text zeigt keine Buttons und beendet den Turn.
• Eine kurze Liste von Auswahlmöglichkeiten anzugeben und sie nur wegzulassen, wenn die Antwort freier Text sein muss.
• Auch im autopilot (Relay-Modus) zu fragen, wenn deine Eingabe wirklich nötig ist.

Parameter #

ask_user von OAR auf der SDK-Engine von Copilot #

{
  "question": "Which database should the new service use?",
  "choices": ["PostgreSQL", "SQLite", "Keep the current one"]
}

Der Agent bekommt User selected: PostgreSQL zurück, oder User responded: … für eine Antwort als freier Text.

ask_user von OAR auf Cursor #

{
  "questions": [
    {
      "header": "Database",
      "question": "Which database should the new service use?",
      "options": [
        { "label": "PostgreSQL", "description": "What the other services use" },
        { "label": "SQLite", "description": "No server to run" }
      ]
    }
  ]
}

Du kannst immer als freier Text antworten, statt eine Option zu wählen. Der Agent bekommt jede Frage mit ihrer Antwort zurück.

Die eigenen Tools der Provider #

Claudes AskUserQuestion (auch von DeepSeek-Chats genutzt, die Claude Code ausführen) und Copilots eingebautes ask_user gehören diesen Providern; ihre Parameter legen diese fest, und sie können sich mit einem Update des Providers ändern. OAR nimmt die Frage so, wie der Provider sie übergibt, zeigt die Karte und gibt deine Antwort in der Form zurück, die der Provider erwartet.

Fragen aus anderen Sessions #

Eine Rückfrage-Karte kann auch ein anderer Agent beantworten, wenn du Agents mit anderen Sessions arbeiten lässt: mit answer_question aus relay_tool. Agents sollen dich zuerst fragen, es sei denn, du hast ihnen gesagt, sie sollen selbst entscheiden. Die eigenen Freigabekarten eines Relays (für das Starten von Sessions, für das Beobachten und die Freigaben in ask und plan) kannst nur du beantworten.