This is a step-by-step guide to create, test, and publish an Agent.
First, log in to the Glob.AI OS. In the Navigation header, select the Organization and Project you want to work with. In this case, Demo as the Organization and Documentation as the Project are used. Then, from the Hub selector, select Agentic Hub.
Next, on the left side of the screen, locate the Side Menu. In this menu, click on Build > Agents.
The Agents Dashboard opens in the central working area of the Agentic Hub.
Once inside the Agents Dashboard, you can create an Agent using one of the following three methods:
- New Agent with Iris: For a more intuitive and streamlined experience, the Agentic Hub provides an assisted creation method guided by Iris, the integrated Agent. Describe what you want the Agent to do, and Iris will help you configure key fields such as AI Model, Reasoning Strategy, and appropriate Integrations.
- Import Agent: Import a LabPackage file, which can include an Agent and its resources (Integrations or other Agents).
- New Agent Manually: Full control over your Agent’s configuration. Define specific tasks, select appropriate Integrations, and fine-tune the Agent's behavior to precisely match your requirements.
To begin, select one of the options and click on the corresponding button or link:
- In the New Agent with Iris card, click on the Start with Iris button.
- In the Import Agent card, click on the Import Agent button.
- Under New Agent Manually, click on the Start from scratch link.
If you selected Import Agent in Step 2, the LabPackage already includes the Agent’s purpose. Otherwise, define the purpose using one of the following options:
- 3.1. New Agent with Iris
- 3.2. New Agent Manually
Selecting New Agent with Iris automatically opens a chat window with Iris, the AI Agent, as shown below:
At this stage, you can provide Iris with details about your Agent via chat, including:
- Name: Give your Agent a descriptive name (e.g., "Customer Support Agent" or "Data Analysis Assistant").
- Role: Describe the primary function of your Agent (e.g., "Assist customers with product inquiries" or "Analyze sales data to identify trends").
- Purpose: Explain the overall goal you want your Agent to achieve (e.g., "Improve customer satisfaction" or "Provide data-driven insights to the sales team").
Suppose you want to create a marketing research Agent. In the chat window, you could type:
"I want to create an agent named 'Marketing Research Agent' Its role is to analyze market trends and competitor activities in the technology industry. The purpose is to provide the marketing team with data-driven insights to inform our marketing strategies and campaigns."
Once you've provided Iris with this information, press Enter or click on the arrow button to send your message.
Selecting New Agent Manually opens the Configuration tab, where you can define essential details about your Agent.
- Name: For example, "Marketing Research Agent". Only alphanumeric characters, spaces, hyphens, and underscores are allowed. If you enter an unsupported character, an error message appears and the Create Agent button stays disabled until you remove it.
- Role: Specify it clearly, such as "Analyzes market trends and competitor activities in the technology industry".
- Purpose: Clearly outline your Agent's objective, such as "Agent designed to provide data-driven insights for marketing strategies and campaigns".
In this example, the same Agent described in step 3.1 is defined, where Iris was instructed to "create a Marketing Research Agent".
Note that even when choosing the manual creation method, a chat panel remains available on the left side of the screen. You can still interact with Iris in this panel to receive suggestions or assistance while configuring your Agent. You can describe the Agent you want to build, ask questions, or request help completing certain fields, making the manual process more flexible and guided if needed.
Take a moment to review, complete, and finalize your configuration depending on your creation method:
- 4.1. New Agent with Iris: Review Agent Details
- 4.2. Import Agent: Review and Customize
- 4.3. New Agent Manually: Configure and Customize
If you created your Agent using Iris, the system will automatically fill in all the necessary details for your Agent based on your conversation with Iris.
Review the following:
- Configuration tab: This tab focuses on defining your Agent's identity and behavior. Here you should check:
- Name, Role, and Purpose: Verify that these core elements accurately reflect your instructions to Iris.
- Avatar Image: Optionally, you can generate an avatar image based on the Agent’s name and description. To do this, click on Generate image.
- Background Knowledge and Guidelines: Iris can automatically fill in these fields with suggested data and rules. Review and adjust them as needed. Keep in mind that at least one of these two fields must be completed before publishing the Agent.
- Examples: Iris may provide examples of how to interact with your Agent. Review these to ensure they align with your expectations.
- AI & Tools tab: While Iris handles the initial configuration, it's good practice to review the AI & Tools tab. Here, you can check the selected AI Model, Reasoning Strategy, and enabled Integrations.
- JSON tab: Automatically reflects all configuration changes you make, providing a structured view of your Agent's setup.
Although Iris takes care of the initial setup, you retain full control over your Agent's configuration. You can make adjustments in two ways:
- Direct editing: Modify settings directly within each tab. You can experiment with different AI Models and Reasoning Strategies or adjust the enabled Integrations to optimize your Agent's performance.
- Iris Guidance: If you are unsure about a specific setting or need assistance, Iris is ready to help. In the chat panel on the left, describe the changes you want to make or ask specific questions. Iris can guide you through the options, explain the implications of different settings, and even make the adjustments for you within the configuration.
When importing a LabPackage, The Lab automatically completes all the Agent's data. However, it is advisable to review the three tabs and adjust any details as necessary:
- Configuration: Validates the Name, Role, Purpose, and other details.
- AI & Tools: Checks the AI Model, Reasoning Strategy, and associated Integrations.
- JSON: Reviews the complete Agent definition with the settings you have configured.
If you have created your Agent Manually, you have full control over its configuration. Make sure to configure the following:
- Generate Avatar Image (Optional): You may generate an avatar image for your Agent.
- Background Knowledge and Guidelines: Provide any relevant context or specific instructions to guide your Agent's behavior. You must complete at least one of these two fields, as they inform the Agent what to do and how to respond. If both fields are empty, the Agent cannot be Saved.
For this case, it is useful to combine context and response rules, so you can fill in the following information:
- Background Knowledge: You are a Marketing Research Agent, specializing in analyzing market trends and competitor activities in the technology industry. Your goal is to provide the marketing team with data-driven insights to guide their strategies and campaigns.
- Guidelines:
- Analyze the information in two sections: Market Trends and Competitive Analysis.
- Include key figures (market size, CAGR, share) whenever available.
- Mention the source or year of the data in parentheses.
- Summarize the findings in no more than 200 words.
- If data is missing, indicate "Data not available" instead of speculating.
- Maintain a professional and concise tone.
- Provide Examples (Optional): Add a few examples of how you intend to interact with the Agent. This helps refine its understanding of your requests.
For example, you can add the following information:
- Input Data: What are the current trends in AI technology?
- Output Data: Market trends: Adoption of generative models in healthcare and finance is growing; global investment in AI is projected to reach $200 billion by 2025 (CAGR 18%). Competitive analysis: OpenAI leads with GPT-4o; Google promotes Gemini; Anthropic focuses on model alignment.
-
Configure AI & Tools tab: Navigate to the AI & Tools tab. Select a suitable AI Model (for example, gpt-4o) and Reasoning Strategy (for example, Chain of Thought) that align with your Agent's purpose. Consider the complexity of the tasks you want your Agent to perform and choose a model that can handle them effectively.
If you want consumers to upload files when interacting with this Agent, make sure you enable Allow users to upload files (jpeg, jpg, gif, png, pdf, txt, doc, docx, odt, rtf, ppt, pptx up to 40 MB).
From the Tools and Agents section in the AI & Tools Tab, you can add Tools that belong to any Integration configured in the Project. Click + Add to open the Tool selection dialog and choose the specific Tools you want the Agent to use. You can select a single Tool or multiple Tools, even if they come from different Integrations.
In that dialog, you can apply a filter to show only Tools (Public). For the Marketing Research Agent, make sure that the following Public Integrations are enabled:
These Tools are enabled by default in Agentic Hub and allow the Agent to efficiently extract and analyze online data.
If you created your Agent using Iris or imported it, will automatically fill in all the data. After confirming the settings, click on the Run Test button in the lower-right corner of the screen to test your Agent.
If you created your Agent manually, after clicking on the Create Agent button, an on-screen confirmation message will appear indicating that your Agent has been successfully created. At the bottom right, the Create Agent button changes to Save, and the Publish and Run Test buttons become available. To start testing your Agent, click on Run Test.
In any case, when you click on Run Test, a chat window opens on the right side of your screen. Here, you can interact directly with your Agent, test its capabilities, evaluate its responses, and ensure it operates as intended. If you click on the attachment icon below the message box, you can also upload content as a File, Image, Video, or Audio for the Agent to use during the test.
If you're ever unsure about what your Agent is doing or encounter issues, you can click on the Debug tab.
For each message you send, a sequence of steps is recorded:
- PopulateLLMRequest
- FunctionTable
- initial-message
These allow you to review the data that the Agent sends to the model, view the functions available to the Agent, and check the initial messages sent to the model.
When the Agent invokes a Tool, Debug adds a block per call:
- function-call:<Tool_name> – The request that the Agent sends to the Tool.
- message – The response that the Tool returns.
In this case, a single message was sent, generating the base steps (PopulateLLMRequest, FunctionTable, initial-message) and multiple Tool invocations: two calls to web_search_get and three calls to web_scraper_post. Each function-call is followed by its corresponding message block containing the Tool's response.
In the top bar, you will find the following:
-
Enables or disables the preview of each step the Agent executes while responding. This option is enabled by default and appears only after a message has been sent and the conversation contains Tool calls.
-
Allows you to download a JSON file containing the complete debug log (messages, model calls, and metadata) for the current conversation.
-
Opens the options menu, where you can select Clear conversation to delete the current chat and start a new one.
-
Closes the chat window.
When you have adjusted your Agent and are ready to test it, follow these steps:
- At the top of the chat, you will see "Reset conversation to test latest changes". Click there to start a fresh conversation and validate the new settings (you can also choose ... > Clear conversation).
- If something goes wrong, make the necessary changes and restart the conversation before testing again.
When a consumer interacts with an Agent from the Run or Workspace, they can share the conversation they are having with the Agent via a link. Anyone who accesses that link can view the conversation history up to the shared point and continue it from there.
To enable this feature, click on the three-dots menu in the upper-right corner of the Agent and select Chat sharing settings. A pop-up window will open with the following options:
- None: The conversation cannot be shared via a link.
- Anonymous: Allows the conversation to be shared via a public link.
You must select Anonymous to allow a consumer to share their conversation. In this case, anyone with the link will be able to access the conversation under the following conditions:
- Access is anonymous and does not require login.
- The shared conversation expires based on time and/or number of interactions.
- Interactions made from the link are not saved in the history. If the page is reloaded or closed, the conversation progress will be lost. The original shared history will remain available as long as the link is valid.
More information: Sharing a conversation with an Agent with other consumers via a link.
You can configure how the Agent will be introduced to consumers once it is published in the Workspace. The presentation defines what consumers see before starting the interaction and helps set the right context.
In Introduction, you can add a short welcome message, such as "Your marketing research agent is ready to help".
In Description, include a brief explanation of the Agent’s purpose; for example, "Provides data-driven analysis of market trends and competitor activities to support business decisions".
In Conversation Starters, you can suggest initial questions to guide the consumer. For example:
- Starter Title: Market trends
- Starter Prompt: What are the latest market trends in the technology industry?
In Features, highlight the key strengths of the Agent. For example:
- Feature Title: Market trend analysis
- Feature Description: Generates clear and concise insights on current trends supported by data.
For more details on each field and configuration option, see Configuration Tab of an Agent.
Once you have tested your Agent and verified that it works correctly, you can proceed with saving it. To do so, go to the bottom-right corner of the screen and click on the Save button.
Saving the Agent makes it available in the Workspace. You can also find it in My Creations and click on Run to be redirected to the Run section, where you can execute it.
If you selected Anonymous in Step 6: Set up the option to share conversations, the Share option becomes available after the Agent replies at least once.
The Share icon appears in the chat header.
Click on Share to open the Share Conversation pop-up window with a public URL and a Copy link button. The link does not expose your identity or custom instructions. The recipient can view the conversation up to the shared point and continue from there. Messages you send after sharing in your original chat are not included in the link.
Anyone who opens the link will access the chat as Guest. The header displays Guest and the label Continuation of a shared conversation.
The guest can view the history up to the shared point and continue the conversation from there.
The guest cannot start a new chat with the Agent from that link. They can only continue the shared conversation.
Go to the bottom-right corner of the screen and click on Publish to make the Agent available from Solutions.
- Once you click on Publish, the Publish agent pop-up window opens.
- In the Publish agent pop-up window, the Description field is pre-filled based on the Agent Purpose you defined earlier. You can edit it if needed. Optionally, add a Documentation URL. The AI Model and Integrations configured for the Agent are displayed for reference. Click Next.
- Under Set execution permissions, select who can execute the Agent after it is published: Project to limit execution to members of your project, or Organization to allow anyone in your Organization to run it. The options available depend on how permissions are configured, as described in Publishing an Agent. Click Next.
- Under Fill fields to publish, select one or more values from the taxonomy field configured for your Organization. Click Publish.
Once submitted, a confirmation message indicates that the Agent has been sent for review. The Agent will be available from Solutions once approved by an administrator.