El SDK de Streaming Avatar de AKOOL ya proporciona la base para la interacción en tiempo real mediante vídeo, audio, texto y micrófono. El siguiente paso es hacer que ese avatar sea útil para su negocio conectándolo a documentación de productos, políticas, materiales de formación o contenido de soporte de confianza.
Esta guía se centra en esa capa de conocimiento. Creará una Base de Conocimiento de AKOOL, la conectará a una sesión de Streaming Avatar con knowledge_idy verificará que el avatar proporcione respuestas fundamentadas dentro de su propia aplicación.
La documentación oficial del SDK le muestra cómo transmitir un avatar. Esta guía le muestra cómo hacer que ese avatar comprenda su negocio.
Lo que va a construir
La experiencia final combina tres partes: sus fuentes de conocimiento aprobadas, una Base de Conocimiento de AKOOL que prepara esas fuentes para la conversación y un Streaming Avatar integrado en su aplicación. Cuando un usuario hace una pregunta, el avatar utiliza la base de conocimiento conectada como contexto y devuelve la respuesta mediante voz y vídeo sincronizados.
La conexión entre la capa de conocimiento y la sesión en vivo es el knowledge_id campo. Se añade cuando se crea la sesión de Streaming Avatar, antes de que el navegador se una al canal en tiempo real.
Las fuentes de conocimiento se procesan dentro de AKOOL y se representan mediante un knowledge_id. Su backend incluye ese ID cuando crea la sesión de Streaming Avatar. El navegador se une entonces a la sesión devuelta a través del SDK de AKOOL, lo que permite al avatar responder con el conocimiento aprobado mientras mantiene las credenciales en el servidor.
Elija su ruta de desarrollo
Si desea un prototipo funcional rápidamente, copie el siguiente prompt en un agente de programación de IA. Si ya tiene una integración de Streaming Avatar de AKOOL, o prefiere configurar el flujo de trabajo usted mismo, continúe con el Inicio Rápido. Ambas rutas producen el mismo resultado: un avatar en vivo cuyas respuestas están fundamentadas en su propio contenido.
Opción 1: Construir con un agente de IA
Copie este prompt en su agente de programación de IA preferido y proporcione su configuración de AKOOL cuando se le solicite.
Prompt de construcción para el agente de IA
Build a knowledge-powered AKOOL Streaming Avatar application.
Use AKOOL’s official Streaming Avatar SDK Quick Start as the implementation reference:
https://docs.akool.com/sdk/jssdk-start
Start from the official SDK workflow instead of recreating a generic streaming demo. Add the following knowledge-base workflow:
1. Create the avatar session from a backend endpoint.
2. Read the Avatar ID, Knowledge Base ID, optional Voice ID, language, and duration from server-side configuration.
3. Include knowledge_id and mode_type: 2 in the session-creation request.
4. Return only the temporary session credentials required by the browser.
5. Use the official AKOOL JavaScript SDK for video, audio, text, microphone, and interruption controls.
6. Add an explicit End Session action.
7. Provide a small test panel for an exact-source question, a paraphrased question, and an out-of-scope question.
Keep the interface simple and use the linked AKOOL documentation as the source of truth.Opción 2: Seguir el Inicio Rápido
Utilice esta ruta cuando desee añadir la capa de conocimiento a una aplicación existente o comprender la integración antes de delegarla a un agente de IA.
Antes de empezar
Necesita una cuenta de AKOOL con acceso a la API, un ID de Streaming Avatar y una aplicación de Streaming Avatar funcional basada en el SDK oficial de JavaScript. Puede crear o gestionar un avatar de streaming en AKOOL. Prepare los documentos o las URL públicas que debe utilizar el avatar. Un ID de voz es opcional.
Si aún no se ha conectado a Streaming Avatar, complete primero la Guía de inicio rápido del SDK de Streaming Avatar . Este artículo no repite deliberadamente los pasos de instalación, conexión de canales o gestión de medios.
Paso 1: Preparar las fuentes de conocimiento
Suba los documentos admitidos o añada URL públicas. Para una primera prueba sencilla, un archivo DOCX limpio y bien estructurado es un punto de partida práctico. Mantenga cada fuente centrada en un solo tema para que la base de conocimiento pueda recuperar el pasaje correcto de forma fiable.
Comience con un conjunto de fuentes pequeño y fiable, y un alcance de prueba limitado. Una vez que las primeras preguntas obtengan respuestas precisas, añada más documentos o URL en lotes controlados y vuelva a realizar pruebas.
Paso 2: Crear la base de conocimiento de AKOOL
Complete los campos de configuración principales: un nombre claro, una declaración de apertura (prólogo en la API), un mensaje de instrucciones y los documentos o URL públicas que desea que AKOOL utilice como fuentes.
Declaración de apertura (prólogo): Escriba el primer mensaje que debe decir el avatar al iniciar la sesión. Manténgalo breve, acogedor y alineado con el alcance de la base de conocimiento.
Instrucciones: “Responda a las preguntas utilizando las fuentes de conocimiento aprobadas. Sea conciso y servicial. Si la información no está disponible, indíquelo claramente y sugiera el siguiente paso de asistencia”.
Espere a que las fuentes terminen de procesarse y, a continuación, copie el ID de la base de conocimiento. AKOOL utiliza este valor como el knowledge_id para la sesión en vivo.
Paso 3: Conectar la base de conocimiento a la sesión
Cuando su backend cree la sesión de Streaming Avatar, añada el ID de la base de conocimientos a la solicitud. Utilice el modo de diálogo para que el avatar pueda responder preguntas y continuar la conversación.
Ejemplo de configuración de sesión
{
"avatar_id": "your_avatar_id",
"voice_id": "your_voice_id",
"knowledge_id": "your_knowledge_id",
"mode_type": 2
}El detalle importante es cuándo ocurre esto: knowledge_id pertenece a la creación de la sesión, no a la llamada joinChat() del navegador. Una vez creada la sesión, el navegador puede conectarse con las credenciales temporales devueltas por AKOOL y utilizar el flujo de interacción estándar del SDK.
Cree la sesión desde su backend, no directamente en el navegador, para que la clave de API permanezca privada. Este ejemplo de cURL envía el ID de la base de conocimientos cuando se crea la sesión y habilita el modo de diálogo con mode_type: 2.
Crear una sesión de Streaming Avatar basada en conocimientos
curl --request POST \
--url https://openapi.akool.com/api/open/v4/liveAvatar/session/create \
--header "Content-Type: application/json" \
--header "x-api-key: <api-key>" \
--data '{
"avatar_id": "<avatar-id>",
"voice_id": "<voice-id>",
"language": "en",
"duration": 600,
"mode_type": 2,
"knowledge_id": "<knowledge-id>",
"stream_type": "agora"
}'Almacene las credenciales de sesión devueltas en el servidor, pase solo los valores de unión necesarios a su cliente y utilícelos para inicializar el SDK de Streaming Avatar de AKOOL.
Paso 4: Añada el avatar a su aplicación
Utilice el SDK de JavaScript de AKOOL para unirse al canal en tiempo real, iniciar el chat en modo de diálogo, mostrar el vídeo y audio remotos, y enviar entradas de texto o micrófono. Esta parte es idéntica a la guía de inicio rápido oficial del SDK; el trabajo específico de su aplicación consiste en decidir dónde aparece el avatar y cómo los usuarios inician, interrumpen y finalizan una conversación.
Mantenga la configuración de conocimientos en la ruta de creación de la sesión. Esto permite que el mismo frontend admita diferentes productos, regiones o audiencias seleccionando un ID de base de conocimientos aprobado diferente en el backend.
Paso 5: Verifique las respuestas fundamentadas
No se detenga después de que el avatar se conecte correctamente. Confirme que realmente está utilizando los conocimientos previstos y que responde adecuadamente cuando la respuesta no está disponible.
Solución de problemas comunes de la base de conocimientos
El avatar ignora la base de conocimientos. Confirme que el knowledge_id correcto está incluido en la solicitud de creación de la sesión. Una base de conocimientos puede existir en el panel de control sin estar vinculada a la sesión activa de Streaming Avatar.
No se ha encontrado contenido en la base de conocimientos. Comprueba que todos los archivos cargados o las URL públicas hayan terminado de procesarse antes de realizar pruebas. Si el procesamiento sigue pendiente o ha fallado, el contenido aún no está disponible para su recuperación.
Las respuestas son inconsistentes. Elimina el material de origen obsoleto, duplicado o contradictorio. Mantén una versión autorizada de cada dato, utiliza encabezados claros y vuelve a realizar pruebas con preguntas directas cuyas respuestas aparezcan explícitamente en las fuentes.
La sesión funciona, pero el diálogo no. Verifica que la sesión se haya creado con mode_type: 2. A continuación, comprueba que el SDK se esté uniendo a la misma sesión devuelta por tu backend y que el avatar, la voz, el idioma y la configuración de la sesión sean válidos. Si creas una sesión de reemplazo mientras depuras, asegúrate de que el cliente no siga utilizando credenciales caducadas de una respuesta anterior.
Casos de uso
Atención al cliente. Permite que los visitantes hagan preguntas sobre productos, configuración, garantías o políticas a través de una interfaz más natural que la búsqueda estándar de un centro de ayuda.
Descubrimiento de productos. Guía a los clientes potenciales a través de funciones, planes y flujos de trabajo recomendados utilizando contenido de ventas y productos aprobado.
Formación de empleados. Convierte las guías de incorporación y los procedimientos internos en un asistente de formación conversacional.
Educación y eventos. Ofrece a los alumnos o asistentes un presentador en vivo que pueda responder preguntas basadas en materiales del curso, notas del orador o recursos del evento.
Lista de verificación para el lanzamiento
☐ Las fuentes de conocimiento están actualizadas, son autorizadas y están completamente procesadas.
☐ El/La knowledge_id previsto/a se incluye al crear la sesión.
☐ Se han probado preguntas exactas, parafraseadas, fuera de alcance y de seguimiento.
☐ La aplicación ofrece controles claros para iniciar, interrumpir y finalizar la sesión.
☐ La experiencia final se ha probado tanto con entrada de texto como de micrófono.
Recursos
- Base de conocimientos de AKOOL
- Crear una sesión de avatar en streaming
- Guía de inicio rápido del SDK de Streaming Avatar
- Mejores prácticas para el SDK de avatar en streaming
Preguntas frecuentes
¿Qué es knowledge_id en el Avatar en Streaming de AKOOL?
knowledge_id es el identificador de una Base de Conocimiento de AKOOL. Al añadirlo a una sesión de Avatar en Streaming, le indicas a AKOOL qué documentos y URLs procesados debe utilizar el avatar al responder preguntas basadas en dicho conocimiento.
¿Cuándo debo añadir knowledge_id a la sesión del Avatar en Streaming?
Añádelo durante la creación de la sesión en tu backend, antes de que el navegador se una a la misma. Esto garantiza que la base de conocimiento esté vinculada desde el principio y evita exponer tu clave de API de AKOOL en el código del lado del cliente.
¿Qué tipos de archivo puede utilizar una Base de Conocimiento de AKOOL?
Los documentos de AKOOL admiten archivos PDF, DOC, DOCX, TXT, MD, JSON, XML y CSV. También puedes añadir URLs públicas. Utiliza fuentes limpias y actualizadas con encabezados descriptivos, y espera a que finalice el procesamiento antes de probar la recuperación de información.
¿Puedo conectar directamente un LLM externo o una Base de Conocimiento RAG?
El flujo de trabajo documentado para el Avatar en Streaming utiliza una Base de Conocimiento de AKOOL: añade documentos o URLs, obtén su knowledge_ide incluye ese ID al crear la sesión. No asumas que se puede conectar directamente cualquier base de datos vectorial o servicio RAG externo, a menos que diseñes y valides una integración independiente a nivel de aplicación.
