Skip to main content

How NumiaAI Works

NumiaAI's architecture was designed to streamline interaction with blockchain data. Its layered system enables seamless communication, data fetching, processing, and rendering, making it an intuitive and powerful tool for users. This page provides a high-level overview of the components and their roles within the NumiaAI system.

High-level workflow​

The NumiaAI workflow consists of the following steps:

  1. User Query: The user inputs a natural language question or request.
  2. Task Delegation: The main agent parses the query and assigns tasks to appropriate tools or sub-agents.
  3. Data Retrieval: Data-sourcing tools fetch relevant information from APIs.
  4. Data Processing: The back-office sub-agent analyzes and processes the data as needed.
  5. Result Presentation: Data-rendering tools format the output into charts, cards, or summaries for the user.
  6. Export Option (Coming Soon): Users can download the data for offline use or reporting.

Tool overview​

Each NumiaAI tool is designed to handle specific aspects of data interaction.

The following accordions provides details and examples of these tool:

User-Facing Main Agent

The main agent is the interface users interact with directly. Powered by GPT-4o, its primary responsibilities include:

  • Managing user communication.
  • Understanding natural language queries.
  • Delegating tasks to other components based on user requests.
Examples
  • "What is the total transaction volume on Osmosis for the last 7 days?"
  • "Who are the top 5 validators by delegation on Cosmos Hub this month?"
  • "Summarize staking rewards for wallet juno1abc... over the last quarter."
  • "What is the average gas fee for transactions on Evmos during the past week?"
  • "List all governance proposals voted on by wallet cosmos1xyz... in the last year."
Data-Sourcing Tools

These tools connect NumiaAI to the backend APIs and data sources, fetching the required blockchain data for analysis. Their primary functions are:

  • Querying Numia's APIs for transactional, historical, and analytical data.
  • Aggregating responses from multiple endpoints.
Examples
  • "Fetch all transactions for wallet address osmo1xyz... on Osmosis over the last 30 days."
  • "Provide details for governance proposal #45 on Cosmos Hub."
  • "Retrieve historical IBC transaction volumes between Evmos and Crescent for the past quarter."
  • "Fetch staking delegation history for wallet cosmos1abc... on Cosmos Hub."
  • "Get a log of block proposals and voting power changes for validator juno123... on Juno."
Data-Rendering Tools

NumiaAI includes specialized rendering tools to present data in user-friendly formats. These tools handle:

  • Visualizations: Generating bar charts, line charts, and other graphs.
  • Details Cards: Displaying transaction-specific or user-centric information.
  • Summary Views: Condensing large datasets into easily digestible insights.
Examples
  • "Show me a line chart of staking rewards on Osmosis for the last 6 months."
  • "Display a bar chart of token distributions in my wallet on Juno."
  • "Create a pie chart of validator voting power in the Cosmos Hub network."
  • "Visualize IBC transaction volume trends between Evmos and Crescent over the past year."
  • "Display a detailed card for transaction ID 0x12345 on Evmos."
Back-Office Sub-Agent

The back-office sub-agent acts as a dedicated data analyst. Using a GPT-assistant model combined with a code sandbox environment for Python execution, it performs:

  • Advanced data processing (e.g., calculating averages, medians, correlations).
  • Dataset analysis based on user-provided or fetched inputs.
  • Generating detailed reports or insights for complex queries.
Examples
  • "Calculate the average transaction value on Osmosis over the last 30 days."
  • "Determine the correlation between staking rewards and validator uptime on Cosmos Hub."
  • "Analyze the median gas fees for Evmos transactions during the past quarter."
  • "Perform a trend analysis of staking rewards on Juno for the top 10 validators over the last year."
  • "Compare IBC transaction volumes between Osmosis and Crescent over the last 6 months."
Export Tools (Coming Soon)

In development are tools to enable users to export analyzed data from NumiaAI into formats such as CSV. These tools will facilitate integration with external systems or workflows, as well as provide a bridge between NumiaAI's analytical outputs and user reporting needs.