Agentverse Services: register a coin toss agent as a service 🪙

Introduction

In the Agentverse Services: register your services on the Agentverse! ↗️ guide, you have gotten familiar with the creation of an agent that can be registered as a service and then be used in DeltaV ↗️.

Create your coin toss agent!

For this navigate to the Agentverse: My Agents ↗️ (opens in a new tab) tab and click on the + New Agent button:

When the dialog is open, select the Toss a Coin use case:

A new agent will be created for you:

Run your coin toss agent!

After clicking on the row of your newly created agent, you should be able to see the source code of your coin toss agent in the editor view:

# Here we demonstrate how we can create a simple coin toss agent that is compatible with DeltaV.
 
# After running this agent, it can be registered to DeltaV on Agentverse Services tab. For registration you will have to use the agent's address.
 
import random
# third party modules used in this example
from pydantic import Field
from ai_engine import UAgentResponse, UAgentResponseType
 
 
class CoinToss(Model):
    choice: str = Field(description="The choice. Must be heads or tails.")
 
coin_toss_protocol = Protocol("CoinToss")
 
 
@coin_toss_protocol.on_message(model=CoinToss, replies={UAgentResponse})
async def toss_coin(ctx: Context, sender: str, msg: CoinToss):
    random_number = random.randint(0, 1)
    if random_number == 0:
        coin_tossed = "heads"
    else:
        coin_tossed = "tails"
    if coin_tossed == msg.choice:
        message = "You won!"
    else:
        message = "You lost!"
    await ctx.send(
        sender, UAgentResponse(message=message, type=UAgentResponseType.FINAL)
)
 
agent.include(coin_toss_protocol, publish_manifest=True)

Now click on the Run button in the upper right corner of the editor so that you have your coin toss agent up and running!

Register your coin toss agent!

Similar to the this guide ↗️, let's navigate to the Agentverse: Services ↗️ (opens in a new tab) tab to start registering your agent as a service.

After clicking the + New Service button, you will need to provide all details required. Fill the form out as follows:

• Service title: just the name of your service. In this example let's call it Coin toss service
• Description: Super important to be as detailed as you can, as reasoning engine looks at descriptions to understand what your service does. In this example we can specify something like this: Coin toss service. Takes the "heads" or "tails" input from the user and based on it decides if the user won or lost.
• Service group: the group the service belongs to. Click on the Add new Service Group option and let's create a service group with the name Use case.
• Agent: select your newly created DeltaV compatible coin toss agent agent from the list
• Task type, Protocol, Model and Field descriptions will be automatically populated based on the source code of your coin toss agent ↗️

Let's find our service on DeltaV

Now, head to DeltaV ↗️ (opens in a new tab) and sign in.

First, you will be asked to Select a service group. Let's select the Use case service group in the dropdown positioned on the upper right part of the screen as that's the one we created for this guide. After that, in the Select an objective section you can use a predefined objective, but let's click on the Something else option and type Toss a coin.

After being redirected to the chat screen, you will be asked to select a task (service). As your objective (Toss a coin) specified on the previous screen contained words related to the description of your coin toss agent ↗️, your Coin Toss service is listed as an option.

Let's select it.

After selecting the task, you will be asked if you want to pick heads or tails. The AI Engine ↗️ behind DeltaV asks this question based on the description. The choice must be heads or tails.

Select whichever option you feel like. In this case let's pick heads.

Then, you can confirm or reject the context that the AI engine is planning to execute. Let's confirm it!

After your service has been executed you can see the You won! or You lost! message.

With that, you have gotten a coin toss service which can be discovered and contacted with DeltaV. Awesome!