# CopilotChatAssistantMessage

> Angular standalone component that renders a single assistant message with markdown content, tool calls, and a toolbar of copy, thumbs, read-aloud, and regenerate actions.

## Overview [#overview]

`CopilotChatAssistantMessage` renders one assistant message. It shows the message content through a markdown renderer, renders attached tool calls, and shows a toolbar with copy, thumbs up/down, read-aloud, and regenerate actions.

The toolbar appears only when the message has non-empty text content. Inside the toolbar:

- Copy: always renders.
- Thumbs up and thumbs down: render when you provide a custom slot for them, or when a thumbs handler is available from a surrounding [`CopilotChatView`](/reference/angular/components/CopilotChatView).
- Read aloud and regenerate: render only when you provide a custom slot for them.

By default, [`CopilotChatMessageView`](/reference/angular/components/CopilotChatMessageView) renders this component for every assistant message.

The component is standalone and uses `OnPush` change detection. Reactive inputs are Angular [signals](https://angular.dev/guide/signals).

## Usage [#usage]

Import the component class and use its `copilot-chat-assistant-message` selector. The `message` input is required.

```ts title="src/app/assistant.component.ts"
import { Component, signal } from "@angular/core";
import { CopilotChatAssistantMessage } from "@copilotkit/angular";
import type { AssistantMessage } from "@ag-ui/client";

@Component({
  selector: "app-assistant",
  standalone: true,
  imports: [CopilotChatAssistantMessage],
  template: `
    <copilot-chat-assistant-message [message]="message()" />
  `,
})
export class AssistantComponent {
  message = signal<AssistantMessage>({
    id: "1",
    role: "assistant",
    content: "Hello, how can I help?",
  });
}
```

## Inputs [#inputs]

<PropertyReference name="message" type="AssistantMessage" required>
  The assistant message to render. Its `content` is passed to the markdown renderer and its `toolCalls` drive the tool calls view.
</PropertyReference>

<PropertyReference name="messages" type="Message[]" default="[]">
  The surrounding message list. Forwarded to the tool calls view so a tool render can read prior context.
</PropertyReference>

<PropertyReference name="agentId" type="string">
  ID of the agent that produced the message. Forwarded to the tool calls view for resolving the matching tool renderer.
</PropertyReference>

<PropertyReference name="isLoading" type="boolean" default="false">
  Whether the agent is currently streaming. Forwarded to the tool calls view.
</PropertyReference>

<PropertyReference name="toolbarVisible" type="boolean" default="true">
  Whether the toolbar may be shown. Even when `true`, the toolbar only renders if the message has non-empty text content.
</PropertyReference>

<PropertyReference name="additionalToolbarItems" type="TemplateRef<any>">
  A template appended to the end of the default toolbar, after the built-in buttons.
</PropertyReference>

### Slot class inputs [#slot-class-inputs]

The current release applies `markdownRendererClass`, `toolbarClass`, and `copyButtonClass` to their default parts.

<PropertyReference name="markdownRendererClass" type="string">
  Classes for the default markdown renderer.
</PropertyReference>

<PropertyReference name="toolbarClass" type="string">
  Classes for the default toolbar.
</PropertyReference>

<PropertyReference name="copyButtonClass" type="string">
  Classes for the default copy button.
</PropertyReference>

<Callout type="warn">
  `inputClass`, the thumbs, read-aloud, regenerate class inputs, and `toolCallsViewClass` are declared but do not affect rendering in the current release. Use component or template overrides for those parts.
</Callout>

### Slot component inputs [#slot-component-inputs]

Each of these replaces the corresponding default sub-component with a component class of your own. Content-projection templates (see below) take precedence over these.

<PropertyReference name="markdownRendererComponent" type="Type<any>">
  Replaces the default markdown renderer.
</PropertyReference>

<PropertyReference name="toolbarComponent" type="Type<any>">
  Replaces the default toolbar.
</PropertyReference>

<PropertyReference name="copyButtonComponent" type="Type<any>">
  Replaces the default copy button.
</PropertyReference>

<PropertyReference name="thumbsUpButtonComponent" type="Type<any>">
  Replaces the default thumbs-up button.
</PropertyReference>

<PropertyReference name="thumbsDownButtonComponent" type="Type<any>">
  Replaces the default thumbs-down button.
</PropertyReference>

<PropertyReference name="readAloudButtonComponent" type="Type<any>">
  Replaces the default read-aloud button.
</PropertyReference>

<PropertyReference name="regenerateButtonComponent" type="Type<any>">
  Replaces the default regenerate button.
</PropertyReference>

<PropertyReference name="toolCallsViewComponent" type="Type<any>">
  Replaces the default tool calls view.
</PropertyReference>

## Outputs [#outputs]

<PropertyReference name="thumbsUp" type="CopilotChatAssistantMessageOnThumbsUpProps">
  Emitted when a configured thumbs-up component or template is clicked. The payload is `{ message: AssistantMessage }`.
</PropertyReference>

<PropertyReference name="thumbsDown" type="CopilotChatAssistantMessageOnThumbsDownProps">
  Emitted when a configured thumbs-down component or template is clicked. The payload is `{ message: AssistantMessage }`.
</PropertyReference>

<PropertyReference name="readAloud" type="CopilotChatAssistantMessageOnReadAloudProps">
  Emitted when a configured read-aloud component or template is clicked. The payload is `{ message: AssistantMessage }`.
</PropertyReference>

<PropertyReference name="regenerate" type="CopilotChatAssistantMessageOnRegenerateProps">
  Emitted when a configured regenerate component or template is clicked. The payload is `{ message: AssistantMessage }`.
</PropertyReference>

## Slots and content projection [#slots-and-content-projection]

You can override any piece of the message by projecting a named template. A projected template takes precedence over the matching `*Component` input. Each template receives a typed context object.

| Template name | Context type | Replaces |
| --- | --- | --- |
| `markdownRenderer` | `AssistantMessageMarkdownRendererContext` (`{ content: string }`) | The markdown content renderer |
| `toolbar` | `AssistantMessageToolbarContext` (`{ children?: any }`) | The whole toolbar |
| `copyButton` | `AssistantMessageCopyButtonContext` (`{ content?: string }`) | The copy button |
| `thumbsUpButton` | `ThumbsUpButtonContext` (empty; click via outputs) | The thumbs-up button |
| `thumbsDownButton` | `ThumbsDownButtonContext` (empty; click via outputs) | The thumbs-down button |
| `readAloudButton` | `ReadAloudButtonContext` (empty; click via outputs) | The read-aloud button |
| `regenerateButton` | `RegenerateButtonContext` (empty; click via outputs) | The regenerate button |
| `toolCallsView` | `any` | The tool calls view |

```html title="src/app/assistant.component.html"
<copilot-chat-assistant-message [message]="message()">
  <ng-template #markdownRenderer let-content="content">
    <article class="my-markdown">{{ content }}</article>
  </ng-template>
</copilot-chat-assistant-message>
```
