LLMs.txt directory

Creating an Agent in AgentSpot

Build, test, and share your first AgentSpot Agent end-to-end.

Overview

This guide is the full builder walkthrough. Deeper topics — writing instructions, managing sessions, file uploads, and sharing — have their own articles linked at each step.

By the end you’ll have a shared, tested Agent your team can use.

Prerequisites

  • You have connected to one or more connectors. While not mandatory, connectors provide more context to your agents and help them act for you, making your Agent more valuable.

  • You can answer in one sentence: "What job will this Agent do, for whom?"

  • (Recommended) You have 3–5 example questions a real user would ask.

Step 1: Plan the Agent

Write these down before opening the builder. Agents with a clear, specific purpose are more useful and more likely to be adopted by your team.

  • Name — short and recognizable (e.g. EMEA Pipeline Assistant).

  • Audience — which team or group.

  • Job — one sentence.

  • Out of scope — what it explicitly will not do.

  • Data it needs — specific sources, tables, or worksheets.

  • Skills it needs — usually none for a first Agent.

Agent components

When you create an Agent, AgentSpot builds and populates the following components automatically based on your prompt. You can review and adjust each one in the side panel.

  • Instructions: The core behavior definition for your Agent — its persona, mission, response rules, and guardrails. For example, instructions can prevent the Agent from drafting a message or making a tool call without your confirmation. Generated automatically; you can edit the instructions manually at any time.

  • Skills: Reusable knowledge your Agent can draw on (for example, how to format a document using your company template). Some skills are pre-populated. You can also add your own.

  • Conversation starters: Suggested prompts shown to users at the start of a chat. Generated automatically. You can edit them or add your own.

  • Tools: Functional capabilities such as web search or image generation. Added automatically; you can manually select or deselect tools as needed.

  • Connectors: The external applications your Agent connects to (for example, Google Calendar or Slack). Added automatically based on your prompt; you can manually add or remove connectors as needed. For a complete list of supported connectors, see AgentSpot connector reference.

  • ThoughtSpot models: Your organization’s ThoughtSpot data models. Adding a model allows your Agent to work with large structured data sets — a key differentiator for AgentSpot. Some skills are pre-populated; you can add your own.

  • Files: documents you want your Agent to have in context to help you with your work. Supports documents, spreadsheets, PDF, and images (TXT, MD, PDF, DOCX, PPTX, XLSX, XLSM, CSV, TSV, JSON, YAML, HTML, XML, PNG, JPG, WEBP, GIF).

Tips for writing effective prompts

AgentSpot builds your Agent automatically from a single prompt. A clear, specific prompt produces better results.

A strong prompt includes:

  • An objective: What you want the Agent to do, in one sentence.

  • Connectors: The applications it should use (for example, "look through my Google Calendar and Slack").

  • Expected output: What a good response looks like.

The following additions improve results further:

  • Examples: Provide examples of past work you want the Agent to replicate. This helps the Agent understand your preferred format, tone, and output more effectively than step-by-step instructions.

  • Audience: Describing the target audience helps the Agent adjust tone, length, and complexity.

Step 2: Create a new Agent

  1. On the AgentSpot home page, click Create new Agent.

  2. In the prompt field, describe the Agent you want to build.

    AgentSpot automatically builds the Agent from your description, selecting the appropriate connectors, tools, skills, and generating instructions. The side panel opens as the Agent builds, showing each component as it is configured.

  3. Review the components in the side panel and adjust as needed. For details on each component, see Agent components.

  4. Enter a name for your Agent and select an avatar.

  5. (Optional) If your Agent will need to coordinate complex tasks at the same time, you can enable Allow creating subagents at the bottom of the right-hand panel in the the Agent builder. When enabled, your Agent can delegate parts of a task to specialized subagents that it coordinates at run time, rather than handling everything in a single Agent.

  6. Click Save Agent.

After saving, AgentSpot exits the builder and opens your Agent with a set of suggested conversation starters. Test a few conversations before sharing — you can return to edit mode at any time and refine the instructions based on how the Agent performs.

Step 3: Share the Agent

Powerful agents should be shared! Sharing agents allows others in your organization to leverage the skillset of your Agent, and prevents “AI silos”, where every contributor creates similar agents that won’t all behave in the exact same way, potentially creating confusion in the organization.

To share your agent in your organization, do the following:

  1. From the My workspace tab, click the agent you want to share.

  2. In the upper-right corner of the agent window, click Share agent.

  3. In the Share window, do the following:

    1. In the Add a user field, find the people or group(s) to share with. (Alternatively, you can choose to share with everyone in your organization by clicking Share with all).

    2. Choose whether the user(s) can use (default) or edit the agent.

    3. Click Save shares.

      The agent you shared now appears under the My workspace tab for the people you shared it with.

Connecting applications

To provide value, agents require context and the ability to act. If an Agent requires external data (e.g., from Notion or Salesforce), you will be prompted to connect.

  1. Identify requirements: The Agent interface indicates if an application is not yet connected.

  2. Authenticate: Click Connect.

  3. Authorize: Complete the authentication flow in the pop-up window to grant AgentSpot access.

  4. Once connected, the Agent can search for context and perform tasks such as creating tickets or updating records.

Building with apps that are not connected yet

You don’t need to connect every app before you build. If your prompt calls for an app you have not connected yet, the Agent builder can still include it in the Agent. The builder shows a setup prompt for each unconnected app, and you can connect it from there without leaving the builder.

Managing your agents

When you find a useful Agent in the library, you must decide how to keep it:

Action Description Best For…​

Save to team

Bookmarks the shared Agent. Updates made by the owner are reflected automatically.

Users who want to use the Agent as-is and receive future improvements.

Once set up, your agents are available from the AgentSpot home page.

For details on how to use an Agent, see Using an agent in AgentSpot.

Editing your Agent

After you create your Agent, you can go back and edit it at any time.

To edit your Agent, do the following:

  1. From the AgentSpot home page, click your Agent to open it.

  2. In the upper-right portion of the page, click Edit Agent.

  3. Make any changes needed by either describing it or by making changes to the right-hand panel.

  4. When you are done, save your changes by clicking Save Changes.

Troubleshooting

Symptom What to try

Confident but wrong answers.

Switch the Agent edit mode to tighten instructions ("only answer from attached data").

Formatting instructions are ignored.

Move formatting to the top of the prompt; shorten the overall instructions.

Agent answers out-of-scope questions.

Add an explicit What not to do section naming the topics and re-test.