AI Assistant

On this page

The AI Assistant is a chat in the Self Service Portal. You ask it a question or describe what you need, and it answers or helps you do it in the portal: it searches the Knowledge Base, creates tickets and service requests, finds and reserves equipment, and opens portal pages for you.

The AI Assistant is turned on or off for each Self Service Portal instance, and it is off until an administrator turns it on. For how administrators set it up, see Portal AI Assistant.

Before you begin

  • You are signed in to the portal.
  • The AI Assistant is turned on for your portal.
  • AI features are enabled globally, and an AI integration, including its API key, is configured.

Open the assistant

  1. Select the round chat button in the bottom-right corner of the portal.

    The chat panel opens in the bottom-right corner, and the chat button is hidden while the panel is open. A new chat starts with a greeting and the question "How can I help you today?". In English, and unless your administrator has changed it, the greeting reads "Hello! I'm your AI assistant. I'm here to help you use the IT services available on this portal."

  2. Type your question or request, and send it.

The message box is unavailable while the assistant is writing a reply or while an operation in the chat, such as a form, is still open. If the last reply ended in an error, you can type again. If an operation in the chat is still open when you send a message, the operation is canceled instead, and your text is not sent as a message.

What the assistant can help with

What the assistant can do for you depends on the portal modules that are available:

The assistant can Portal module it needs
Answer from Knowledge Base articles Knowledge base
Search the portal Any portal module
Open a record for you Any portal module
Open a portal page for you None
Create a ticket Tickets or incidents
Request a service Service catalog
Find and reserve equipment Equipment library

Apart from opening pages and records, the assistant works through skills. A skill is available only when your administrator has not turned it off and, if it needs portal modules, at least one of them is enabled for the portal and covered by the Alloy Navigator license. Answering from Knowledge Base articles also needs embeddings to be enabled in the AI configuration.

If you ask to change your password, the assistant is set up to take you to the Profile page when you can change your password there. Otherwise it tries the Service Catalog, and when that does not help either, it declines.

Commands

Commands are ready-made prompts that your administrator sets up. They are listed under Commands in the chat's sidebar, which shows them only while it is expanded; the sidebar opens collapsed. Select a command to send its prompt. A command has no effect while the assistant is still replying or an operation in the chat is still open.

A command is listed only when your administrator has not turned it off and, if it needs skills, at least one of them is available.

Answers from the Knowledge Base

When the assistant answers from the Knowledge Base, the answer ends with a References heading and a link to each article it found. When it finds no article, no references are shown.

The assistant uses only Knowledge Base articles that are visible in the Self Service Portal and have the Live status. An article that is linked to a service is used only when that service is one of the services available to you.

Open portal pages and records

You can ask the assistant to take you to a portal page or to open a record. The chat confirms with "Here is the page you asked for.", or reports "The requested page was not found. Navigation canceled." when the page is not one the portal offers or no record is identified. Either message stays in the chat only until the assistant adds more to its reply.

Create a ticket

When you ask the assistant to create a ticket, it uses the portal's ticket form inside the chat:

  1. If the portal offers more than one action for creating a ticket, choose one under Choose Action. When only one action is available, it is selected for you. When no action is available, the chat shows an error. When your administrator has set the action that the assistant uses, no choice appears, and the chat shows an error if that action is not available.
  2. The assistant fills in fields of the form, such as the summary, the description, and the category, and the urgency and impact of an incident or the priority of another ticket. Review the form, complete it, and submit it.

The assistant can also submit a ticket without showing you the form. The result is handled in the same way as when you submit the form yourself.

Alloy Navigator 2026.1 adds a ticket medium named SSP AI Assistant, which tells a ticket raised through the assistant apart from a ticket raised through the portal form. The upgrade to 2026.1 adds this medium to an existing database, and a new 2026.1 database created with the Default Workflow includes it.

Request a service

When you ask for a service, the assistant looks through the Service Catalog to find the matching service item. This lookup shows you no result in the chat. The assistant then opens the request form of that service item inside the chat. Complete the form and submit it.

Reserve equipment

  1. When the assistant searches for equipment, a search appears in the chat. Enter at least three characters of the equipment name and both reservation dates. The dates cannot be in the past or in reverse order.

    The search runs as you type. The results are grouped by equipment type.

  2. Select the item you want.

  3. The reservation form opens inside the chat. If there is more than one Equipment Library action, choose one under Choose Action; a single action is selected for you, and when there is none, the chat shows an error. Complete the form and submit it.

After you submit a form in the chat

  • When the ticket, service request, or reservation is created, the portal opens its page, and the assistant receives a confirmation that names it.
  • When you cancel the form or the submission fails, the portal stays on the current page, and the assistant is told that the operation was canceled or failed.

Work with your chats

The chat's sidebar can be collapsed or expanded. Collapsed, it shows only the button that expands it and a button that starts a new chat. Expanded, it lists Commands, when there are any, and History, your past chats with the most recently updated first.

  • Chat titles. A chat is titled automatically, in the language you write in, after you send your second message. If no title can be generated, the chat is titled with the text of your first message. To rename a chat, edit its title in the list: Enter saves the title, Escape cancels, and clicking elsewhere also saves. An empty title is not saved.
  • Deleting chats. You can delete any chat except the one that is open.
  • Where chats are kept. Your chat history is kept in your web browser, separately for each portal user. When the same chat is open in two of your browser tabs, both tabs show the same messages.
  • Feedback. After you have sent at least two messages in a chat, the chat shows a thumbs-up and thumbs-down feedback control. Your first vote in a chat shows "Thank you for your feedback!"; a later vote only changes the highlighted icon. Once per chat, when the conversation reaches a conclusion, such as your question being resolved or a ticket, service request, or reservation being created, the assistant is set up to remind you to leave feedback.
  • A new answer. To get a new answer to your last message, use the reload control under the assistant's newest reply. The reply is removed, and the assistant answers again.