Yard Docs
Sign in
On this page

Pointing an agent at blocks

Give an agent exactly the context it needs: selected blocks as chips, your account setting, frames, the design system, a repository or one file.

Updated November 11, 2026 · 2 min read

An agent works from what you give it. In Yard that is your docs and canvases: what you select goes with your message, and with nothing selected nothing else goes (unless your account is set to read the whole workspace).

Chips are the selection

Open the chat beside a sheet and select blocks: each one shows as a chip above the message box. Remove a chip with its ×, or select something else. Try it here, on sample data:

Demo Pointing the agent at blocks
Context: Design system

Runs on sample data · Click blocks to select them: they become the chips the agent gets with your message.

Starting work works the same way: the work composer shows its context as chips, and + opens the context picker to add more. Drag a row from the sidebar, a block from the canvas, a row of the Files panel or a chat tab onto it ("Drop to add as context") to add that too. The chat's message box takes the same drops: they become chips for the next message.

Keep what always matters at hand

Some blocks belong in most conversations: the product brief, the design system, the coding conventions. Nothing goes along by itself, so put them where you reach them fast: select one and choose Pin to the sidebar under More, or drag it onto Pinned on the workspace overview. A pin is a bookmark, not context: nothing pinned goes with a message by itself. Type @ in the start box and your pins are offered first, under Pinned, or drag one from the sidebar onto the box. Your pins are yours alone. If you would rather the agent always see everything, choose The whole workspace under Account settings, Agent context (account preferences).

Point at the design system

Keep the design system on a sheet: the component list, a screenshot of the tokens, a link to the live catalogue. Drag the sheet in when you ask for UI work (everything on it comes along), and say so in the message:

Text
Build the bulk-select bar with the components in the design system sheet.
No new colours: use the tokens.

Point at a repository or a file

  • Select a repository block to give the agent the whole repository.
  • Pin lines in the repository explorer as highlights with a note: the agent gets the lines and your note.
  • Extract a file onto a canvas as a block and select just that file when the question is about it.
  • In a project's spec, type @ to mention a block, a file or a repository by name.
  • In a project's chat, Attach then Blocks or A repository links a block or a repository to the project; the next message tells the agent it was newly added.

Gather what belongs together

A sheet is one piece of context. Gather the note, the mockups and the research for one feature on a sheet, and dragging the sheet into a chat or a draft brings all of it, nested sheets too, each thing once.

Next

  • Tips for getting good results.
  • Chat in full.
Was this page useful?
Edit this page