Connect your AI

Open your design in the planner, choose Connect your AI, then Create & copy a new prompt. Paste it into your AI chat and describe what you want to design or change.

Your AI needs to be able to send HTTPS requests. The prompt contains a temporary connection to this design. A new prompt replaces the previous connection; access expires after 24 hours.

For agents

Use the Direct Agent Bridge URL and workspace_credential supplied in the prompt. Send authenticated JSON POST requests to https://api.gaussian-beam.com/api/agent/workspaces/{public_workspace_id}. Keep the credential in the JSON body, never in URLs or logs.

  1. Call get_diffbeam_state (or help) and get_workspace.
  2. Discover each command with get_operation_schema and operation_name. Do not guess fields.
  3. Use apply_operations to save multiple edits together, with the latest expected_revision. After a conflict or timed-out write, read the workspace before retrying.

Commands include optical elements and targets, catalog search, groups, virtual planes, other components, lens names, links, formulas and display units. The CLI uses the same API and also supports local design files.

Agent API examples · CLI commands and formulas