Virtuele agent instellen voor uWebChat
Achtergrond
In uWebChat zijn er twee soorten agents:
- Menselijke agent: Een gewone Teams-gebruiker die kan worden toegewezen om chats te beantwoorden.
- Virtuele agent: Aanvankelijk ingesteld als een gewone gebruiker, maar automatisch omgezet naar een virtuele agent zodra deze aan een AI-bot wordt gekoppeld. De koppeling wordt tot stand gebracht door een Virtual Assistant ID van OpenAI aan de Teams-gebruiker toe te wijzen. Virtuele agents kunnen chats afhandelen wanneer menselijke agents niet beschikbaar zijn of fungeren als eerste aanspreekpunt. Ze kunnen net als gewone agents aan groepen worden toegevoegd en zijn altijd "beschikbaar".
OpenAI API-sleutel & Assistant ID aanmaken
Volg deze stappen om de functie virtuele agent in te schakelen:
Een OpenAPI-sleutel verkrijgen
- U kunt uw eigen OpenAI API-sleutel meenemen OF het uWebChat-team vragen er een voor u aan te maken (let op: hiervoor is een betaald Azure-abonnement nodig). Zodra u toegang hebt tot het Azure-abonnement, gebruikt u de volgende Microsoft-documentatie om uw Virtual Assistant aan te maken; How to create Assistants with Azure OpenAI Service - Azure OpenAI | Microsoft Learn
- Kies het juiste model gpt-4 (1106-preview). Let op: dit model gebruikt een aanzienlijk aantal tokens vanwege het contextgebruik. Stel altijd limieten (budget) in op het gebruik van de API-sleutel.
Een virtuele agent aanmaken met de Azure OpenAI studio en Assistants playground

Upload relevante informatie (bestanden), zoals PDF's en Word-documenten. Upload bestanden die de assistant kan gebruiken. U kunt maximaal 20 bestanden uploaden, met een maximale grootte van 512 MB. Beperk het gedrag ervan door duidelijke instructies te geven. Bijvoorbeeld:
uWebChat is a live chat platform based on Microsoft Teams. It is created by Universal.cloud. It can be embedded in a website or use WhatsApp Business as a channel.
Your task is to answer questions about how to use and set up uWebChat. Use your public knowledge first and consult documents only if needed. Prompt the user to contact a live agent if necessary.
Keep responses brief, as users are chatting in a small window, such as an embedded frame on a website or WhatsApp on a mobile device.”
- Enable Code interpreter
- Start a new New thread to test your assistant
De endpoint, API-sleutel en Virtual Assistant ID veilig delen
- Stuur de API-sleutel en Virtual Assistant ID naar support@uwebchat.com.
- U kunt de API-sleutel ook vervangen via de
replaceOpenAIKey-dialoog.
Installatiestappen voor het nieuwe Teams-account van de virtuele agent
Een gewone Teams-gebruiker aanmaken
- Gebruik de Microsoft 365 admin-portal om een gewone Teams-gebruiker aan te maken en een Teams-licentie toe te wijzen.
- Log in met de nieuwe gebruiker en communiceer met de uWebChat-bot.
Bevestig het aanmaken van een nieuw agentprofiel:
- Een admin moet het aanmaken van het nieuwe agentprofiel bevestigen; dit is een noodzakelijke stap voor alle nieuwe agents die aan uWebChat worden toegevoegd.
- De agent zou de volgende gegevens moeten zien na het typen van het debug-commando:
ID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Object ID: xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx Given Name: Virtual Surname: Assistant 1 Full Name: Virtual Assistant 1 Agent ID: xxxxx-xxxxx-xxxxx-xxxxx-xxxxxxx Customer ID: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx Tenant ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx User Principal Name: va1@demo.cloud Email: va1@demo.cloud Role: user
Gegevens naar support sturen
- E-mail support@webchat.com met de uitvoer van het debug-statement. Gebruik de onderwerpregel: "Convert to Virtual Assistant: Virtual Assistant ID: XXX-XXX-XXXXX" (vervang dit door het echte assistant-ID uit de OpenAI-portal).
De Assistant ID koppelen
- Het supportteam koppelt de Assistant ID van OpenAI aan deze agent.
De virtuele agent gebruiken
Nadat u de virtuele agent aan een OpenAI Virtual Assistant hebt gekoppeld, kunt u deze agent net als een gewone agent aan een groep toevoegen. De prioriteit van de groep bepaalt hoe de virtuele agents worden ingezet:
Eerste aanspreekpunt
- Als de prioriteit (Prio) op 1 is ingesteld en er geen andere agents met Prio 1 lid zijn van de groep, fungeert de virtuele agent als eerste aanspreekpunt.
Fallback-agent
- Als de prioriteit gelijk of lager is dan die van andere agents, reageert de virtuele agent wanneer er geen andere agents beschikbaar zijn. Dit gebeurt wanneer de virtuele agent dezelfde prioriteit heeft als niet-beschikbare agents, of een lagere prioriteit wanneer er geen agents met een hogere prioriteit beschikbaar zijn.
Door deze stappen te volgen, kunt u de functie virtuele agent in uWebChat configureren om uw klantondersteuning te verbeteren. Raadpleeg voor meer gedetailleerde instructies of hulp de online documentatie over het toevoegen van nieuwe leden aan een groep, of neem contact op met ons supportteam.