diff --git a/.github/spelling/known_words_corpus.txt b/.github/spelling/known_words_corpus.txt index be6e6cac8..50acc8ec5 100644 --- a/.github/spelling/known_words_corpus.txt +++ b/.github/spelling/known_words_corpus.txt @@ -670,3 +670,4 @@ visualisations subsidised etc lifecycle +screenshot diff --git a/pages/guides/agents/intermediate/agent-functions.mdx b/pages/guides/agents/intermediate/agent-functions.mdx index e4e045ab9..d8669912f 100644 --- a/pages/guides/agents/intermediate/agent-functions.mdx +++ b/pages/guides/agents/intermediate/agent-functions.mdx @@ -133,13 +133,13 @@ The **Description** is super important to the success of your Agent Function. Th Read more and see examples on how to properly set field descriptions by heading over to: [Field descriptions for DeltaV ↗️](/guides/services/field-descriptions-for-deltav) guide. -## Primary and Secondary Functions +## Objective Service and Sub-Service -**Primary** and **Secondary** functions are different but have strong similarities. +**Objective Service** and **Sub-Service** functions are different but have strong similarities. -A **Primary Function** is the primary Agent Function and for instance, it could be an agent that would respond to a user or be accessible via DeltaV. _Primary Functions are expected to fully or partially fulfill an objective provided by users_. +The first one is the primary Agent Function and for instance, it could be an agent that would respond to a user or be accessible via DeltaV. _Primary Functions are expected to fully or partially fulfill an objective provided by users_. -Similarly, a **Secondary Function** is an Agent Sub-function providing secondary services that likely need additional context or information to carry out the Primary Function. _Secondary Functions are executed in combination with the Objective task_. If that's the case, DeltaV would see that the Agent Primary Function can be fulfilled by executing a Secondary Function, thus, it will contact this latter one which may or may not require gaining context directly from the user. +Similarly, a **Sub-Service** function is an Agent Sub-function providing secondary services that likely need additional context or information to carry out the Primary Function. _Secondary Functions are executed in combination with the Objective task_. If that's the case, DeltaV would see that the Agent Primary Function can be fulfilled by executing a Secondary Function, thus, it will contact this latter one which may or may not require gaining context directly from the user. DeltaV supports rich text and hyperlinks, enhancing formatting and navigation within the interface. You can include hyperlinks using standard HTML tags for clickable links. For more details, refer to the [guide on rich text and hyperlinks ↗️](/guides/agentverse/agentverse-functions/hyperlinks-and-rich-text-deltav). diff --git a/pages/guides/agentverse/agentverse-functions/field-descriptions-for-deltav.mdx b/pages/guides/agentverse/agentverse-functions/field-descriptions-for-deltav.mdx index 7dc12100e..28ccd9bea 100644 --- a/pages/guides/agentverse/agentverse-functions/field-descriptions-for-deltav.mdx +++ b/pages/guides/agentverse/agentverse-functions/field-descriptions-for-deltav.mdx @@ -12,11 +12,29 @@ For clarity, reinforcing key concepts could be done through repetition of keywor Consider the following Agent Function: -![](src/images/guides/services/the-importance-of-descriptions/description_1.png) +![](src/images/guides/agentverse/registering-agent-coin-toss/new-service-dialog.png) -Providing a detailed field description for the `num_rolls` data `Model` is important to correctly execute the Function. A well written field description enhances the LLM understanding of the type of Function the user objective requires to be executed. This would help in the accurate interpretation and execution of users' requests. +Providing a detailed field description for the `num_rolls` data `Model` is important to correctly execute the Function. A well written field description enhances the LLM understanding of the type of Function and the user objective requires to be executed. This would help in the accurate interpretation and execution of users' requests. -**It is possible to call additional Secondary Functions from Primary or Secondary ones by specifying this within the field description itself**. For Primary and Secondary Functions network, please refer to the below examples. +It is possible to call additional other **Sub-Services** from either **Objective or other Sub-Services** by specifying this within the field description itself. For additional information on Objective Service and Sub-Service, check the following [resource ↗️](/guides/services/services#primary-and-secondary-functions) + +For a network of Objective Services and Sub-Services, please refer to the below examples. + +## Auto-description functionality + +It is possible for you to generate **auto-descriptions** for your Functions when it comes to deploy them on Agentverse. + +You can make use of this functionality by opening your Agent's details by clicking on the Agent's box within the list of Agents available in **My Agents** tab in Agentverse. Then, head over to the **Deploy** tab as shown below: + +![](src/images/guides/agentverse/autodescriptions_initial.png) + +Here, you will need to either create a **New Function** or **edit an existing one**. This way, you will open your Agent's Function editor, and you will be able to provide/edit the description for what that Function does. It is here where you can make use of the auto-description functionality to fill in such field. At the moment, this functionality is available just for the **Function Description**, but it will be available for **Fields** description at a later stage. + +Check out the following screenshot to have a better idea: + +![](src/images/guides/agentverse/autodescriptions.png) + +By clicking the **Refine** button, the [AI Engine ↗️](/concepts/ai-engine/ai-engine-intro) will automatically generate a description based on the Function details you have provided. You can either provide an initial prompt within the **Description** field to be then refined, or you can auto-generate a description from a nothing and the AI Engine will do this for you by itself. ### Example 1: News Reading System @@ -30,7 +48,7 @@ This Function helps user to read news of a specific type. This Function calls a ![](src/images/guides/services/the-importance-of-descriptions/description_2.png) -The field description for the `news` data model describes the news that will be presented to the user. It should be mentioned that it should be always provided by triggering of Secondary Function. In our case, a good field description would be: **Describes the news which will be generate from the "Generate News" secondary function. Always go for "Generate News" secondary function only never ask this field from user. All the news articles generated are presented as strings**. +The field description for the `news` data model describes the news that will be presented to the user. It should be mentioned that it should be always provided by triggering of Secondary Function. In our case, a good field description would be: **Describes the news which will be generated from the "Generate News" secondary function. Always go for "Generate News" secondary function only never ask this field from user. All the news articles generated are presented as strings**. #### Secondary Function Field Description @@ -38,7 +56,7 @@ This Function helps task to generate news and send it to task or another Seconda ![](src/images/guides/services/the-importance-of-descriptions/description_3.png) -The field description for the `category` data model describes the category for which the user wants to read the news. It should be mentioned that it should be always provided by user. In our case, a good field description would be: **Describes the category provided by user about which he want to get news for. This should always be provided by user in all cases. This primary function responds to "Generate News" secondary function. This should be from options business, entertainment, general, health, science, sports, technology**. +The field description for the `category` data model describes the category for which the user wants to read the news. It should be mentioned that it should be always provided by user. In our case, a good field description would be: **Describes the category provided by user about which he wants to get news for. This should always be provided by user in all cases. This primary function responds to "Generate News" secondary function. This should be from options business, entertainment, general, health, science, sports, technology**. _Remember to always include the secondary function trigger in the field description_. This is very important to ensure that the secondary function is being called. When selecting one of multiple secondary functions, you need to use different names for each one of the functions. This way, we avoid confusion for the LLM. @@ -65,7 +83,7 @@ The field description for the `response` describes the response to be provided t Ideal field description for this example will be like: **model_id:** Always go for model list secondary function. Never ask this field to user. -**query:** Describes the query user wants to ask to the model. Always ask this to user after model_id is given by model list secondary function. +**query:** Describes the query user wants to ask the model. Always ask this to user after model_id is given by model list secondary function. Remember to always provide a comprehensive description in `query` field that first we should fetch `model_id` using secondary function before asking `query` to user. @@ -103,14 +121,15 @@ Ideal field descriptions for this example will be like: **location:** This describes the coordinates of the city given in str(lat,long) format. -![](src/images/guides/services/service-guide/business_finder_2.png) + ![](src/images/guides/services/service-guide/business_finder_2.png) 2. **Business Finder**: This secondary function takes category and city from the primary function and looks around for 10 business name in that area. Asks user to select one and then sends back to task as name field. -**category:** This is the category provided by the user for which they want to get businesses in primary function business details service, Use this category for task as well. -**city:** This is the city responded by city finder or one given by user. + **category:** This is the category provided by the user for which they want to get businesses in primary function business details service, Use this category for task as well. + + **city:** This is the city responded by city finder or one given by user. -![](src/images/guides/services/service-guide/business_finder_3.png) + ![](src/images/guides/services/service-guide/business_finder_3.png) ## Agent Function registration examples diff --git a/pages/guides/agentverse/agentverse-functions/registering-agent-services.mdx b/pages/guides/agentverse/agentverse-functions/registering-agent-services.mdx index 25dedf596..a22f639a1 100644 --- a/pages/guides/agentverse/agentverse-functions/registering-agent-services.mdx +++ b/pages/guides/agentverse/agentverse-functions/registering-agent-services.mdx @@ -101,7 +101,7 @@ There's a little to unpack here, but it's quite simple: - **Function title**: just the name of your Agent Function. - **Description**: super important to be as detailed as you can, as reasoning AI Engine looks at descriptions to understand what your Agent Function does. - - **Application**: Primary or Secondary Function. For a detailed definition, check [here ↗️](/guides/services/services#primary-and-secondary-functions) + - **Application**: Objective Service or Sub-Service. For a detailed definition, check [here ↗️](/guides/services/services#primary-and-secondary-functions) - **Protocol**: it's defined in your `Agent`. - **Model**: again, we defined that in `simple_protocol.py`. - **Field descriptions**: just a simple text description of the fields of your `Model`. diff --git a/pages/guides/agentverse/creating-agentverse-agents/simple-dice-roll-agent.mdx b/pages/guides/agentverse/creating-agentverse-agents/simple-dice-roll-agent.mdx index 2941820a5..530787b27 100644 --- a/pages/guides/agentverse/creating-agentverse-agents/simple-dice-roll-agent.mdx +++ b/pages/guides/agentverse/creating-agentverse-agents/simple-dice-roll-agent.mdx @@ -1,4 +1,4 @@ -# Creating a simple dice roll agent on agentverse +# Creating a simple dice roll agent on Agentverse ## Introduction @@ -15,7 +15,7 @@ Make sure you have read the following resources before going on with this guide: - [Agents address ↗️](/guides/agents/getting-started/getting-uagent-address) - [Almanac contract ↗️](/concepts/fetch-network/almanac) - [Register in Almanac ↗️](/guides/agents/register-in-almanac) - - [Agents running on agentverse↗️](/guides/agents/intermediate/hosted-agent) + - [Agents running on Agentverse ↗️](/guides/agents/intermediate/hosted-agent) ## Create your dice roll agent! @@ -68,4 +68,4 @@ Check out the following resources to better grasps all of these concepts: - [Agentverse Functions ↗️](/guides/agents/intermediate/agent-functions). - [Agentverse Functions: register your Agents Functions on the Agentverse! ↗️](/guides/agentverse/agentverse-functions/registering-agent-services). - - [Agentverse Functions: register a coin toss agent as a Function 🪙 ↗️](/guides/agentverse/agentverse-functions/registering-agent-coin-toss). + - [Agentverse Functions: register a coin toss agent as a Function ↗️](/guides/agentverse/agentverse-functions/registering-agent-coin-toss). diff --git a/src/images/agentverse/create-agent/agentverse-myagent_1.png b/src/images/agentverse/create-agent/agentverse-myagent_1.png index 9961d12c2..6d61c44da 100644 Binary files a/src/images/agentverse/create-agent/agentverse-myagent_1.png and b/src/images/agentverse/create-agent/agentverse-myagent_1.png differ diff --git a/src/images/agentverse/create-agent/agentverse-myagent_3.png b/src/images/agentverse/create-agent/agentverse-myagent_3.png index d117a8825..5a80e23fe 100644 Binary files a/src/images/agentverse/create-agent/agentverse-myagent_3.png and b/src/images/agentverse/create-agent/agentverse-myagent_3.png differ diff --git a/src/images/agentverse/create-agent/agentverse-myagent_4.png b/src/images/agentverse/create-agent/agentverse-myagent_4.png index adef1b7d0..2fd4973f1 100644 Binary files a/src/images/agentverse/create-agent/agentverse-myagent_4.png and b/src/images/agentverse/create-agent/agentverse-myagent_4.png differ diff --git a/src/images/agentverse/create-agent/agentverse-myagent_5.png b/src/images/agentverse/create-agent/agentverse-myagent_5.png index 684e6efbd..5973d558b 100644 Binary files a/src/images/agentverse/create-agent/agentverse-myagent_5.png and b/src/images/agentverse/create-agent/agentverse-myagent_5.png differ diff --git a/src/images/agentverse/explorer/agentverse-explorer_1.png b/src/images/agentverse/explorer/agentverse-explorer_1.png index 60f8b24ec..6dcb78101 100644 Binary files a/src/images/agentverse/explorer/agentverse-explorer_1.png and b/src/images/agentverse/explorer/agentverse-explorer_1.png differ diff --git a/src/images/guides/101/sentimentagent_agent_overview.png b/src/images/guides/101/sentimentagent_agent_overview.png index eb9e20515..91936ddaf 100644 Binary files a/src/images/guides/101/sentimentagent_agent_overview.png and b/src/images/guides/101/sentimentagent_agent_overview.png differ diff --git a/src/images/guides/agentverse/agentverse_intro.png b/src/images/guides/agentverse/agentverse_intro.png index 7e9e39c01..c93fb085c 100644 Binary files a/src/images/guides/agentverse/agentverse_intro.png and b/src/images/guides/agentverse/agentverse_intro.png differ diff --git a/src/images/guides/agentverse/autodescriptions.png b/src/images/guides/agentverse/autodescriptions.png new file mode 100644 index 000000000..9303735a5 Binary files /dev/null and b/src/images/guides/agentverse/autodescriptions.png differ diff --git a/src/images/guides/agentverse/autodescriptions_initial.png b/src/images/guides/agentverse/autodescriptions_initial.png new file mode 100644 index 000000000..a8f6581aa Binary files /dev/null and b/src/images/guides/agentverse/autodescriptions_initial.png differ diff --git a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_1.png b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_1.png index 123e7265f..3debc95b4 100644 Binary files a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_1.png and b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_1.png differ diff --git a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_2.png b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_2.png index 201237a6a..f3b23578e 100644 Binary files a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_2.png and b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_2.png differ diff --git a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_3.png b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_3.png index c3f68fd16..65627ad8a 100644 Binary files a/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_3.png and b/src/images/guides/agentverse/mailbox/agentverse:mailbox/mailbox_3.png differ diff --git a/src/images/guides/agentverse/mailbox/mailbox_1.png b/src/images/guides/agentverse/mailbox/mailbox_1.png index ebf19c511..f5107571d 100644 Binary files a/src/images/guides/agentverse/mailbox/mailbox_1.png and b/src/images/guides/agentverse/mailbox/mailbox_1.png differ diff --git a/src/images/guides/agentverse/mailbox/mailbox_2.png b/src/images/guides/agentverse/mailbox/mailbox_2.png index ad306acd6..16defd32a 100644 Binary files a/src/images/guides/agentverse/mailbox/mailbox_2.png and b/src/images/guides/agentverse/mailbox/mailbox_2.png differ diff --git a/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-in-list.png b/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-in-list.png index 35c1b8886..273fb6ed2 100644 Binary files a/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-in-list.png and b/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-in-list.png differ diff --git a/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-use-case-button.png b/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-use-case-button.png index c3bd18a2c..626908506 100644 Binary files a/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-use-case-button.png and b/src/images/guides/agentverse/registering-agent-coin-toss/hosted-agent-use-case-button.png differ diff --git a/src/images/guides/agentverse/registering-agent-coin-toss/new-service-dialog.png b/src/images/guides/agentverse/registering-agent-coin-toss/new-service-dialog.png index 8b728b0d0..86517db81 100644 Binary files a/src/images/guides/agentverse/registering-agent-coin-toss/new-service-dialog.png and b/src/images/guides/agentverse/registering-agent-coin-toss/new-service-dialog.png differ diff --git a/src/images/guides/agentverse/registering-agent-coin-toss/run-hosted-agent.png b/src/images/guides/agentverse/registering-agent-coin-toss/run-hosted-agent.png index 8485c6e6a..ced4c9c36 100644 Binary files a/src/images/guides/agentverse/registering-agent-coin-toss/run-hosted-agent.png and b/src/images/guides/agentverse/registering-agent-coin-toss/run-hosted-agent.png differ diff --git a/src/images/guides/agentverse/registering-agent-dice-roll/hosted-agent-in-list.png b/src/images/guides/agentverse/registering-agent-dice-roll/hosted-agent-in-list.png index cf56f93ea..cef0ffe05 100644 Binary files a/src/images/guides/agentverse/registering-agent-dice-roll/hosted-agent-in-list.png and b/src/images/guides/agentverse/registering-agent-dice-roll/hosted-agent-in-list.png differ diff --git a/src/images/guides/agentverse/registering-agent-dice-roll/new-service-dialog.png b/src/images/guides/agentverse/registering-agent-dice-roll/new-service-dialog.png index 8816a836b..0b577fac6 100644 Binary files a/src/images/guides/agentverse/registering-agent-dice-roll/new-service-dialog.png and b/src/images/guides/agentverse/registering-agent-dice-roll/new-service-dialog.png differ diff --git a/src/images/guides/agentverse/registering-agent-dice-roll/run-hosted-agent.png b/src/images/guides/agentverse/registering-agent-dice-roll/run-hosted-agent.png index ff3ec8e0d..5416f9f9b 100644 Binary files a/src/images/guides/agentverse/registering-agent-dice-roll/run-hosted-agent.png and b/src/images/guides/agentverse/registering-agent-dice-roll/run-hosted-agent.png differ diff --git a/src/images/guides/services/service-guide/business_finder_1.png b/src/images/guides/services/service-guide/business_finder_1.png index 2dd8fb151..7b15bac96 100644 Binary files a/src/images/guides/services/service-guide/business_finder_1.png and b/src/images/guides/services/service-guide/business_finder_1.png differ diff --git a/src/images/guides/services/service-guide/business_finder_2.png b/src/images/guides/services/service-guide/business_finder_2.png index 49c7b5509..9cdf32f83 100644 Binary files a/src/images/guides/services/service-guide/business_finder_2.png and b/src/images/guides/services/service-guide/business_finder_2.png differ diff --git a/src/images/guides/services/service-guide/business_finder_3.png b/src/images/guides/services/service-guide/business_finder_3.png index afc99ee1d..2569c61f4 100644 Binary files a/src/images/guides/services/service-guide/business_finder_3.png and b/src/images/guides/services/service-guide/business_finder_3.png differ diff --git a/src/images/guides/services/service-guide/hugging_face_1.png b/src/images/guides/services/service-guide/hugging_face_1.png index de055bf6c..e40cfbec3 100644 Binary files a/src/images/guides/services/service-guide/hugging_face_1.png and b/src/images/guides/services/service-guide/hugging_face_1.png differ diff --git a/src/images/guides/services/service-guide/hugging_face_2.png b/src/images/guides/services/service-guide/hugging_face_2.png index 6a847b2a1..c14080a65 100644 Binary files a/src/images/guides/services/service-guide/hugging_face_2.png and b/src/images/guides/services/service-guide/hugging_face_2.png differ diff --git a/src/images/guides/services/service-guide/hugging_face_3.png b/src/images/guides/services/service-guide/hugging_face_3.png index 4b7cb545b..0d7b4e388 100644 Binary files a/src/images/guides/services/service-guide/hugging_face_3.png and b/src/images/guides/services/service-guide/hugging_face_3.png differ diff --git a/src/images/guides/services/service-guide/simple_protocol_0.png b/src/images/guides/services/service-guide/simple_protocol_0.png index f4a30bb0c..eb600282a 100644 Binary files a/src/images/guides/services/service-guide/simple_protocol_0.png and b/src/images/guides/services/service-guide/simple_protocol_0.png differ diff --git a/src/images/guides/services/service-guide/simple_protocol_1.png b/src/images/guides/services/service-guide/simple_protocol_1.png index 3da01576c..dcb3ad74e 100644 Binary files a/src/images/guides/services/service-guide/simple_protocol_1.png and b/src/images/guides/services/service-guide/simple_protocol_1.png differ diff --git a/src/images/guides/services/the-importance-of-descriptions/description_2.png b/src/images/guides/services/the-importance-of-descriptions/description_2.png index 86fbe596d..aa6775d48 100644 Binary files a/src/images/guides/services/the-importance-of-descriptions/description_2.png and b/src/images/guides/services/the-importance-of-descriptions/description_2.png differ diff --git a/src/images/guides/services/the-importance-of-descriptions/description_3.png b/src/images/guides/services/the-importance-of-descriptions/description_3.png index 53790a4b5..98b836b58 100644 Binary files a/src/images/guides/services/the-importance-of-descriptions/description_3.png and b/src/images/guides/services/the-importance-of-descriptions/description_3.png differ diff --git a/src/images/guides/uagent/langchain_function.png b/src/images/guides/uagent/langchain_function.png index d14c59a7e..ea7b6aa96 100644 Binary files a/src/images/guides/uagent/langchain_function.png and b/src/images/guides/uagent/langchain_function.png differ diff --git a/src/images/guides/uagent/servicefordungeons_3.png b/src/images/guides/uagent/servicefordungeons_3.png index a9ef8dd29..0e38f21e0 100644 Binary files a/src/images/guides/uagent/servicefordungeons_3.png and b/src/images/guides/uagent/servicefordungeons_3.png differ