Reference
Agent tools
The tools a connected agent gets from artifact.guru, and what each one does.
You never call these yourself: your agent picks them from what you ask. Knowing them helps you phrase requests and follow what the agent did. When a connection has several workspaces, each tool takes an optional workspace, and tools given an artifact find its workspace on their own.
| Tool | What it does |
|---|
publish | Publishes a new artifact, or a new version of a binary file or site at the same link. Text formats go inline; binary files go through create_upload first. |
create_upload | Reserves upload addresses for images, PDF, Word, PowerPoint, Excel and zipped sites. |
list_artifacts | Lists artifacts, newest first, or searches titles, file names, tags, projects and text. |
get_artifact | Details of one artifact: its link, who can open it, versions and files. |
list_projects | Projects in the connected workspaces, with how many artifacts each holds. |
| Tool | What it does |
|---|
read_artifact | Reads an artifact's source before a change: whole files with line numbers, or an outline of larger ones. |
edit_artifact | Sends only the change. Everything applies or nothing does, the result is checked against a picture, and edits made by someone else in between are never overwritten. |
rollback | Makes an earlier version live. The link shows it right away. |
| Tool | What it does |
|---|
update_artifact | Renames an artifact, replaces its tags, moves it to a project, or gives its link a new name (the old one keeps redirecting). |
create_project | Creates a project, or returns the existing one with that name. |
share | Changes who can open a link, invites people by email, makes a new secret code, or turns controls off for full screen. |
| Tool | What it does |
|---|
delete_artifact | Deletes an artifact and all its versions. Its link stops working. |
delete_older_versions | Frees storage by deleting the versions older than the live one. Newer ones stay. |