Skip to content
Nappai Documentation

Calculator

The Calculator component is designed to perform basic arithmetic operations on a given expression. It evaluates simple mathematical expressions and returns the result, making it easy for users to perform calculations within the Nappai automation system.

Relationship with Python AST Module

The Calculator component uses the Python ast module to safely parse and evaluate arithmetic expressions. This ensures that only a specific set of allowed operations are performed, enhancing security and reliability.

Inputs

  • Expression: The arithmetic expression to be evaluated (e.g., ‘44(33/22)+12-20’). This input is mandatory and must be a valid arithmetic expression.

Outputs

The component produces two types of outputs:

  • Result: The result of the evaluated arithmetic expression, formatted to a reasonable number of decimals.
  • Error: An error message if the expression is invalid or if an error occurs during evaluation.

Usage Example

Imagine you want to calculate the result of a complex arithmetic expression as part of an automated workflow. Simply input the expression into the Calculator component, and it will return the computed result. For example, inputting ‘3+5*2’ will yield a result of ‘13’.

Templates

Currently, there are no specific templates where this component is used.

  • libSQLRetrieverTool: Tool for interacting with libSQL Retriever.
  • Embedding Similarity: Compute similarity between two embedding vectors.
  • SQLite: Interact with SQLite databases.
  • Tool Calling Agent: Agent that uses tools.
  • OpenAI Tools Agent: Agent that uses tools via openai-tools.
  • Basic Agent: Basic Agent for general purposes.
  • OpenAI Function Agent: An agent that uses OpenAI’s language models to generate text.
  • Cassandra: Cassandra Vector Store with search capabilities.
  • Supabase: Supabase Vector Store with search capabilities.
  • Milvus: Milvus vector store with search capabilities.
  • MongoDB Atlas: MongoDB Atlas Vector Store with search capabilities.
  • Pinecone: Pinecone Vector Store with search capabilities.
  • Qdrant: Qdrant Vector Store with search capabilities.
  • Astra DB: Implementation of Vector Store using Astra DB with search capabilities.
  • PGVector: PGVector Vector Store with search capabilities.
  • Redis: Implementation of Vector Store using Redis.
  • Vectara: Vectara Vector Store with search capabilities.
  • Weaviate: Weaviate Vector Store with search capabilities.
  • Upstash: Upstash Vector Store with search capabilities.
  • Couchbase: Couchbase Vector Store with search capabilities.
  • FAISS: FAISS Vector Store with search capabilities.
  • Deeplake Database: Deeplake Vector Store with search capabilities.
  • Chroma DB: Chroma Vector Store with search capabilities.

Tips and Best Practices

  • Ensure that the input expression is a valid arithmetic expression to avoid errors.
  • Use the component to automate repetitive calculations within your workflows.

Security Considerations

The component uses the ast module to safely evaluate expressions, limiting operations to a predefined set of allowed operators. This prevents the execution of unauthorized functions or commands, enhancing security.