uWebChat Virtual Agent (AI) setup

Stel een AI-gestuurde Virtual Agent in voor uWebChat met Azure OpenAI, inclusief API-sleutels en Teams-configuratie.

KA-01515Published: February 20, 2026

uWebChat biedt de functionaliteit om een gepersonaliseerde Virtual Agent te gebruiken voor klanten met een Enterprise licentie.

Achtergrond

In uWebChat zijn er twee typen agents:

  1. Menselijke agent — Een gewone Teams-gebruiker die chats kan beantwoorden.
  2. Virtual Agent — Oorspronkelijk opgezet als gewone gebruiker, maar automatisch omgezet naar een Virtual Agent zodra deze is gekoppeld aan een AI Bot. Virtual Agents kunnen chats afhandelen wanneer menselijke agents niet beschikbaar zijn of dienen als eerste contactpunt. Ze zijn altijd "beschikbaar".

Azure OpenAI API-sleutel en Assistant ID aanmaken

API-sleutel verkrijgen

U kunt uw eigen OpenAI API-sleutel gebruiken OF het uWebChat team vragen er een voor u aan te maken (een betaald Azure-abonnement is nodig).

Gebruik de volgende Microsoft documentatie om uw Virtual Assistant aan te maken: How to create Assistants with Azure OpenAI Service

Kies het juiste model gpt-4 (1106-preview). Dit model gebruikt veel tokens vanwege het contextgebruik. Stel altijd limieten (budget) in voor het API-gebruik.

Virtual Agent aanmaken in Azure OpenAI Studio

Azure OpenAI Studio

Azure OpenAI Studio

Upload relevante informatie (bestanden) zoals PDF's en Word-documenten. U kunt tot 20 bestanden uploaden, maximaal 512 MB.

Beperk het gedrag door duidelijke instructies te geven, bijvoorbeeld:

"uWebChat is een live chat platform gebaseerd op Microsoft Teams. Het is gemaakt door Universal.cloud. Het kan worden geïntegreerd in een website of WhatsApp Business als kanaal gebruiken. Uw taak is vragen beantwoorden over het gebruik en de setup van uWebChat. Houd antwoorden kort."

Endpoint, API-sleutel en Assistant ID veilig delen

Stuur de API-sleutel en Virtual Assistant ID naar support@uwebchat.com. U kunt de API-sleutel ook vervangen via het replaceOpenAIKey dialoog.

Teams-account instellen voor de Virtual Agent

Stap 1: Teams-gebruiker aanmaken

Maak via het Microsoft 365 admin portal een gewone Teams-gebruiker aan en wijs een Teams-licentie toe. Log in met de nieuwe gebruiker en start een gesprek met de uWebChat bot.

Stap 2: Nieuw agentprofiel bevestigen

Een admin moet het nieuwe agentprofiel bevestigen. De agent kan het debug commando typen om zijn gegevens te controleren.

Stap 3: Gegevens naar support sturen

Stuur de debug-output per e-mail naar support@uwebchat.com met onderwerp: "Convert to Virtual Assistant: Virtual Assistant ID: XXX-XXX-XXXXX".

Stap 4: Assistant ID koppelen

Het supportteam koppelt de Assistant ID van OpenAI aan deze agent.

Virtual Agent gebruiken

Na het koppelen kunt u de Virtual Agent toevoegen aan een groep, net als een gewone agent. De prioriteit bepaalt hoe de Virtual Agent wordt ingezet:

Eerste contactpunt

Als de prioriteit (Prio) op 1 staat en er geen andere agents met Prio 1 in de groep zitten, fungeert de Virtual Agent als eerste contactpunt.

Terugval-agent

Als de prioriteit gelijk aan of lager is dan andere agents, reageert de Virtual Agent wanneer geen andere agents beschikbaar zijn.

Gespreksgeschiedenis opslaan

Om inzicht te krijgen in hoe bezoekers met uw Virtual Agent(s) communiceren, kunt u transcripties opslaan. Ga naar Help > Manage Virtual Assistant > Edit Virtual Assistant Settings > Save conversation history.

Inschakelen/Uitschakelen

Schakel het opslaan van transcripties per Virtual Agent globaal in of uit.

VA instellingen

VA instellingen

VA in-/uitschakelen

VA in-/uitschakelen

Configuratie per groep

Maak configuraties aan per groep voor het opslaan van transcripties. Kies uit twee opslagtypen:

  • OneDrive (Simpel): — Handmatig opslaan via een Adaptive Card
  • Azure (Geavanceerd): — Automatisch opslaan naar uw eigen Azure storage account
Configuratie aanmaken

Configuratie aanmaken

Bij OneDrive ontvangt een aangewezen agent een Adaptive Card na elk gesprek.

OneDrive transcriptie

OneDrive transcriptie

Bij Azure voert u een connection string in naar uw Azure storage account.

Azure configuratie

Azure configuratie

Privacy

Schakel het maskeren van bezoekernamen in transcripties in of uit.

Privacy instelling

Privacy instelling

uWebChatMicrosoft TeamsAIVirtual AgentAzure OpenAI