Skip to content

Using agents

An agent is an assistant set up for one kind of task, with its own instructions, a fixed model and a chosen set of tools. This page covers finding agents, keeping your list in order and working with an agent in a conversation. To build your own, see Building an agent. Your administrator can turn agents off for your instance; in that case there is no Agents entry in the sidebar.

The Agents page

Open Agents in the sidebar. The page groups your agents into sections:

  • Favourites holds the agents you starred.
  • Global agents holds agents released to the whole company or to one of your groups, once you have added them to your list. Its first card is Open the library.
  • Created by you holds your own agents. Its first card, New Agent, opens the builder.
  • Shared with you holds agents someone shared with you directly.

Sections with nothing in them are hidden. Global agents and Created by you always show because of their cards.

The Agents page with the Favourites and Global agents sections, plus search, filter and sort.Enlarge figure
Further down the Agents page: Created by you with the New Agent card, and Shared with you.Enlarge figure

The footer of each card says where the agent comes from: From you, Global or Shared by … with the person's name. Agents supplied by Intra AI itself carry a By Intra AI badge. When an agent works with sub-agents, its card shows Multi-Agent in place of the category.

Above the list you have three controls:

  • Search agents... looks at the name, short tagline and tags, not the description or instructions. To narrow by category, use Filter > Category.
  • Filter narrows the list by Category and Tags. Clear filters removes them.
  • Sort by offers Recently used, Name and Recently updated. With Recently used, a Recently used row with your latest agents appears at the top.

If your administrator has set up recommendations, a Recommended carousel appears at the top. Hide recommendations closes it.

Click a card to open its details: Example prompts, the tools and sub-agents under What this agent can do, plus Model and Tags.

Star an agent

Click the star in the top-right corner of a card. The agent now also appears under Favourites, marked Pinned, and stays in its original section.

Click the star again to unstar it. In the Switch agent window, your starred agents appear right below the default Intra AI entry.

Add global agents from the library

  1. In the Global agents section, select the Open the library card.
  2. The Add agents panel opens on the right. It lists everything you may use that is not in your list yet. Search, filter and sort work the same way as on the page.
  3. Select Add on an agent. A message confirms it, and the agent shows up under Global agents.
The Add agents panel lists every global agent you may use that is not in your list yet.Enlarge figure

Select Use to start an agent straight from the library. Once you use it, it is in your list too; Remove takes it out again. If the panel says Nothing left to add, everything released to you is already in your list.

Remove or leave an agent

Open the agent's card first. Which option you get depends on how the agent reached you.

  • To take a global agent off your list, select Remove. It stays in the library, so you can add it again any time. The agent itself does not change.
  • To drop an agent someone shared with you directly, select Leave and confirm with Leave. You will not see the agent again unless the owner shares it with you once more. Remove is offered too. It only drops the agent from your list, and the library will not list it again. You can still pick it in Switch agent.

Start a conversation with an agent

There are three ways in:

  • On the Agents page, select Use on the card or in its details. A new conversation opens with that agent.
  • In a new conversation, select Agents next to Intra AI in the header. If an agent is already selected, its name appears there instead. The Switch agent window lists Intra AI with the Default badge first, then Favourites, Recent and All agents. The right side shows the highlighted agent's description, example prompts and capabilities. Type in Search agents... to narrow the list. Conversations inside a project do not offer this choice.
  • Type @ in the message field, followed by part of the agent's name, and pick the agent from the list. The @ text is removed from the message field.

The first time you use someone else's agent that may act without asking, Before you use this agent appears. The agent then acts as you and reaches your own connected accounts. Understood, use it continues; Do not use it clears the selection. If what the agent may do without asking changes later, Intra AI asks again.

The Switch agent window filtered by the search "Assist": matching agents on the left, the highlighted agent's description, example prompts and capabilities on the right.Enlarge figure

The start screen then shows the agent's name and description, with its Example prompts below the message field. Clicking one puts the text into the message field, where you can edit it before sending.

A new conversation with an agent shows the agent's name, description and example prompts.Enlarge figure

The agent sets the model, so you cannot change it in the model menu. Once you send the first message, the agent in the header is locked and shows a lock icon. To use a different agent, select New chat. Until you send something, Intra AI in the header takes you back to the default assistant.

Give an agent your personal details

Some agents need details from you, such as your signature. These agents show a gear icon (Configure agent) in the message field.

  1. Select the gear. The Set up … dialog for that agent opens.
  2. Fill in the fields. Required fields are marked with an asterisk.
  3. Select Save.

The values apply only to you and are kept for every conversation with that agent. If a required field is empty when you send a message, the dialog opens on its own with the heading Complete required fields.

Work with a form agent

Some agents collect their input through a form instead of the message field. When you pick one, the start screen shows the form.

  1. Fill in the fields. Fields marked with an asterisk are required.
  2. Attach files if the form has a file field.
  3. Select Send. Intra AI starts a new conversation, passes your entries to the agent and shows its answer.

You can also open a form agent directly at /agents/<agent ID>/run, for example from a bookmark. That page shows only the form, and Back to chat takes you to the start screen.

When another agent is a better fit

If your request suits a different agent better, Intra AI can suggest it, and so can an agent whose creator turned on Suggest a better-suited agent. A Platform suggestion card then appears in the conversation. It names the agent, shows the job it would take on under Task for …, and lists what it may do without asking you.

  • Switch hands the conversation over. The new agent sees everything so far and answers right away. While an answer is still running, the button reads Switch when the answer is done.
  • Stay here leaves things as they are.
  • Open in new chat starts a separate conversation with the suggested agent.

If the agent needs a connection or your settings first, the card offers Connect … for the integration it needs, or Fill in settings. Switching is not possible in conversations shared with others. Your administrator can turn these suggestions off.

Note: After a switch, the new agent can read everything said in the conversation so far, and it works with your own connections and permissions.

Some agents can bring in another agent as a helper. They ask first: "Should … bring in … as a helper in this chat?" If you agree, the helper appears above the message field under In this chat:, where you can also remove it. An agent can bring in up to three helpers in a conversation; after a switch, they are paused.

Go back to the previous agent

After a switch, a Back to … button with the previous agent's name sits above the message field. Going back is not possible in conversations shared with others.

  1. Wait until the current answer is finished. The button is not available before that.
  2. Select Back to …. The conversation returns to the previous agent.
  3. Select Show handed-over context to see what the previous agent reads from the other agent's part of the conversation: a summary and, if there is one, the other agent's last reply.

If an earlier question in the conversation is still waiting for your answer, going back cancels it. Confirm with Cancel request and go back, or choose Stay here.

Continue after the step limit

An agent may only take a limited number of tool steps per answer. When it hits that limit, a Step limit reached card appears, and the answer above it is an interim result.

Select Continue. The agent picks up where it stopped, and the new answer replaces the interim result.

This works until the time shown on the card, and only as long as you have not sent another message. After that, the card reads Can no longer be continued, and you send a new message instead. The agent's creator sets the limit under Tool steps per answer; see Tools, knowledge and sub-agents.

Save process notes for recurring tasks

A process note tells an agent how you want a recurring task done. The agent reads it before it starts a matching task. Process notes are visible only to you and give the agent no new permissions. They are available only for agents whose creator turned on the Read process notes capability. Those agents show a notebook icon in the message field, with the tooltip Process notes for ….

To write one yourself:

  1. Select the notebook icon. The Process notes panel opens.
  2. Select Write a new process note.
  3. Enter a Title, one sentence under When does this apply? that lets the agent recognize the task, and the steps in your own words under Process.
  4. Select Save.

When an agent with the Propose a process note capability finishes a task, it can offer to save how it did it as a process note. Select Review in that message. In Review process proposal you can edit the draft, then choose Accept, Decline or Later. Nothing is saved until you accept it.

In the Process notes panel, open a saved note and turn on Share with colleagues. Others who use the same agent can then take their own copy; your note stays yours.

Troubleshooting

  • If an agent is missing from your list, look for it under Open the library. Search matches the name, short tagline and tags, not words from the description. To narrow by category, use Filter; Clear filters removes any active filters.
  • Once a conversation has started, you cannot change its agent from the header. Select New chat, or Switch if a Platform suggestion card offers another agent.
  • If the suggestion card says "This chat is too long for …", select Open in new chat.
  • "The previous agent is no longer available." means the agent was deleted or your access was removed. Carry on with the current agent or start a new conversation.
  • "… is being reworked and cannot take over." means the previous agent is not fully set up right now. Try again later.