Text Categorizer Agent

Note: The original version of this agent (v0) is deprecated. For new workflows, use the Categorizer agent instead, which accepts text and any other input type via named inputs. Existing workflows using Text Categorizer continue to work.

The Text Categorizer agent classifies plain text into user-defined categories using AI. It is a streamlined categorization agent for when your input is already in text form and you need single-category classification.

Use Cases

You have plain text input that needs to be classified into one of several categories.
Your text has already been converted from another format (e.g., via Convert to Text) and needs classification.
You want simple text classification without the overhead of configuring named inputs.

Inputs

Input	Type	Description
`text`	Text	The text to classify. Required -- the agent returns the fallback category if this is empty.
Additional inputs	Various (optional)	You can wire additional context from other agents as supplemental inputs. The agent considers these alongside the primary text.

Outputs

Output	Type	Description
`category`	Category	The assigned category name.

Each category produces a branch edge on the GWE canvas.

Configurations

Parameter	Description	Default
Categories	List of categories with names and descriptions (up to 1,000 characters each).	Required
Fallback category	Category assigned when the text is empty or no category matches. Defaults to "Fallback."	Required
Instructions	Additional classification guidance for the LLM.	None
Qualification criteria	Deterministic rules per category. Requires a JSON Extractor upstream to supply structured data.	None
Process entire document	When supplemental document inputs are wired, controls whether the full content is sent to the LLM.	Off

How to Use This Agent

document_trigger -> convert_to_text -> text_categorizer
 -> [urgent] -> human_collaboration
 -> [routine] -> knowledge_search -> respond
 -> [spam] -> abstain_from_answering

Text Categorizer vs. Categorizer

The Categorizer (v1) supersedes the Text Categorizer (v0). Key differences:

Feature	Text Categorizer	Categorizer
Primary input	Plain text (required)	Any type via named inputs
Multiple input types	Limited supplemental inputs	Full named inputs support
Custom instructions	Basic instructions field	Rich categorization instructions
Status	Deprecated (v0)	Current (v1)

Categorizer -- the recommended replacement. More flexible, accepts any input type.
Document Categorizer -- for classifying document objects directly (also deprecated).
Categorize Conversations and Route -- for classifying chat conversations.

Last updated: Jul 3, 2026