Add CarvOnchainDataAgent

by ADMIN 25 views

Category: Integration Request

1. Summary/Context

The Heurist Agent Framework is a powerful tool for building and integrating various data sources and agents. In this request, we propose adding a new agent, CarvOnchainDataAgent, which will enable users to query on-chain data using natural language. This agent will utilize the CARV API, specifically the /ai-agent-backend/sql_query_by_llm endpoint, to interpret user queries and convert them into SQL queries based on predefined schemas.

The CARV API provides a unique feature that allows users to query on-chain data using natural language, making it an excellent addition to the Heurist Agent Framework. By integrating this agent, users will be able to build mesh agents that can query on-chain data, expanding the capabilities of the framework.

API Documentation: https://docs.carv.io/d.a.t.a.-ai-framework/api-documentation/on-chain-data-sql-query-by-llm

2. Details & Motivation

Tool-Only Mode:

  • The agent will proxy user queries to the CARV API.
  • The expected input and output schema will be as follows:
    • Input: User query (natural language)
    • Output: SQL query (formatted based on predefined schemas)

Agent Mode:

  • The agent will use a prompt to convert the user query into a well-formed query as the API input.
  • The user must specify the blockchain (Ethereum, Base, Bitcoin, or Solana).
  • If the user asks about an unsupported chain, the agent will not call the API but will explain the failure reason.

3. Proposed Approach or Possible Fix

To add the CarvOnchainDataAgent to the Heurist Agent Framework, we propose the following approach:

  1. API Integration: Integrate the CARV API into the framework, specifically the /ai-agent-backend/sql_query_by_llm endpoint.
  2. Schema Definition: Define the schemas for the input and output data, as described above.
  3. Agent Implementation: Implement the CarvOnchainDataAgent, using the CARV API to query on-chain data.
  4. Testing and Validation: Test and validate the agent to ensure it works as expected.

4. Additional Context or Screenshots

No additional context or screenshots are required for this request.

5. Bounty Rules (If Applicable)

This is not a bounty issue, and no bounty rules are applicable.

Benefits of Adding CarvOnchainDataAgent

The addition of CarvOnchainDataAgent will bring several benefits to the Heurist Agent Framework, including:

  • Enhanced Data Querying: Users will be able to query on-chain data using natural language, making it easier to access and analyze data.
  • Increased Flexibility: The agent will support multiple blockchains, providing users with more flexibility in their data querying needs.
  • Improved User Experience: The agent will provide users with a more intuitive and user-friendly experience, reducing the complexity of querying on-chain data.

Q: What is CarvOnchainDataAgent and why is it being added to the Heurist Agent Framework?

A: CarvOnchainDataAgent is a new agent that will enable users to query on-chain data using natural language. It will utilize the CARV API to interpret user queries and convert them into SQL queries based on predefined schemas. This agent is being added to the Heurist Agent Framework to provide users with a more powerful and flexible tool for querying on-chain data.

Q: What are the benefits of adding CarvOnchainDataAgent to the Heurist Agent Framework?

A: The addition of CarvOnchainDataAgent will bring several benefits to the Heurist Agent Framework, including:

  • Enhanced Data Querying: Users will be able to query on-chain data using natural language, making it easier to access and analyze data.
  • Increased Flexibility: The agent will support multiple blockchains, providing users with more flexibility in their data querying needs.
  • Improved User Experience: The agent will provide users with a more intuitive and user-friendly experience, reducing the complexity of querying on-chain data.

Q: How will CarvOnchainDataAgent work in the Heurist Agent Framework?

A: CarvOnchainDataAgent will work as follows:

  • Tool-Only Mode: The agent will proxy user queries to the CARV API.
  • Agent Mode: The agent will use a prompt to convert the user query into a well-formed query as the API input.
  • Blockchain Support: The agent will support multiple blockchains, including Ethereum, Base, Bitcoin, and Solana.

Q: What are the expected input and output schema for CarvOnchainDataAgent?

A: The expected input and output schema for CarvOnchainDataAgent are as follows:

  • Input: User query (natural language)
  • Output: SQL query (formatted based on predefined schemas)

Q: How will CarvOnchainDataAgent handle unsupported blockchains?

A: If the user asks about an unsupported blockchain, the agent will not call the API but will explain the failure reason.

Q: What is the current status of the CarvOnchainDataAgent implementation?

A: The implementation of CarvOnchainDataAgent is currently in progress. We are working on integrating the CARV API into the Heurist Agent Framework and defining the schemas for the input and output data.

Q: When can we expect the CarvOnchainDataAgent to be available in the Heurist Agent Framework?

A: We anticipate that the CarvOnchainDataAgent will be available in the Heurist Agent Framework within the next few weeks. We will provide regular updates on the implementation progress and will notify users when the agent is available for use.

Q: How can I get involved in the implementation of CarvOnchainDataAgent?

A: If you are interested in contributing to the implementation of CarvOnchainDataAgent, please contact us at support@heurist.io. We welcome contributions from the community and appreciate any help in making the Heurist Agent Framework an even more powerful tool for querying on-chain data.