{"id":4555,"date":"2025-08-20T12:39:30","date_gmt":"2025-08-20T12:39:30","guid":{"rendered":"https:\/\/www.arivonix.com\/techsupport\/docs\/developing-a-tool-using-tool-designer\/"},"modified":"2026-02-26T10:00:11","modified_gmt":"2026-02-26T10:00:11","password":"","slug":"developing-a-tool-using-tool-designer","status":"publish","type":"docs","link":"https:\/\/www.arivonix.ai\/documentation\/docs\/developing-a-tool-using-tool-designer\/","title":{"rendered":"Developing a Tool Using Tool Designer"},"content":{"rendered":"<section class=\"documentation-content\">\n<h1>Developing a Tool Using Tool Designer<\/h1>\n<p>Create custom tools with specific functionality using the Tool Designer&#8217;s Code Runner feature in Arivonix.<\/p>\n<h2>Accessing the Tool Designer<\/h2>\n<p>To access and work with the Tool Designer:<\/p>\n<ol>\n<li>Log into the Arivonix application.<\/li>\n<li>Navigate to <strong>AI forge Studio<\/strong>.<\/li>\n<li>Select the <strong>Tools Designer<\/strong> tab.<\/li>\n<li>Search for your desired tool or create a new one.<\/li>\n<\/ol>\n<p>This guide uses a pre-created tool named <strong>Named Entity Recognition<\/strong>, which is a <strong>Code Runner<\/strong> tool developed using Python functions.<\/p>\n<h2>Editing a Code Runner Tool<\/h2>\n<ol>\n<li>Locate your tool in the Tool Designer.<\/li>\n<li>Click on <strong>Edit<\/strong> for the Code Runner tool.<\/li>\n<li>This opens the editing interface.<\/li>\n<\/ol>\n<h2>Working with Code Cells<\/h2>\n<p>When the Code Runner opens, you will see predefined cells with template code:<\/p>\n<p><img decoding=\"async\" class=\"img-fluid img-screenshot\" src=\"\/documentation\/tech-image\/Tech\/Develop_Tool_CodeRunner_Python\/image_119.32.png\/\" alt=\"Relevant visual\" \/><\/p>\n<ol>\n<li>Click on a cell to select it.<\/li>\n<li>Use the <strong>Run<\/strong> button to execute the selected cell.<\/li>\n<\/ol>\n<h3>Tool Structure<\/h3>\n<ul>\n<li><strong>Tools Parameters Class<\/strong>: Define any parameters needed for the tool.\n<ul>\n<li>Example: Adding a mandatory parameter called <strong>Type<\/strong>.<\/li>\n<li>Parameter values are accepted from users when the tool is used.<\/li>\n<\/ul>\n<\/li>\n<li><strong>Input Record and Output Record Classes<\/strong>: Predefined classes that typically don&#8217;t need modification.<\/li>\n<li><strong>Execute Method<\/strong>: The main method where custom logic is implemented.<\/li>\n<\/ul>\n<h2>Installing External Packages<\/h2>\n<p>To add external packages required by your tool:<\/p>\n<ol>\n<li>Add a new cell with a pip install command (e.g., for NLTK package).<\/li>\n<li>Click the <strong>Run<\/strong> button to install the package.<img decoding=\"async\" class=\"img-fluid img-screenshot\" src=\"\/documentation\/tech-image\/Tech\/Develop_Tool_CodeRunner_Python\/image_274.28.png\/\" alt=\"Relevant visual\" \/><\/li>\n<\/ol>\n<h2>Adding Custom Code<\/h2>\n<ol>\n<li>To add a new cell, click the <strong>Plus<\/strong> button.<img decoding=\"async\" class=\"img-fluid img-screenshot\" src=\"\/documentation\/tech-image\/Tech\/Develop_Tool_CodeRunner_Python\/image_302.73.png\/\" alt=\"Relevant visual\" \/><\/li>\n<li>Create necessary methods for your tool&#8217;s functionality (e.g., <code>LabelInputText<\/code> method for named entity recognition).<\/li>\n<li>Modify the <strong>Execute<\/strong> method to process inputs and return results.<\/li>\n<li>Run the cell to test the method with sample inputs.<\/li>\n<\/ol>\n<h2>Understanding Tool Inputs<\/h2>\n<p>The Code Runner tool can process three types of inputs:<\/p>\n<ol>\n<li><strong>Source Input<\/strong>: When a tool is used inside the Agentic AI Designer within Dataforge Studio&#8217;s Pipeline Designer, the input to the agent is considered the source input.<\/li>\n<li><strong>Workflow Input<\/strong>: Parameters added to an agent for its execution. Use workflow inputs to utilize any Agentic parameters inside the tool runner.<\/li>\n<li><strong>Records Input<\/strong>: Data passed from previous nodes in an Agentic AI Designer workflow. For example, when a previous node returns a list of strings as input to the current tool.<\/li>\n<\/ol>\n<h2>Saving and Versioning<\/h2>\n<ol>\n<li>After completing development, click the <strong>Save<\/strong> button at the top to save your code.<img decoding=\"async\" class=\"img-fluid img-screenshot\" src=\"\/documentation\/tech-image\/Tech\/Develop_Tool_CodeRunner_Python\/image_649.00.png\/\" alt=\"Relevant visual\" \/><\/li>\n<li>View the list of saved versions in the top right corner.<\/li>\n<li>To roll back to a previous version, click on the appropriate version.<img decoding=\"async\" class=\"img-fluid img-screenshot\" src=\"\/documentation\/tech-image\/Tech\/Develop_Tool_CodeRunner_Python\/image_670.97.png\/\" alt=\"Relevant visual\" \/><\/li>\n<\/ol>\n<h2>Summary<\/h2>\n<p>The Tool Designer provides a structured environment for developing custom tools with:<\/p>\n<ul>\n<li>Predefined code templates that can be customized with specific logic.<\/li>\n<li>Multiple input types for seamless integration with the Agentic AI Designer.<\/li>\n<li>Code saving and versioning capabilities for managing development changes.<\/li>\n<\/ul>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>Developing a Tool Using Tool Designer Create custom tools with specific functionality using the Tool Designer&#8217;s Code Runner feature in Arivonix. Accessing the Tool Designer To access and work with the Tool Designer: Log into the Arivonix application. Navigate to AI forge Studio. Select the Tools Designer tab. Search for your desired tool or create [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[155],"doc_tag":[],"class_list":["post-4555","docs","type-docs","status-publish","hentry","doc_category-tools"],"year_month":"2026-04","word_count":444,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Hari","author_nicename":"hari","author_url":""},"doc_category_info":[{"term_name":"Tools Designer","term_url":"https:\/\/www.arivonix.ai\/documentation\/docs-category\/tools\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/docs\/4555","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/comments?post=4555"}],"version-history":[{"count":1,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/docs\/4555\/revisions"}],"predecessor-version":[{"id":5198,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/docs\/4555\/revisions\/5198"}],"wp:attachment":[{"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/media?parent=4555"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/doc_category?post=4555"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.arivonix.ai\/documentation\/wp-json\/wp\/v2\/doc_tag?post=4555"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}