Skip to content

Perceive Content Stream

POST
/api/agents/perceive/content/stream

Streaming content perception — NDJSON events mirroring /webpage/stream.

Same event shape as the webpage variant. No URL validation (content is supplied inline). The terminal complete event carries a WebpagePerceptionResponse with url="content://inline".

ContentPerceptionRequest

Request model for analyzing raw text content.

Analyzes raw text content (plain text, HTML, or markdown) for entity extraction, sentiment analysis, and insights without requiring a URL fetch.

Fields:

  • content: Text content to analyze (required, non-empty)
  • content_type: Type of content being analyzed (text, html, markdown)
  • depth: Analysis depth level (surface, analytical, strategic)

Usage: Used for analyzing content that’s already available without web fetching.

Integration:

  • PerceptionRoutes: Request validation for /perception/content endpoint
  • Document Analysis: Local content analysis workflows
object
content
required
Content

Text content to analyze

string
>= 1 characters
contentType
Contenttype

Type of content being analyzed

string
default: text
Allowed values: text html markdown
depth
Depth

Analysis depth level

string
default: analytical
Allowed values: surface analytical strategic

Successful Response

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object