Tutorial 15 · Scale

Using the Copilot

5 min read

What you'll learn

  • What the Artifact Agent (Copilot) is and what it can do for you
  • How to open the chat panel and start, switch, rename, and delete chats
  • How to ask it to find parts, build and edit diagrams, and run checks
  • How it proposes library changes for your review (Accept / Reject)
  • How to attach images/PDFs, dictate, pick a model, and request support

Prerequisites

  • Complete Tutorial 2: App Overview so you know the workspace layout and the top-right chrome.
  • The Artifact Agent must be enabled for your workspace. If you don't see the Open Artifact Agent icon next to your avatar, it isn't enabled — contact your administrator.

Steps

1Open the Agent

The Agent lives in the top-right corner, next to the active-user avatars and your profile avatar.

  1. Click the purple Artifact AI icon (tooltip Open Artifact Agent).
  2. A floating Artifact Agent panel opens. Drag its header to reposition it, and drag the bottom-right corner to resize — your layout is remembered between sessions.
  3. Click the X (Close chat) to hide the panel; click the icon again to reopen it.

Screenshot

The Artifact Agent panel open in the top-right, with the chat input at the bottom

2Know what it can do

The Copilot is a single-user assistant — your chats are private to you and don't show up in teammates' presence. It can:

  • Library — search and read your library, draft new parts, and propose edits to existing ones.
  • Read the diagram — summarize the active diagram, list its contents, run ERCs, and even capture a screenshot to reason about.
  • Build and edit the diagram — place devices, connectors, wires, cables, tables, and annotations; connect, move, group, align, bundle, and mate connectors.
  • Navigate — open diagrams, the harness editor, the Library and Project dashboards, switch tabs, and fit the view.
  • Look things up — list your projects, diagrams, versions, and harnesses; compare two versions; search the web and fetch a page.
  • Contact support — draft a support email to Artifact and send it once you confirm.

It automatically sees context about your current project, open tabs, and current selection, so you can refer to "this diagram" or "the selected device" without spelling everything out.

3Start a conversation

  1. Type your request in the Ask anything… box and press Enter (use Shift+Enter for a newline).
  2. Click Send message (arrow) to send, or Stop generating (red square) to cancel a response in progress.
  3. Replies stream in as they're generated. When the Agent uses a tool, it shows an action line — e.g. Searching library… that becomes Searched library — with a chevron you can expand for details.
  4. Thinking… appears while the Agent reasons before answering.

Screenshot

A chat with a streamed answer and an expandable "Searched library" action line

4Manage your chats

Chats are saved to your account, so they follow you between sessions and browsers. (Only the last-open chat, your model choice, and the panel position are remembered on the local device.)

  • + (New chat) — start a fresh chat.
  • The header dropdown switches between saved chats. The empty state reads "No saved chats yet."
  • Rename and Delete manage the active chat. Deleting asks "Delete "{title}"? This cannot be undone."

5Review proposed library changes

When the Agent creates or edits a library part, it doesn't save silently — it proposes the change for your review.

  1. The new or edited part opens in the Library Editor, and a Pending proposals panel appears in the chat showing "{n} pending change(s)".
  2. Review each proposal, then click Accept to save it or Reject to discard it. Use Accept all / Reject all to resolve the whole batch.
  3. You can also Save or discard the part directly in the Library Editor — it's the same accept/reject path.

Diagram edits apply immediately. Unlike library proposals, changes the Agent makes to a diagram (placing parts, drawing wires, etc.) take effect right away. Use Ctrl/Cmd+Z to undo anything you don't want.

Screenshot

Pending proposals panel with Accept all / Reject all and a per-item Accept/Reject

6Attach images and PDFs

Give the Agent something to work from — a datasheet, a photo of a connector, or a screenshot.

  • Click Attach image or PDF (paperclip), paste an image, or drag files onto the panel (it shows "Drop images or PDFs here…").
  • Attachments appear as thumbnails in the input and in your sent message. PDFs are accepted up to 100 pages.

7Dictate, choose a model, and get support

  • Dictate — click the mic to speak your request; click Stop dictation to finish. (If your browser blocks the mic, you'll see "Microphone access blocked.")
  • Model — the picker in the input row lets you choose among the models available to your deployment (e.g. Claude Sonnet / Opus variants).
  • Support — ask the Agent to contact Artifact support. It drafts the email first and only sends it after you confirm.

Summary

You opened the Artifact Agent from the top-right, learned that it's a private single-user assistant that can search and propose library parts, read and build diagrams, navigate the app, and look things up. You started and managed saved chats, reviewed proposed library changes with Accept / Reject (while diagram edits apply immediately and are undoable), and used attachments, voice input, model selection, and the support flow.

What's next

Glow effect