Trigger Angie with a prompt

1. Programmatic trigger

The most common pattern: your UI calls triggerAngie with a prompt string.

• Summarize page
• Pre-publish review
• Better CTA

await sdk.waitForReady();
await sdk.triggerAngie({
  prompt: 'Help me improve the headline…',
  options: { newChat: false },
});

2. Hash deep link

Share a URL with #angie-prompt=… in the hash. Use an in-page link on the same screen, or open in a new tab when linking from emails, docs, or another page. Add &angie-new-chat=true to start a fresh chat.

loadSidebarV2() watches the hash on its own: it sends the prompt, then clears the hash. This page has no hash-handling code of its own.

In this page

• Pre-publish review
• Better CTA

New tab

• Optimize for SEO Opens in new tab
• Fix an error (new chat) Opens in new tab

<a
  href="#angie-prompt=Help%20me%20create%20a%20contact%20page"
  target="_blank"
  rel="noopener noreferrer"
>
  Get help creating a contact page
</a>

3. Inject context on the fly

Pass a context object to triggerAngie and it rides the next message under a reserved context.consumer key — so Angie already knows the value instead of calling a "read current value" tool. Everything you send goes in as-is.

Then ask Angie anything about "this field" — the value is already in context.consumer.selectedField on the request.

await sdk.waitForReady();
await sdk.triggerAngie({
  options: { newChat: true },
  context: {
    source: 'demo-field-context',
    selectedField: { name: 'headline', value: fieldValue },
  },
});

4. Conversation starters at trigger time

Pass suggestions to triggerAngie to set the conversation starters for the new chat — different entry points can offer different starters, not only the ones configured at loadSidebar.

await sdk.waitForReady();
await sdk.triggerAngie({
  options: { newChat: true },
  suggestions: {
    items: [
      { label: 'Make it longer',  value: 'Make this text longer.' },
      { label: 'Make it shorter', value: 'Make this text shorter.' },
      { label: 'Fix grammar',     value: 'Fix the grammar in this text.' },
    ],
  },
});

5. Status

Last result from the controls above. Hash links are handled inside the SDK, so they do not report here.