Using artifacts with your Superagent

Artifacts is your Superagent’s library for the work you do together, from plans and meeting notes to interactive charts, dashboards and tools. Your Superagent uses what’s in it for context, and creates or updates items when you ask. You can also open, edit, share and organize them yourself.

---

​

How artifacts work

When your Superagent creates or updates an item in chat, a card appears in the conversation. You can open the item from the card in a panel beside the chat, so you can read it without leaving the conversation. You can also attach items to a message so your Superagent uses them as context. Your library holds 2 kinds of items. Documents are pages you or your Superagent write, such as plans, briefs and meeting notes. Artifacts are interactive visuals, charts or tools your Superagent builds for you. You can sort everything into folders, and items link to each other, so related information stays together.

---

​

Finding and organizing items

Find anything in your library by opening folders, searching or narrowing the list. Use the type menu to show only documents, artifacts or the items people shared with you. You can also sort the list by name or last updated date, and switch between list and tile view. To find and organize items:

1. Open your Superagent.
2. Click Artifacts in the sidebar.
3. Do one of the following:
   • Find an item: Click an item or folder to open it. To search by name, click the search icon.
   • Create a folder: Click New folder, enter a name and click Create folder.
   • Share a folder: Click More actions on the folder’s row and select Share. Invite people by email with Can view or Can edit access. They get everything in the folder, including items you add later.

---

​

Creating an artifact

Add your own items alongside the ones your Superagent creates. Write a document yourself or ask your Superagent to build an interactive artifact.

​

Writing a document

Start a blank document and build it out with the elements you need. A new document takes its name from its first line until you rename it. To create a document:

1. Open your Superagent.
2. Click Artifacts in the sidebar.
3. Click New.
4. Select Document.
5. Type your content. Documents save automatically as you write.
6. Press / or hover over a line and click the Add block button beside it to add elements such as headings, lists, images and tables.

​

Building an interactive artifact

An interactive artifact is a visual, chart or tool your Superagent builds and saves to your library, such as a sales dashboard, a trip timeline or a budget calculator. You describe what you want, and your Superagent builds it for you. To create an artifact:

1. Open your Superagent.
2. Click Artifacts in the sidebar.
3. Click New.
4. Select Artifact. The chat opens with an Artifact badge in the message box.
5. Describe what you want and send.
6. Click Open artifact on the card in the chat to view it beside your conversation.

---

​

Adding a kanban board

A document can hold a live kanban board, so you can track work in the same place you and your Superagent keep everything else. A board is text underneath, where each column is a heading and each card is a list item, so you can build it visually or write it out. A board also appears in a document you share with a public link, laid out and ready to read. To add a board:

1. Open the document.
2. Click in its body where you want the board.
3. Press / or click the Add block button.
4. Select Kanban board. The board starts with a Todo and a Done column.
5. Build it out:
   • Add a card: Click Add card in a column, then type the card text.
   • Add a column: Click Add column to the right of the board or select Add column after from a column’s menu. A new column arrives titled New column with your cursor at the end of it, so clear that text before typing your own title.
   • Move a card: Drag it to another column or select Move to from the card’s menu.
   • Rename or reorder a column: Select Rename column, Move left or Move right from the column’s menu.
   • Remove something: Select Delete card or Delete column.
   • Fix a board that won’t display: If a board can’t be read, click Show raw text to see the text behind it, then Hide raw text to close it.

---

​

Updating with your Superagent

Ask your Superagent to change a saved document or artifact for you, such as adding this week’s numbers to a dashboard or tightening a plan. The chat opens with that item attached to your message, and your Superagent edits the same item instead of making a new one. On a computer, the item stays open beside the chat so you can watch it change. To update an item with your Superagent:

1. Open your Superagent.
2. Click Artifacts in the sidebar.
3. Open the document or artifact.
4. Click the More actions icon at the top right.
5. Select Update with agent.
6. Describe the change and send.

---

​

Managing an artifact

Rename, duplicate, share or delete any item, and present or download interactive artifacts. To manage an item:

1. Open your Superagent.
2. Click Artifacts in the sidebar.
3. Open the item.
4. Click the More actions icon at the top right.
5. Do one of the following:
   • Present: Open an interactive artifact in a large window over the page, ready to show others.
   • Download: Save a copy of an interactive artifact to your computer as an HTML file.
   • Rename: Type the new name.
   • Duplicate: Create a copy.
   • Share: Share it in either or both of these ways:
     • Invite: Invite people by email and choose whether they can view or edit. Once they accept, the item appears under Shared with you in their Artifacts library.
     • Create public link: Get a link anyone can use to view a read-only copy, without signing in. Click Copy link to share it, or Unpublish to stop sharing.
   • Delete: Confirm to delete it. Links to the item stop working, and you can’t undo this.

---

​

Working with artifacts beside chat

Open the artifacts panel yourself at any time, without waiting for a card in the chat. On a computer, the panel docks beside your conversation, so you can read an item and keep chatting. On a phone, it opens full screen. To open artifacts beside your chat:

1. Open your Superagent.
2. Open a conversation or click New conversation.
3. Click the Open artifacts icon at the top right.
4. Do one of the following:
   • An item in the list: Open it in the panel.
   • The item’s name at the top of the panel: Switch to another item, or select All artifacts to go back to the list.
   • More actions > Open full page: Read the item in full on its own page.
   • Close artifact: Close the panel. Close artifacts in the top bar does the same.

---

​

FAQs