Skip to content

Commit

Permalink
fix(docs): changes to concepts/agentverse resources (#242)
Browse files Browse the repository at this point in the history
  • Loading branch information
FelixNicolaeBucsa authored Nov 2, 2023
1 parent 7efcbee commit 47e08f0
Show file tree
Hide file tree
Showing 11 changed files with 72 additions and 45 deletions.
21 changes: 16 additions & 5 deletions components/products.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -154,12 +154,12 @@ const items: { [key: string]: Item[] } = {
path: "/guides",
},
],
"AI Agent Services": [
"Agentverse components": [
{
title: "Agentverse Hosting",
title: "Agentverse: My Agents 🚢",
description: (
<>
The Agentverse Hosting platform enables all users to get started
The Agentverse My Agents section enables all users to get started
quickly and to deploy agents to the cloud to start connecting and
automating.
</>
Expand All @@ -168,7 +168,7 @@ const items: { [key: string]: Item[] } = {
path: "/concepts/agent-services/agent-hosting",
},
{
title: "Agentverse Mailbox",
title: "Agentverse: Mailroom / IoT Gateway 📫",
description: (
<>
Set up mailboxes for your local agents and to run them independently
Expand All @@ -178,14 +178,25 @@ const items: { [key: string]: Item[] } = {
icon: mailBoxIcon,
path: "/concepts/agent-services/agent-mail",
},
{
title: "Agentverse: Services",
description: (
<>
Create an agent encapsulating a service and register it as a service
on the Agentverse to be retrieved via DeltaV chat!
</>
),
icon: whisperAgentIcon,
path: "/guides/agentverse/registering-agent-services",
},
{
title: "Agentverse APIs",
description: <>Understand and use the Agentverse APIs.</>,
icon: apiAgentIcon,
path: "/apis/agentverse",
},
{
title: "Agentverse Explorer",
title: "Agentverse: Explorer 🤖🌐",
description: (
<>
Learn to use the Agentverse Explorer to start an interaction with
Expand Down
6 changes: 3 additions & 3 deletions pages/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ import { GuideBox } from "../components/feature-guide-tabs";

<GuideBox
content={{
title: "The Agentverse Explorer 🤖🌐",
title: "Agentverse: Explorer 🤖🌐",
description: "Use the Agentverse Explorer to start interacting with other agents.",
path: "/concepts/agent-services/agent-explorer"
}}
Expand All @@ -96,8 +96,8 @@ import { GuideBox } from "../components/feature-guide-tabs";

<GuideBox
content={{
title: "Mailroom / IoT Gateway 📫",
description: "Set up mailboxes for your locally-run agents and to run them independently of your constant presence to run the server.",
title: "Agentverse: Mailroom / IoT Gateway 📫",
description: "Set up Agentverse mailboxes for your locally-run agents and to run them independently of your constant presence to run the server.",
path: "/concepts/agent-services/agent-mail"
}}
/>
Expand Down
4 changes: 2 additions & 2 deletions pages/concepts/agent-services/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"agentverse-intro": "Introduction \uD83D\uDE80",
"why-agentverse": "Why Agentverse \uD83E\uDD14\uD83D\uDCA1",
"getting-started": "Getting started \uD83C\uDFAF",
"agent-explorer": "The Agentverse Explorer \uD83E\uDD16\uD83C\uDF10",
"agent-explorer": "Agentverse: Explorer \uD83E\uDD16\uD83C\uDF10",
"agent-hosting": "Agentverse: My Agents \uD83D\uDEA2",
"agent-mail": "Mailroom / IoT Gateway \uD83D\uDCEB"
"agent-mail": "Agentverse: Mailroom / IoT Gateway \uD83D\uDCEB"
}
27 changes: 14 additions & 13 deletions pages/concepts/agent-services/agent-explorer.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,25 @@
import { Callout } from 'nextra/components'

# The Agentverse Explorer 🤖🌐
# Agentverse: Explorer 🤖🌐

The Agentverse Explorer allows you to search and connect with other agents registered in the [Almanac ↗️](/references/contracts/uagents-almanac/almanac-overview) contract.
The **Agentverse Explorer** allows you to search and connect with other agents registered in the [Almanac ↗️](/references/contracts/uagents-almanac/almanac-overview) contract. AI Agents being developed within the Agentverse are registered in it and so can be found by anybody interested in interacting with them and their functionalities!

## Active and local agents
<Callout type="info" emoji="ℹ️">
It may be possible that users or companies may not be willing to share agents information but rather wanting to keep them private for any reason. This is achievable thanks to the possibility of _differentiating between public and private agents_. Checkout the following resource for further understanding on this topic: [Public and private agents ↗️](/concepts/agents/public-private-agents).
</Callout>

Every agent available and displayed on the Explorer is denoted by a different tag: **Active** and **Local**.
## Different types of agents

An **Active** agent is one whose registration is up-to-date on the Almanac, whereas a **Local** agent is one pointing towards a local endpoint. These local agents' utility is limited in real-world contexts, but these are very useful for testing purposes.
Every agent available and displayed on the Explorer can be a: **Hosted**, **Local**, or **Mailbox** agent.

**Hosted** agents are agents being developed on the Agentverse and correctly registered within the Almanac contract and whose registration is up-to-date, meaning that all provided information is updated. In this case the agent is denoted by a green **Active** tag. On the other hand, a **Local** agent is one pointing towards a local endpoint. These local agents' utility is limited in real-world contexts, but these are very useful for testing purposes. Finally, **Mailbox** agents are those registered within the Agentverse Mailbox service and thus are being able to send and receive messages continuously. Agents which are not online are visible as **Offline** agents.

## Look for registered agents

Each agent registered within the Almanac is identified by 3 elements which you can use to retrieve them directly, that is:
Each agent registered within the Almanac is identified by the following elements:

1. Agent **address**.
2. Agent **endpoint**.
3. Agent **protocols**.
1. Agent's **address**.
2. Agent's **protocols**.

<Callout type="info" emoji="ℹ️">
You can explore an agent's [protocols ↗️](/references/uagents/uagents-protocols/agent-protocols) by clicking on the related **Manifest** icon within the protocol's button.
Expand All @@ -26,8 +29,6 @@ Each agent registered within the Almanac is identified by 3 elements which you c

![](../../../src/images/agentverse/explorer/agentverse_explorer_concepts_2.png)

It is possible to search and retrieve any agent specifically by using one of these pieces of information. Additionally, thanks to filtering functionality, it is possible to filter agents sharing the same protocols. This may be very helpful whenever you wish to interact with a given set of sub-agents sharing similar features for your development purposes.

For instance, you may be interested in connecting your agent only with agents offering specific types of services, such as flight booking services, so to develop your idea in a more straightforward manner.
It is possible to search and retrieve any agent specifically by using one of these pieces of information. Additionally, thanks to filtering functionality, it is possible to filter agents sharing the same protocols. This may be very helpful when you wish to interact, with a given subset of agents sharing similar features, in accordance with your development purposes.

For further guidance on how to search for AI Agents, visit our Agentverse guide for [Discovering agents 🔎 ↗️](/guides/agentverse/discovering-agents).
For further guidance on how to search for AI Agents, visit our Agentverse guide for [Discovering agents on the Agentverse Explorer 🔎 ↗️](/guides/agentverse/discovering-agents) using the Agentverse Explorer.
14 changes: 8 additions & 6 deletions pages/concepts/agent-services/agent-hosting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import { Callout } from 'nextra/components'

## An agent for everyone

With the world moving every increasingly towards an automated future where technology will play a more and more central role in everyone's life, we all will require an agent to represent and help us in interacting and carry out operations with one other. The Agentverse My Agents section enables all users to get started quickly and to deploy agents to the cloud to start connecting and automating.
With the world moving every increasingly towards an automated future where technology will play a greater central role in everyone's life, we will all require an agent to represent and help us in interacting and carry out operations with one other. The **Agentverse My Agents** section enables all users to get started quickly and to deploy agents to the cloud to start connecting and automating operations in an easy and intuitive way.

![](../../../src/images/an-agent-for-everyone.png)

Expand All @@ -13,24 +13,26 @@ With the world moving every increasingly towards an automated future where techn
Deploying a new agent is quick and easy. You can have a new running agent deployed in a matter of a few clicks, and with many pre-made examples you can have an active agents doing tasks for you with ease. You can either choose to build an agent from a blank script, by clicking on **+ Agents**, or you can choose to create your agent based on a specified template, by clicking on **+ Use Case**.

<Callout type="info" emoji="ℹ️">
You can checkout the [Creating a hosted agent 🤖 ↗️](/guides/agentverse/creating-a-hosted-agent) guide to get yourself started with creating an agent within the Agentverse.
You can checkout the [Creating an Agentverse hosted agent 🤖 ↗️](/guides/agentverse/creating-a-hosted-agent) guide to get yourself started with creating an agent within the Agentverse.
</Callout>

The My Agent section manages all the important steps about making sure that your agent stays online. With a targeted 100% uptime, your agent will not sleep unless you tell it to. By it being a hosted agent on the Agentverse, the agent will always be kept up-to-date on the [Almanac ↗️](/references/contracts/uagents-almanac/almanac-overview) contract. This latter one also manages your agent private keys for you too, keeping these safe and secure.
The My Agents section manages all the important steps about making sure that your agent stays online. With a targeted 100% uptime, your agent will not sleep unless you tell it to. By it being a hosted agent on the Agentverse, the agent will always be kept up-to-date on the [Almanac ↗️](/references/contracts/uagents-almanac/almanac-overview) contract. This latter one also manages your agent private keys for you too, keeping these safe and secure.

## Scaling

The Agentverse My Agent product is designed to scale automatically with the number of messages that your agent receives. The benefit for you is that you do not have to carry the hassle of deploying your agents continuously, given that we run them for you using cloud technology. This means that your agents will continue running and receive messages without the need of your presence for them to be deployed. Thus, as a developer, you can focus on making the most awesome agent code!
The Agentverse My Agents tool is designed to scale automatically with the number of messages that your agent receives. The benefit for you is that you do not have to carry the hassle of continuously deploying your agents, given that we run them for you using cloud technology. This means that your agents will continue running and receiving messages without the need of your presence for them to be deployed. Thus, as a developer, you can focus on making the most awesome agent code!

![](../../../src/images/scaling-hosting.png)

## Secure runtime

Agents are built and run in a secure partitioned Python environment. This is important to make sure that your code is safe from malicious attempts to access your information. We also give you the option to subscribe to ban lists, in which there are agents seen as bad actors which you can ignore.
Agents are built and run in a secure partitioned Python environment. This is important to make sure that your code is safe from malicious attempts to access your information. We also give you the option to subscribe to **ban lists**, in which there are agents seen as bad actors which you can ignore easily!

## Only pay for what an agent does

Crucially to you and us, **you only pay for what you use!** An agent that only checks for an oracle value every 12 hours will be much cheaper to run that an agent which is part of a prediction model.
Crucially to you and us, **you only pay for what you use!**

An agent that only checks for an oracle value every 12 hours will be much cheaper to run that an agent which is part of a prediction model.

## Give your agent a human readable name

Expand Down
6 changes: 3 additions & 3 deletions pages/concepts/agent-services/agent-mail.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import { Callout } from 'nextra/components'

# Mailroom / IoT Gateway 📫
# Agentverse: Mailroom / IoT Gateway 📫
## The Mailroom service

The **Agentverse Mailroom service** is a useful tool dedicated to set up mailboxes for your locally-run agents. This is with the aim of not having them online all the time to communicate with one another and run them independently of your constant presence to run the server.
Expand All @@ -9,13 +9,13 @@ The **Agentverse Mailroom service** is a useful tool dedicated to set up mailbox
The Agentverse Mailroom can be of particular interest and utility whenever you find it difficult to run a server and need some sort of trusted intermediary, the Mailroom in this case, to manage incoming messages from other people directly sending them to this hosted service, so for you to download them afterwards without the need of a continuous running server for this.
</Callout>

Have a look at our [Agentverse guides ↗️](/guides#agentverse) and in particular the [Utilizing the Agentverse mailbox service 📬 ↗️](/guides/agentverse/utilising-the-mailbox) guide for a better understanding of the **registration process** and **remote communication** between different agents.
For additional information, have a look at our [Agentverse guides ↗️](/guides#agentverse) and in particular the [Utilizing the Agentverse mailbox service 📬 ↗️](/guides/agentverse/utilising-the-mailbox) guide for a better understanding of the **registration process** and **remote communication** between different agents using this tool.

![](../../../src/images/mailroom.png)

## Remote communication with the Mailroom

Through this service, communication between agents registered in the Agentverse and local agents is made possible. In fact, your locally hosted agents can access the APIs to retrieve the information needed for communicating with the other agents registered within the Agentverse.
Through the Mailbox service, communication between agents registered in the Agentverse and local agents is made possible. In fact, your locally hosted agents can access the APIs to retrieve the information needed for communicating with the other agents registered within the Agentverse.

## Improve your knowledge

Expand Down
2 changes: 1 addition & 1 deletion pages/concepts/agent-services/agentverse-intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Users operating on the Agentverse can deploy their AI agents to the Fetch.ai net
<Callout type="info" emoji="ℹ️">
The Agentverse provides an intuitive interface, making it a powerful platform for creating intelligent software agents. In fact, this platform provides an accessible and easy way to build personalizes AI Agents based on your needs, in addition to providing ways to easily engage with other registered agents to create any type of application you are thinking of!

Head over to the [Creating a hosted agent 🤖 ↗️](/guides/agentverse/creating-a-hosted-agent) guide to get yourself started with AI Agents development on the **Agentverse Agent Editor** tool in few steps!
Head over to the [Creating an Agentverse hosted agent 🤖 ↗️](/guides/agentverse/creating-a-hosted-agent) guide to get yourself started with AI Agents development on the **Agentverse Agent Editor** tool in few steps!
</Callout>

## Shape the future of automation
Expand Down
14 changes: 10 additions & 4 deletions pages/concepts/agent-services/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,21 @@ import { Callout } from 'nextra/components'

# Getting started 🎯

The Agentverse allows you to perform multiple actions and access various services.
The Agentverse allows you to perform multiple actions and access various services. Within the Agentverse you can [Explore the list of registered agents ↗️](/concepts/agent-services/agent-explorer) alongside different information including addresses and protocols, [create your own personalized agents ↗️](/concepts/agent-services/agent-hosting), [enroll your agents as services to be retrieved within DeltaV platform ↗️](/guides/agentverse/registering-agent-services), and [set up dedicated Mailboxes for your agents ↗️](/concepts/agent-services/agent-mail) to be constantly running independently of your presence!

Importantly, **you first need to sign in into your account**. You can do so by:
Importantly, **you first need to sign in with your account** to start any of these operations.

You can simply do so by:

1. Sign in with your **Google** account.
2. Sign in with **Fetch wallet**.

<Callout type="info" emoji="ℹ️">
Checkout the [Fetch wallet 💵 ↗️](/guides/fetch-network/fetch-wallet/fetch-wallet-getting-started) documentation to get a Fetch wallet if you don't have one yet!
</Callout>

Once you log in, you will be able to start interacting with the Agentverse and its services.

<Callout type="info" emoji="ℹ️">
Checkout the dedicated [Agentverse guides ↗️](/guides#agentverse) to get yourself started using this platform and develop your agents ideas.
</Callout>
Visit our [Agentverse guides ↗️](/guides#agentverse) to get yourself started using this platform, discover its functionalities and tools and start developing your agents ideas.
</Callout>
Loading

0 comments on commit 47e08f0

Please sign in to comment.