Necesita un proyecto para almacenar el cuaderno de ejemplo.

Vea un vídeo para ver cómo crear un proyecto de recinto de pruebas y asociar un servicio. A continuación, siga los pasos para verificar que tiene un proyecto existente o cree un proyecto de recinto de pruebas.

Siga los pasos para verificar que tiene un proyecto existente o cree un proyecto.

1. En la pantalla de inicio de watsonx , desplácese a la sección Proyectos . Si ves algún proyecto en la lista, pasa a Asociar el servicio watsonx.ai Runtime. Si no ve ningún proyecto, siga estos pasos para crear un proyecto.

2. Pulse Crear un proyecto de recinto de pruebas. Cuando se cree el proyecto, verá el recinto de seguridad en la sección Proyectos .

3. Abra un proyecto existente o el nuevo proyecto de recinto de pruebas.

El cuaderno de ejemplo utiliza una pequeña base de conocimiento y un componente de búsqueda simple para demostrar el patrón básico. El escenario utilizado en este cuaderno es para una empresa que vende semillas para plantar en un jardín. El sitio web para un catálogo de semillas en línea tiene muchos artículos para ayudar a los clientes a planificar su jardín y, en última instancia, seleccionar qué semillas comprar. El nuevo widge se está añadiendo a la página web para responder a las preguntas de los clientes sobre el contenido de los artículos.

Vea este vídeo para ver cómo añadir un cuaderno de ejemplo a un proyecto y, a continuación, siga los pasos para añadir el cuaderno al proyecto.

1. Acceda al cuaderno RAG: Una sencilla introducción en el Centro de Recursos.

2. Pulse Añadir al proyecto.

3. Seleccione el proyecto en la lista y pulse Añadir.

4. Escriba el nombre y la descripción del cuaderno (opcional).

5. Seleccione un entorno de ejecución para este cuaderno.

6. Pulse Crear. Espere a que se cargue el editor de cuadernos.

7. En el menú, pulse Kernel > Reiniciar y Borrar saliday, a continuación, confirme pulsando Reiniciar y borrar todas las salidas para borrar la salida de la última ejecución guardada.

Para obtener más información sobre los servicios asociados, consulte Adición de servicios asociados.

' Para previsualizar esta tarea, vea el vídeo que comienza en 00:57.

Para poder ejecutar el cuaderno, debe configurar el entorno. Siga estos pasos para verificar los requisitos previos del cuaderno:

1. Desplácese a la sección Para IBM watsonx en IBM Cloud del cuaderno para ver los dos requisitos previos para ejecutar el cuaderno.

2. En la sección Crear una clave de API IBM Cloud, debe pasar sus credenciales a la API de tiempo de ejecución de watsonx.ai mediante una clave de API. Si todavía no tiene una clave de API guardada, siga estos pasos para crear una clave de API.
   

   1. Acceda a la página de claves API de la consolaIBM Cloud.

   2. Pulse Crear una clave de API de IBM Cloud. Si tiene alguna clave de API existente, el botón se puede etiquetar como Crear.

   3. Escriba un nombre y una descripción.

   4. Pulse Crear.

   5. Copie la clave de API.

   6. Descargue la clave de API para su uso futuro.

3. Revise la sección Asociar una instancia del servicio watsonx.ai Runtime con el proyecto actual. Ha completado este requisito previo en la Tarea 1.

4. Desplácese a la sección Ejecutar la célula para proporcionar la clave de API de IBM Cloud :

   1. Haga clic en el icono Ejecutar ' para ejecutar la celda.

   2. Pegue la clave de API y pulse Enter.

5. En ' Ejecuta la celda para establecer las credenciales para ' IBM ' watsonx en ' IBM Cloud, haga clic en el icono ' Ejecutar ' para ejecutar la celda y establecer las credenciales.

Para obtener una vista preliminar de esta tarea, vea el vídeo que empieza en 01:03.

El cuaderno de ejemplo incluye información sobre la generación aumentada de recuperación y cómo puede adaptar el cuaderno para su caso de uso específico. Siga estos pasos para ejecutar el cuaderno y revisar la salida:

1. Desplácese a la sección Paso 2: Crear una base de conocimiento del cuaderno:

   1. Haga clic en el icono Ejecutar ' ' para cada una de las tres celdas de esa sección.

   2. Revise la salida para las tres celdas de la sección. El código de estas celdas establece la base de conocimientos como una colección de dos artículos. Estos artículos se han escrito como ejemplos para watsonx.ai, no son artículos reales publicados en ningún otro lugar. Los autores y las fechas de publicación son ficticios.

2. Desplácese hasta la sección Paso 3: Crear un componente de búsqueda simple en el cuaderno:

   1. Haga clic en el icono Ejecutar ' ' para cada una de las dos celdas de esa sección.

   2. Revise la salida de las dos celdas de la sección. El código de estas celdas crea un componente de búsqueda simple. Muchos artículos que discuten la generación aumentada de recuperación asumen que el componente de recuperación utiliza una base de datos de vectores. Sin embargo, para realizar el patrón de generación general de recuperación aumentada, cualquier método de búsqueda y recuperación que pueda devolver de forma fiable contenido relevante de la base de conocimiento lo hará. En este cuaderno, el componente de búsqueda es una función de búsqueda trivial que devuelve el índice de uno u otro de los dos artículos de la base de conocimiento, basándose en una coincidencia de expresión regular simple.

3. Desplácese a la sección Paso 4: Texto de solicitud de especialidad en el cuaderno:

   1. Haga clic en el icono Ejecutar ' ' para cada una de las dos celdas de esa sección.

   2. Revise la salida de las dos celdas de la sección. El código de estas celdas elabora el texto de solicitud. No hay nadie, la mejor solicitud para una tarea determinada. Sin embargo, los modelos que se han ajustado mediante instrucciones, como bigscience/mt0-xxl-13b, google/flan-t5-xxl-11bo google/flan-ul2-20b, generalmente pueden realizar esta tarea con una solicitud de ejemplo. Los métodos de decodificación conservadores tienden a respuestas sucintas. En la solicitud, observe dos marcadores de serie (marcados con %s) que se sustituirán en el momento de la generación:

      • El primer marcador se sustituirá por el texto del artículo pertinente de la base de conocimientos
      • El segundo marcador de posición se sustituirá por la pregunta que se va a responder

4. Desplácese hasta la sección Paso 5: Generar salida utilizando los modelos base de la biblioteca Python en el cuaderno:

   1. Haga clic en el icono Ejecutar ' ' para cada una de las tres celdas de esa sección.

   2. Revise la salida para las tres celdas de la sección. El código de estas celdas genera salida utilizando la biblioteca Python . Puede solicitar modelos de base en watsonx.ai mediante programación utilizando la biblioteca Python . Para obtener más información sobre la biblioteca, consulte los temas siguientes:

   • Introducción a la biblioteca Python de modelos de cimentación
   • Referencia de la biblioteca watsonx Python

5. Desplácese a la sección Paso 6: Reunir todo para realizar la recuperación-generación aumentada en el cuaderno:

   1. Haga clic en el icono Ejecutar ' ' para cada una de las dos celdas de esa sección. Este código reúne todo para realizar la generación aumentada de recuperación.

   2. Revise la salida de la primera celda de la sección. El código de esta celda configura los elementos de entrada de usuario.

   3. Para la segunda celda de la sección, escriba una pregunta relacionada con los tomates o pepinos para ver la respuesta y la fuente. Por ejemplo, Do I use mulch with tomatoes?.

   4. Revise la respuesta a su pregunta.