# Agent Read-Only Context

> Send application-owned values to the agent with connectAgentContext or CopilotKitAgentContext.

Use agent context when the application owns a value and the agent only reads
it. For values that the agent and application both change, use
[Shared State](/angular/shared-state).

## Send read-only application context [#send-read-only-application-context]

Use `connectAgentContext` for values such as the signed-in user's name,
selected record, timezone, or current screen. Pass an accessor so signal reads
stay reactive.

```ts title="src/app/account-context.component.ts"
import { Component, signal } from "@angular/core";
import { connectAgentContext } from "@copilotkit/angular";

@Component({
  selector: "app-account-context",
  template: `
    <button type="button" (click)="timezone.set('Europe/London')">
      Use London time
    </button>
  `,
})
export class AccountContextComponent {
  readonly userName = signal("Ada");
  readonly timezone = signal("America/Los_Angeles");

  constructor() {
    connectAgentContext(() => ({
      description: "Current account and timezone",
      value: JSON.stringify({
        userName: this.userName(),
        timezone: this.timezone(),
      }),
    }));
  }
}
```

The internal effect removes the old context and registers the new value when a
read signal changes. It removes the final registration when the owning
injector is destroyed. If you already have an `Injector`, pass it as
`{ injector }`; that injector takes precedence over the ambient one.

## Bind context in a template [#bind-context-in-a-template]

Use `CopilotKitAgentContext` when the context is already shaped in the
template.

```ts title="src/app/selection-context.component.ts"
import { Component, computed, signal } from "@angular/core";
import { CopilotKitAgentContext } from "@copilotkit/angular";

@Component({
  selector: "app-selection-context",
  imports: [CopilotKitAgentContext],
  template: `
    <div [copilotkitAgentContext]="selectionContext()"></div>
  `,
})
export class SelectionContextComponent {
  readonly selectedId = signal("record-42");
  readonly selectionContext = computed(() => ({
    description: "The record selected in the application",
    value: this.selectedId(),
  }));
}
```

Render the directive only after you have a complete context. If it starts
without one, later input changes do not create the first registration.

## Next steps [#next-steps]

- [connectAgentContext API](/reference/angular/functions/connectAgentContext)
- [CopilotKitAgentContext API](/reference/angular/directives/CopilotKitAgentContext)
- [Shared State](/angular/shared-state)
