Review Sentiment Report
ivy.agent.review-sentiment-report · v1.1.0
ivyx
Reads a CSV of dated reviews, has Jev score each one's sentiment, averages the scores per month and writes the table as Markdown.
Steps
In the order the agent's file lists them, each with where its inputs come from and the values the file fixes. A branch or a loop is a step too.
- 01Ivy NodeRead the reviewsivy.node.csv-read
Reads a CSV file, or CSV text, into rows with the column names and row count.
- takes
pathfrom the agent's input- returns
row_count
- 02For eachScore each review
Runs Jev · Score once for each item of rows of step 1.
- set
instructionsScore the sentiment of this review on a five-level scale: very negative, negative, neutral, positive, very positive.levels["very negative","negative","neutral","positive","very positive"]- secret
jev_api_keythe stored secret jev-api-key
- 03Ivy NodeAverage per monthivy.node.table-aggregate
Groups rows and sums, averages, counts or takes the minimum or maximum of one column, optionally by month, year or day of a date column.
- takes
rowsfrom step 2,results- set
group_bydateperiodmonthvaluescoreopmean- returns
groups
- 04Ivy NodeLay out the tableivy.node.markdown-table
Formats rows as a Markdown table, with the columns in the order given or as they first appear.
- takes
rowsfrom step 3- set
columns["date","score"]
- 05Ivy NodeWrite the reportivy.node.file-write
Writes text to a file, creating its folder, and returns the absolute path and the number of bytes written.
- takes
textfrom step 4,markdown- set
pathreports/sentiment.mdoverwritetrue- returns
path
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 and what the agent's own file declares, such as moving a robot, 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.
What it needs
- A stored secret named
jev-api-key. The agent's file carries the name, never the value.
Inputs
| Field | Type | Description |
|---|---|---|
| pathrequired | string | The CSV file with the columns date and review. |
Outputs
| Field | Type | Description |
|---|---|---|
| groups | integer | How many months the table covers. |
| row_count | integer | How many reviews were scored. |
| path | string | The Markdown report written. |
Tests
2 of 2 test cases passed on Oct 7, 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: python:3.9, the stored secret jev-api-key
- two-months
Eight reviews over two months become a two-row monthly table in reports/sentiment.md.
- given
pathdata/jev/reviews.csv- expects
row_countequals 8groupsequals 2pathmatches reports/sentiment\.md$
- three-months
Six reviews over three months become a three-row table; another file is read, not a remembered one.
- given
pathdata/jev/reviews-b.csv- expects
row_countequals 6groupsequals 3