Skip to main content

Tool Design Overview

Tool design in Veoveo is about making agent capabilities bounded, reviewable, and connected to workspace context.

Design Standard

  • Give each tool a clear job.
  • Use typed inputs and outputs so callers know what is required.
  • Keep durable side effects visible through artifacts, links, events, or operations.
  • Return bounded results that a user can review.

Review Questions

  • What workspace context does the tool need?
  • What does it return to the user or bot?
  • Does it create or update artifacts, blobs, links, events, messages, or operations?
  • How will a human review success or failure?

Media To Add

  • Diagram: request to tool call to output artifact and operation event. It helps developers reason about reviewable side effects. Source: sample tool operation.