Skip to content

docs: Document Agent questions behavior#160

Merged
coolcom200 merged 7 commits into
mainfrom
oz-agent/APP-4629-ask-user-question-docs
Jun 9, 2026
Merged

docs: Document Agent questions behavior#160
coolcom200 merged 7 commits into
mainfrom
oz-agent/APP-4629-ask-user-question-docs

Conversation

@seemeroland

Copy link
Copy Markdown
Contributor

Summary

Adds public documentation for Warp Agent questions, including the AskUserQuestion / ask_user_question behavior requested in APP-4629.

Changes

  • Added a new Agent questions page under Interacting with agents.
  • Documented answering, skipping, Other responses, auto-approve behavior, and Agent Profile permission settings.
  • Added navigation and overview links to make the page discoverable.
  • Updated Profiles & permissions with the Ask questions permission values.

Validation

  • git --no-pager diff --check
  • python3 .agents/skills/style_lint/style_lint.py --changed (changed-file detection returned no files)
  • python3 .agents/skills/style_lint/style_lint.py --all (repo has existing style findings; no build-blocking errors)
  • npm run build

Related

Co-Authored-By: Oz oz-agent@warp.dev

Conversation: https://staging.warp.dev/conversation/8e5ac8b4-fee0-4742-af40-e7a9b45b430f
Run: https://oz.staging.warp.dev/runs/019e758d-18aa-7817-8620-f78e5eaa669c
This PR was generated with Oz.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label May 29, 2026
@vercel

vercel Bot commented May 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 9, 2026 10:31pm

Request Review

Note that options can be selected with number keys and that the left and right arrow keys move between questions on a multi-question card.

Co-Authored-By: Oz <oz-agent@warp.dev>
@coolcom200 coolcom200 requested a review from hongyi-chen June 9, 2026 19:33
@coolcom200 coolcom200 marked this pull request as ready for review June 9, 2026 19:33
@oz-for-oss

oz-for-oss Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

@coolcom200

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@oz-for-oss oz-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR adds a new Agent questions page, links it into local-agent navigation, and documents the Ask questions Agent Profile permission. The structure and links are generally aligned with the docs section, and no security or spec-drift findings apply.

Concerns

  • The new page currently guarantees that a skipped question will not be asked again, but the client implementation only returns a skipped answer to the Agent and does not enforce de-duplication of future questions.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

…agents/agent-questions.mdx

Co-authored-by: oz-for-oss[bot] <277970191+oz-for-oss[bot]@users.noreply.github.com>
Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>

@rachaelrenk rachaelrenk left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙏

@coolcom200 coolcom200 merged commit 32ad99e into main Jun 9, 2026
6 of 7 checks passed
@coolcom200 coolcom200 deleted the oz-agent/APP-4629-ask-user-question-docs branch June 9, 2026 22:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed from-feedback-bot PR originated from Feedback Bot delegated Linear issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants