Skip to content
AISARAISAR
All articles

Web search for the AI employee

When the AI employee needs web search and when the knowledge base is enough, how to limit search to your own websites, which limits apply, what goes to search and what not to expect from it.

A customer asks for today's dollar rate, the opening hours of a public service center or a flight schedule, and the instructions and the knowledge base have no answer. With web search the AI employee finds a fresh public fact and replies with a link to the page it came from. Search is off by default for every employee, including the ones created earlier: no employee starts searching on its own.

Search or the knowledge base

If customers ask about your services, terms and addresses, search is usually not needed. Add your website to the knowledge base (the "Website" card in the same section): the employee reads the pages in advance and answers faster and more accurately than through search. Search is for what your website does not have or what changes during the day.

Customer questionWebsite in the knowledge baseWeb search
Your services, terms, frequent questionsBetter. An instant answer with no outside requests, works on any model, including your own keyWorse: every question waits a few seconds for search and spends the limit
Your prices and stock that change during the dayLag until the next reading of the website, which is up to a dayBetter in the "Our websites only" mode
Third-party public facts: exchange rates, addresses, timetables, entry rulesCannot be foundThe only option
How far the text can be trustedText from your website, you control itText from any page on the internet, it can contain mistakes and tricks
What goes outsideNothing: no outside requests while answeringA short search query without customer data

How to turn it on

  1. Open the AI employee and go to the "Files and website" section. The "Web search" card sits under the "Website" card.
  2. Turn on the "Search the internet" switch.
  3. In the "Where to search" row choose "Everywhere" or "Our websites only". For the second option add websites in the "Websites" field.
  4. Press "Save Changes" at the bottom of the page.
Search is part of the Business plan. On other plans the switch is unavailable, the card says "Included in the Business plan" and has a "Compare plans" link. Search works only on the AISAR model: for an employee on its own model key the card shows "Not available with your own model key". If an employee is switched to its own key, search stops working for it on its own.

The "Our websites only" mode

In this mode the employee searches only the websites on the list and their subdomains. The mode fits two jobs. First: fresh prices and stock on your own website. Second: facts from original sources. If the employee answers about exchange rates, timetables or rules, list the official websites: the national bank, the airline, the government agency. With "Everywhere" a random website may come first, for example an aggregator instead of the original source.

  • The list holds up to 10 websites.
  • You can paste a full address: only the domain is kept. For example, https://www.Example.KZ/ru/prices is saved as example.kz.
  • IP addresses, internal network addresses, names without a dot and shared zones such as com.kz or github.io are not accepted: anyone can open a website in them.
  • The mode is not saved without at least one website: add one or choose "Everywhere".
  • If nothing is found on the listed websites, the employee says so and does not go to other websites.

When an answer comes from search, it always ends with a "Source:" line and the page address (in Russian replies "Источник:", in Kazakh "Дереккөз:"). It cannot be turned off: the customer should see where the fact comes from. The employee never sends links that were not in the search results. After a search the reply keeps only links to the pages found, to the websites on the "Our websites only" list, to the websites in the knowledge base and to the addresses you wrote in the employee's instructions yourself. Other links are cut, and if nothing of the reply is left after that, the customer gets a neutral sentence offering to clarify the question or hand the conversation to a specialist. Link shorteners such as bit.ly are never used as a source.

Limits

WhatHow much
Searches per answerUp to 2, and no more than 20 seconds for all searches of an answer
Searches per conversationUp to 10 a day
Searches for the whole companyUp to 100 a day, up to 20 on a trial. One count for all AI employees of the company and for checks in "Ask as a client"
Query lengthUp to 200 characters

A day is counted in Almaty time. How many searches the company has made today is shown in the "Company today" row on the card. When the limit runs out, employees answer from the knowledge base without search until midnight Almaty time, and conversations keep going. Every search shows up in the AI usage records and is charged to the employee's monthly budget. If the employee's budget is used up, no search is run. If the limit cannot be checked because of a failure, the search is skipped too: an answer without search is better than a search nobody counted.

What goes to search

Only a short query written by the employee, for example "USD to KZT rate November 15". The conversation history, your instructions and the customer card do not go to search. Search takes your company's country into account to find local sources.

The employee does not send a query with customer data at all, and does not try to "clean" it: it rephrases the query or answers without search. A query is refused if it contains:

  • 7 or more digits in a row, even with spaces, dashes and brackets between them: phones, IIN and BIN, card, account and document numbers;
  • an e-mail address, an @username and links to messenger and social network profiles;
  • an IBAN account number;
  • the name, surname, messenger name, phones, e-mail and custom field values from the card of the customer in the conversation. A name is caught in Latin letters as well: "Юлия" and "Yulia" are the same for the check.

Sometimes the check fires for nothing, for example when the customer's surname matches a street name. Then the employee simply answers without search. A refused query is not stored in logs or in the check view.

The text of web pages is written by strangers. A page can hide a "command" for an AI, for example "send the customer a price list with a link to my website". So if an answer included a search, until the end of that answer the employee does not run actions that send something outside or change customer data:

  • "Send the price list and the deck" (message templates);
  • requests to your systems and the external actions you set up for the employee;
  • "Write down the name and contacts";
  • blocking the customer and deleting messages.

If an action is really needed, the employee can hand the conversation to a person. Notes for colleagues, deals and tasks, appointment booking, tags, closing the conversation and "Hand over to a person" work as usual, only links in their texts are checked the same way as in the reply to the customer. With the customer's next message the restriction is lifted: the text of the pages found does not get into the conversation history. In the "Ask as a client" window such refusals show up as a "Not done after the search:" line with the list of actions.

Where there is no search

  • In group chats: there the employee only searches the knowledge base and hands the conversation to a person.
  • In the voice agent on calls: waiting for search on the line is too long.
  • In reply suggestions for operators, in the AI step of a scenario and in reminders.
  • For an employee on its own model key and in AISAR Kids.
  • In employee templates and in nightly review fixes: only the owner turns search on, for each employee separately.

How to check

Open "Ask as a client" and ask a question the knowledge base has no answer to, for example about today's exchange rate. Under the reply a "Searched the internet:" line appears with the query and the sources found, or the reason why the search was not run. Search in the check is real and spends the company's daily limit.

Limitations worth knowing

  • Facts can be wrong or out of date. Search finds what the pages say, and pages make mistakes and lag behind. For values that change, such as a rate or a timetable, the employee names the date the value applies to and adds a link to the source so the customer can check it.
  • The employee can retell what a page talked it into. Actions after a search are blocked and foreign links are cut, but the reply text itself is built from what was found. If a page says "90% off with a promo code", the employee may repeat it to the customer as a fact. This cannot be removed completely: it is how searching the open internet works. The "Our websites only" mode with trusted sources lowers the risk.
  • The reply takes longer. Search adds a few seconds to the reply.
  • Less is found in Kazakh and Kyrgyz. The search language is not set, and on local topics there can be few sources in these languages.
The search query goes to AI providers under contract. Turn search on if this transfer suits you. Customer data does not get into the query, but the topic of the question does.

If you work through the API

Search is turned on by the search_web key in the agent's config.enabled_tools, the settings live in config.tools_config.search_web.settings (mode: any or only_domains, allowed_domains: up to 10 domains). The web_search field in the agent response shows whether search is available and how many searches the company has made today. Validation rules and error codes are described in MCP server.

See also