← All ivy-agents
IVYXSTUDIO · IVY AGENT
S

Sentiment Analysis Report

ivy.agent.review-sentiment-report · v1.0.0

ivyx

Read product reviews, score sentiment per review using Jev, average scores by month, and write a Markdown report.

Steps

In the order the agent's file lists them. A branch or a loop is a step too; the wiring between steps is in the file.

  1. 01
    CSV Read
    ivy.node.csv-read
    Ivy Node
  2. 02
    Jev · Score
    For each
  3. 03
    Table Aggregate
    ivy.node.table-aggregate
    Ivy Node
  4. 04
    Markdown Table
    ivy.node.markdown-table
    Ivy Node
  5. 05
    File Write
    ivy.node.file-write
    Ivy Node

Nodes it brings

Adding this agent in IVYX Studio adds these nodes with it. A node your workspace already has is kept as it is, even at another version.

What it touches

Collected from what each of its nodes declares, plus the model call when a step is a model turn. A declaration is the author's statement, and it is what policy rules select on.

Writes filesNetwork

What it needs

  • A stored secret named jev-api-key. The agent's file carries the name, never the value.

Inputs

FieldTypeDescription
pathstringPath to the CSV file.
textstringCSV text, instead of a path.
delimiterstringThe field separator.

Outputs

FieldTypeDescription
columnsarrayColumn names in file order.
row_countintegerHow many rows were read.
datesarraylist of dates extracted from rows
scorenumber0 to the top level number; can fall between levels.
levelintegerThe nearest level number, 0 for the first.
level_textstringThe nearest level's description.
isobjectFor each level, as lowercase words joined by _, whether it is the nearest one; a branch reads is.<level>.
normalizednumberThe score scaled to 0–1.
confidencenumber0–1, how peaked the probabilities are.
probabilitiesobjectEach level's probability, keyed by level number.
modelstringThe model version that answered.
groupsintegerHow many groups there are.
value_columnstringThe name of the aggregate's column: the value column's own name, or count.
pathstringThe absolute path written.
bytesintegerHow many bytes were written.

Tests

1 of 1 test cases passed on Oct 2, 2026, in the publisher's own environment, before this version was published. The registry keeps that record; it does not run the cases again.

Requires: the stored secret jev-api-key, python:3.9

  • two-months

    Eight reviews over two months become a two-row monthly table in reports/sentiment.md.