API Keys & Providers
Configure provider keys for dispatch, narration, and other agent-backed work.
Decide which keys you need
Pulse AI can coordinate local work through different agent providers and CLI tools. You only need keys for the workflows you intend to run.
For setup, separate three questions:
- Which agent route will dispatch tasks or Workdays?
- Will presentations, audits, or responses need voice narration?
- Does the workspace need local scripts to generate narration from the same key?
Voice narration uses Gemini TTS when voice is enabled. Other dispatch routes depend on the provider or CLI configured in Settings.
Where to add keys
Open Pulse AI: Open App Shell, then go to Settings. Add provider keys in the relevant settings surface instead of pasting secrets into docs, task files, screenshots, or support messages.
Pulse AI stores the Gemini voice key through the editor's SecretStorage API, which uses the operating system keychain. If Sync Key Across Workspaces is enabled, Pulse AI can provision that Gemini key into a workspace .env file so local agent scripts can generate narration.
Treat workspace .env files as secrets. Do not commit them, screen-share them, or include them in launch footage.
Voice setup
For narration:
- Open Pulse AI: Open App Shell.
- Open Settings.
- Find the Voice section.
- Paste the Gemini API key.
- Leave key sync on only for workspaces where local narration generation is intended.
Pulse AI uses that key for presentation narration, audit narration, and response narration when the matching voice preferences are enabled.
Dispatch provider setup
Dispatch provider settings control which agent route Pulse AI uses for action items and Workdays. The available routes depend on installed tools, account access, and workspace configuration.
Choose the default dispatch participant and assisted-workday participant in Settings. Keep concurrency modest until you understand provider quota and billing behavior.
Proof that keys are ready
Keys are ready when the intended workflow succeeds without exposing the secret:
- A provider-backed task can dispatch.
- Voice narration can generate an audio artifact when enabled.
- The workspace does not require keys to be pasted into public files.
- A reload preserves the configured key path or workspace provisioning behavior.
If Pulse AI reports a missing, invalid, quota, or billing key error, use the Help Center fix path before retrying the same task.