diff --git a/.gitignore b/.gitignore index 050ce975a..b25fcd2bd 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ .DS_Store -**/node_modules \ No newline at end of file +**/node_modules +.vscode/settings.json diff --git a/www/docs/agent-os/sessions.md b/www/docs/agent-os/sessions.md index b6d2035ca..864c53aa9 100644 --- a/www/docs/agent-os/sessions.md +++ b/www/docs/agent-os/sessions.md @@ -20,6 +20,7 @@ appended to the session. Sessions support lifecycle operations such as creation, update, retrieval, listing, and deletion. + ## Chat with your agent After creating an agent, you can interact with it by creating a session and sending messages: @@ -218,6 +219,13 @@ conversations. Artifacts remain available throughout the session lifecycle, enabling multi-step workflows without re-uploading files. +### Document upload and conversion + +You can upload PDFs, DOCX files, PowerPoints, or images to an agent session. +The Document Conversion Tool converts the uploaded artifact into Markdown, +which can then be summarized, analyzed, or indexed in subsequent tool calls. + + ### Uploading files to a session To make files available to an agent, upload them to the session workspace using @@ -298,4 +306,3 @@ After files are uploaded as artifacts, the agent can: Artifacts remain available throughout the session lifecycle, enabling multi-step workflows without re-uploading files. - diff --git a/www/docs/release-notes.mdx b/www/docs/release-notes.mdx index 880baa897..fd74bd614 100644 --- a/www/docs/release-notes.mdx +++ b/www/docs/release-notes.mdx @@ -18,6 +18,54 @@ experimenting with Retrieval Augmented Generation (RAG), or exploring our newest API endpoints, this page is your go-to place to see how we’re evolving and how these product and documentation changes can benefit your enterprise. +## Document Conversion Tool for Agents + +_November 16, 2025_ + +Vectara introduces the Document Conversion Tool, a new standalone agent tool +that extracts content from uploaded files and converts them into clean, +structured Markdown format. These files include PDFs, Word documents, +PowerPoint presentations, and images. Converted outputs persist across a +session. + +**Why it matters:** Previously, converting uploaded files into readable text +required external preprocessing. This tool brings document parsing directly into +agent sessions, enabling agents to interpret file types and transform them +into context-ready text for reasoning, summarization, or indexing. + +**More information:** +[Agent tools overview](/docs/agent-os/agent-tools-overview) +[Document upload and conversion](docs/agent-os/sessions#document-upload-and-conversion) + +--- + +## Artifact Storage for Agents + +_November 15, 2025_ + +The Agents API now supports artifact storage, a persistent, session-scoped +workspace for files that enables efficient multi-step document processing +workflows. Artifacts provide a persistent workspace where agents and users +can share files throughout a conversation without bloating the agent's context. +When the session expires, the artifacts are cleaned up. + + +**Why it matters:** Before artifact storage, file uploads caused context window +bloat and inefficient multi-step workflows. Artifacts solve these problems by +separating file storage from file references. Upload a PDF once, and reference +it across multiple operations like conversion, analysis, and indexing. + +**What's new:** +* Session-scoped storage: Files uploaded to agent sessions are stored as artifacts +with unique identifiers, remaining available throughout the conversation lifecycle. +* Lightweight references: `ArtifactReference` objects contain only metadata (artifact_id, +filename, mime_type, size_bytes) instead of full file contents, reducing payload sizes +from potentially megabytes to ~100 bytes. + +**More information:** +[Agent tools overview](/docs/agent-os/agent-tools-overview) +[Working with artifacts](/docs/agent-os/sessions#working-with-artifacts-in-sessions) + --- ## Lambda Tools: Customize Python Functions in Agents