🌐Assistant Plugins

We've implemented support for plugins in our AI wallet. Plugins enable connecting tools and AI agents specifically designed for language models.

Ref Finance Tool Example

The Ref Finance Tool is a powerful example of a plugin designed to work seamlessly with our AI wallet. This tool allows users to directly interact with Decentralized Finance (DeFi) services from within the wallet interface.

With the Ref Finance Tool, users can perform a swaps all without leaving the AI wallet environment. Find the source code here.

How to add your plugin to Bitte Registry?

  1. Follow the OpenAPI Specification. See this example.

  2. Deploy your service with a cloud provider like Vercel, GCP, AWS, or any other that you're comfortable with.

  3. Make sure that /.well-known/ai-plugin.json is accessible (for example https://your-service/.well-known/ai-plugin.json)

  4. Ask our team on Telegram to add your plugin (it's a manual process for now).

OpenAPI Bitte Extension

We have created an extension for the OpenAPI specification that allows you to include additional metadata.

"x-mb": {
  "account-id": "bitte.near",
  "assistant": {
    "name": "assistant-name",
    "description": "Shorter summary about the assistant and it's capabilities",
    "instructions": "Detailed, specific instructions to be passed to AI Assistant on it's funcitonality and tool usage.",
    "tools": [{ type: "generate-transaction" }, { type: "submit-query" }]
  }
}

Account ID (account-id)

β€’ Description: Specifies the account ID associated with the plugin. This is typically the account ID on the NEAR blockchain that identifies the owner or operator of the API.

β€’ Example: bitte.near

Assistant Configuration (assistant)

Provides the configuration for the assistant that will guide the user in interacting with the API. This section includes details about its behavior, and the tools it can use.

name

Instructions provided to the assistant define its role or behavior. This helps tailor the assistant’s responses according to specific requirements.

Example: "Weather Agent"

description

General summary of the assistants functionalities and tools / endpoints.

instructions

Instructions provided to the assistant define its role or behavior. This helps tailor the assistant’s responses according to specific requirements.

Example: "You are a helpful assistant. When using the get-weather tool make sure to know or ask for the user's location."

tools

A list of tools that the assistant can use. Each tool is defined by its type and possibly other configurations.

Tool Type The type of tool that the assistant can use. This can vary based on the functionality required by the API.

Tool TypeDescription

generate-transaction

Creates a transaction based on the user request

submit-query

Creates a GraphQL query based on Mintbase's Indexer, submits it and returns the result

generate-image

Creates an image, uploads it to Arweave and returns a transaction hash

create-drop

Creates an NFT drop

Last updated