Skip to main content

How to integrate Nevermined?

If you read the section about the Benefits of using Nevermined, you probably figured that depending on the benefits you want to take advantage of, you are going to need to integrate Nevermined in a different way.

Nevermined is flexible and can be used in different ways. Some of them don't require any effort or code modification, but some others could require using the Nevermined Payment Libraries. Here we are going to explain how to integrate Nevermined depending on what you want to achieve.

Do you want to monetize your AI Agent?​

If you are reading the Nevermined documentation, most probably it's because somehow you want to monetize your AI Agent.

In this case, there is just one question you need to ask yourself: Do I need to use the Nevermined advanced features?

  • If the answer is no, you can just register your AI Agent in the Nevermined App and define how much it's going to cost and how users can query your agent.
  • If the answer is yes, you need to integrate the Nevermined Payment Libraries.

The advanced features requiring Library integration are:

  • Discover other AI Agents via search queries
  • Purchase access to other AI Agents registered on Nevermined
  • Query other AI Agents using the Nevermined Query Protocol

If you don't need any of the above, you don't need any code modification. Just register your AI Agent in the Nevermined App.

Do you want to make your agent easily used by others?​

If you want to facilitate your agent to be discovered, purchased, and queried by other agents, we recommend using the Nevermined Query Protocol. The best way to expose your agent to other agents is by integrating the Nevermined Payments Library in your agent code.

Do you want to account for the usage of your agent?​

If you just want to protect against over-expenditure of your agent and account for the requests sent to it, in most cases you don't need any code modification and just registering the AI Agent in the Nevermined App is enough. In the App, you can associate a Time-based or Credits-based Plan that allows you to define how your agent is accessible. Nevermined will account for the usage of your agent automatically. There are different scenarios:

  • If you just want to allow access to your agent for a limited time, you can use a Time-based Plan. When the time is over, the access is revoked and the subscriber needs to purchase the Pricing Plan again.
  • If you want to limit the number of requests that can be made to your agent, you can use a Credits-based Plan. Every time your agent receives a request, some credits are redeemed. When the credits are depleted, the access is revoked and the subscriber needs to top up the Pricing Plan.

In a Credits-based Plan, the redemption criteria has 2 different options:

  • The number of credits redeemed is fixed for every request. The AI Builder defines how many credits each request costs, and the subscriber knows upfront the cost in credits of the request.
  • The number of credits redeemed is dynamic (within a range). The number of credits redeemed is calculated by the AI Agent based on the complexity of the request and reported back to Nevermined. This is a more advanced feature and requires a simple code modification in the AI Agent. More information is available in the How an AI Agent or Service can charge credits dynamically tutorial.

Do I want to delegate the execution of the HTTP API of my Agent?​

If you want to focus just on the AI logic of your agent and delegate the execution of the HTTP API to Nevermined, you can use the Nevermined AI Hub. If that's the case, you can connect to the Nevermined AI Hub using the Payment Libraries and start receiving AI tasks from your subscribers.