# Recommendation

Agent proposal with rationale, explained confidence, evidence, alternatives, and explicit accept or reject actions.

Use Recommendation for a proposal that needs a decision. Explain the evidence or criterion behind confidence. Keep evidence and alternatives as divided rows. Place confidence beside the actions. Set `actionable` only when accept and reject are valid. Use `pendingAction` to identify the pending decision. The deprecated `busy` prop represents only a pending accept action.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `acceptLabel` | `string` | prop | Yes | - | No additional description. |
| `announcement` | `string` | prop | No | `undefined` | Message for the owned live region. |
| `busy` | `boolean` | prop | No | `false` | Deprecated compatibility prop for a pending accept action. Use `pendingAction`. |
| `disabled` | `boolean` | prop | No | `false` | No additional description. |
| `headingLevel` | `1 \| 2 \| 3 \| 4 \| 5 \| 6` | prop | No | `2` | Heading level for the title. Nested headings use the next level, capped at 6. |
| `onAccept` | `(recommendationId: string) => void` | callback | Yes | - | No additional description. |
| `onReject` | `(recommendationId: string) => void` | callback | Yes | - | No additional description. |
| `pendingAction` | `RecommendationPendingAction` | prop | No | `undefined` | Identifies the action that is waiting for a consumer-owned result. |
| `recommendation` | `RecommendationData` | prop | Yes | - | No additional description. |
| `rejectLabel` | `string` | prop | Yes | - | No additional description. |

## Related

- [ActivityStatus](/docs/components/activity-status): Compact agent activity status with elapsed time, task progress, and one live announcement.
- [AgentTrace](/docs/components/agent-trace): Controlled disclosure of observable stages, searches, tools, files, and checks.
- [AgentResponse](/docs/components/agent-response): Assistant result with consumer-rendered content, streaming state, sources, actions, and follow-up prompts.