← All ivy-agents
IVYXSTUDIO · IVY AGENT
R

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.

  1. 01
    Read the reviews
    ivy.node.csv-read

    Reads a CSV file, or CSV text, into rows with the column names and row count.

    takes
    path from the agent's input
    returns
    row_count
    Ivy Node
  2. 02
    Score each review

    Runs Jev · Score once for each item of rows of step 1.

    set
    instructions Score 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_key the stored secret jev-api-key
    For each
  3. 03
    Average per month
    ivy.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
    rows from step 2, results
    set
    group_by date
    period month
    value score
    op mean
    returns
    groups
    Ivy Node
  4. 04
    Lay out the table
    ivy.node.markdown-table

    Formats rows as a Markdown table, with the columns in the order given or as they first appear.

    takes
    rows from step 3
    set
    columns ["date","score"]
    Ivy Node
  5. 05
    Write the report
    ivy.node.file-write

    Writes text to a file, creating its folder, and returns the absolute path and the number of bytes written.

    takes
    text from step 4, markdown
    set
    path reports/sentiment.md
    overwrite true
    returns
    path
    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 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.

Writes filesNetwork

What it needs

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

Inputs

FieldTypeDescription
pathrequiredstringThe CSV file with the columns date and review.

Outputs

FieldTypeDescription
groupsintegerHow many months the table covers.
row_countintegerHow many reviews were scored.
pathstringThe 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
    path data/jev/reviews.csv
    expects
    row_count equals 8
    groups equals 2
    path matches reports/sentiment\.md$
  • three-months

    Six reviews over three months become a three-row table; another file is read, not a remembered one.

    given
    path data/jev/reviews-b.csv
    expects
    row_count equals 6
    groups equals 3