Creación y administración de un agente de Genie

Cree, comparta y administre un agente de Genie, la interfaz de chat en lenguaje natural que usan los usuarios empresariales para formular preguntas sobre sus datos en Azure Databricks. Los analistas de datos configuran cada agente con Unity Catalog, consultas SQL de ejemplo, instrucciones y recursos de confianza; Los usuarios empresariales lo consultan a través de la interfaz de usuario de chat.

Límites y requisitos técnicos

Se aplican los siguientes requisitos y límites al usar Genie Agents:

• Catálogo de Unity: Los datos del agente de Genie deben registrarse en el catálogo de Unity. Puedes añadir hasta 30 tablas o vistas a un Genie Agent.
• Proceso: Los agentes de Genie requieren un almacenamiento SQL profesional o sin servidor. Al crear o configurar un agente de Genie, debe tener al menos el permiso CAN USE en el almacén seleccionado. Tus credenciales de cómputo están integradas en el Agente Genie para proporcionar acceso al almacén a todos los usuarios. El acceso a los datos siempre se evalúa utilizando los permisos propios del Catálogo de Unity de cada usuario final. Mira cómo funciona el acceso a datos.
• Capacidad: Cada agente de Genie puede admitir hasta 10 000 conversaciones y cada conversación puede incluir hasta 10 000 mensajes.

Permisos necesarios

Para crear o editar un agente de Genie, debe tener los siguientes permisos y derechos:

• Derechos: Debe tener derecho al área de trabajo de Databricks SQL. Consulte Administración de derechos.
• Proceso: PUEDE UTILIZAR el acceso en al menos un almacén pro o SQL sin servidor.
• Acceso a datos:SELECT privilegios en los datos usados en el agente.
• Listas de control de acceso (ACL) de Genie Agent: Al menos permisos de PUEDE EDITAR en el Genie Agent. Los creadores de agentes de Genie tienen automáticamente permisos CAN MANAGE en los agentes que crean. Consulte ACL del agente Genie.

Administración del acceso a Genie

Genie usa funciones de inteligencia artificial impulsadas por socios, que deben estar habilitadas en los niveles de la cuenta y el área de trabajo. Para obtener información sobre cómo administrar estas características para su cuenta, consulte Características de Inteligencia Artificial potenciadas por socios.

Crear un Agente Genie

Para crear un Agente Genie:

1. Haga clic en Genie Agents (Agentes de Genie ) en la barra lateral.
2. Haga clic en Nuevo en la esquina superior derecha de la pantalla.
3. Elija los orígenes de datos que desea incluir en el agente de Genie. A continuación, haga clic en Crear.

Configuración de un agente con Genie Code

Al crear un agente, Genie Code se inicia automáticamente. Lee los datos y sugiere contexto que ayuda a Genie a responder preguntas con precisión, como descripciones de las tablas y consultas de ejemplo. Revise las sugerencias y acepte las que desea conservar. Para rellenar un hueco específico, describa el contexto que desea que agregue Genie Code.

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

También puede pedir a Genie Code que cree un agente para usted cuando aún no sepa qué tablas usar. Describa el dominio empresarial, las preguntas que desea que responda el agente y los datos que debe usar. Genie Code identifica los datos pertinentes, confirma los orígenes con usted y compila el agente con ese mismo contexto inicial.

Antes de compartir el agente con usuarios, Databricks recomienda agregar consultas SQL de ejemplo, instrucciones y configuraciones del almacén de conocimiento para mejorar la precisión de la respuesta. Consulte Optimizar la calidad de Genie Agent.

Revisión de sugerencias de consulta

Para obtener información sobre los datos del agente, Genie accede a la información del área de trabajo para comprender mejor las relaciones entre las tablas y la semántica empresarial. Al agregar recursos de datos a un agente, Genie busca automáticamente consultas de área de trabajo populares relevantes asociadas a esos recursos. Sus credenciales de usuario se utilizan para encontrar consultas relevantes para las que tiene al menos permisos CAN VIEW. Si la búsqueda devuelve consultas, aparece una notificación en la pestaña Datos del panel Instrucciones . Haga clic en Revisar para ver las consultas sugeridas.

Para obtener más información sobre los permisos de acceso de consulta, consulte ACL de consulta.

Use el cuadro de diálogo Revisar consultas sugeridas para revisar, editar, aceptar o rechazar las consultas sugeridas. Otros usuarios con al menos permiso de «CAN EDIT» en el Agente Genie pueden revisar consultas, siempre que tengan al menos permiso de «CAN VIEW» sobre la propia consulta.

1. El texto título se rellena previamente con una pregunta. Revise o edite la pregunta escribiendo en el campo Título .
2. El campo Código contiene el texto completo de la consulta SQL sugerida. Este campo no se puede editar. Para ver la consulta completa, haga clic en ... más líneas.
3. Si tiene permisos suficientes en la consulta, puede hacer clic en consulta SQL para abrir la consulta en la interfaz de usuario de historial de consultas. Consulte Visualización del historial de consultas.
4. Después de determinar si la consulta es relevante para el agente, haga clic en Aceptar o Rechazar para agregarla al agente o descartar la sugerencia en consecuencia.
5. Haga clic en las otras sugerencias para expandir y revisar.

Las consultas aceptadas aparecen en el contexto consultas SQL para el agente. Una vez agregados al agente, las consultas sugeridas y las preguntas asociadas son totalmente editables. Consulte Adición de consultas y funciones SQL de ejemplo.

Si no se devuelven consultas sugeridas:

• Es posible que no tenga acceso suficiente a las consultas pertinentes.
• Es posible que no haya datos relevantes. Si las consultas no se han ejecutado en las tablas incluidas, es posible que la búsqueda no devuelva resultados.
• No se tienen en cuenta las consultas irrelevantes para el agente de Genie. Por ejemplo, las consultas que solo realizan operaciones de escritura básicas en los recursos incluidos no se consideran ejemplos relevantes para Genie.
• Genie no sugiere consultas sobre tablas que no se hayan añadido al agente. Si ha creado tablas o vistas combinadas específicamente para el agente de Genie, pero las consultas SQL de Databricks pertinentes normalmente se ejecutan en una tabla de origen diferente, Genie no devuelve esas consultas en los resultados.

Administrar objetos de datos

Para administrar qué objetos de datos se incluyen en un agente de Genie, haga clic en Configurar>datos. Haga clic en el botón Agregar para agregar más tablas. Haz clic en el situado a la derecha del nombre de la tabla para eliminar una tabla del agente.

Para ver detalles sobre un objeto de datos, haga clic en el nombre del objeto. La vista del objeto de datos muestra dos pestañas:

• Información general: muestra las columnas del objeto de datos, incluidos los nombres de columna, los tipos de datos y las descripciones.
• Datos de ejemplo: muestra los datos de ejemplo de la tabla para ayudarle a comprender el contexto y el contenido de los datos.

Configuración de las opciones

Personalice su agente Genie configurando ajustes adicionales. Haga clic en Configurar>opciones para acceder a las opciones siguientes:

• Título: el título aparece en el explorador del área de trabajo con otros objetos del área de trabajo. Elija un título que ayude a los usuarios finales a detectar el agente de Genie.
• Almacén predeterminado: Este recurso informático ejecuta las instrucciones SQL generadas en Genie Agent. Cuando guardas una selección de almacén, tus credenciales de cómputo se integran en el Agente Genie para proporcionar acceso al almacén a todos los usuarios. Estas credenciales integradas solo otorgan acceso al almacén. El acceso a los datos siempre se evalúa utilizando los permisos propios del Catálogo de Unity de cada usuario final. Debes tener, como mínimo, permisos de PUEDE EDITAR en el agente para cambiar el almacén. Si otro autor cambia el almacén más adelante, se incorporarán sus credenciales de proceso en su lugar. Un agente de Genie puede usar un almacenamiento SQL profesional o sin servidor. Para obtener un rendimiento óptimo, Databricks recomienda usar un almacenamiento SQL sin servidor.
• Etiquetas: use etiquetas para organizar y clasificar agentes deGenie para facilitar la administración. Consulte Agregar etiquetas.
• Miniatura: Agregue una imagen miniatura al agente Genie. Las miniaturas aparecen en la página de chat inicial del agente de Genie y en Genie One.
• Descripción: los usuarios ven la descripción cuando abren Genie Agente. Use este área de texto para describir el propósito del agente. El campo de descripción admite el formato Markdown para que pueda aplicar estilo al texto y proporcionar vínculos a contexto y referencias útiles. Para obtener más información sobre la sintaxis de Markdown, consulte la hoja de referencia rápida de la Guía de Markdown.
• Preguntas comunes: las preguntas comunes son ejemplos opcionales de los tipos de preguntas que los usuarios pueden formular. Aparecen en la página de inicio del chat del agente y se pueden añadir durante la creación o más adelante desde Settings del agente. Las preguntas comunes definidas por el autor tienen prioridad y aparecen primero. Cuando proporcione suficientes preguntas comunes para rellenar la página de aterrizaje del chat, solo aparecen sus preguntas. Al proporcionar menos, Genie rellena las ranuras restantes con preguntas generadas automáticamente.

Es probable que tengas que ir perfeccionando tu agente de Genie en función de las pruebas y el uso. Para obtener orientación sobre las mejores prácticas a la hora de crear y perfeccionar un agente, consulta Cómo crear un agente de Genie eficaz.

Adición de etiquetas

Debe tener al menos el permiso CAN EDIT en un agente de Genie para añadir una etiqueta. Para agregar una etiqueta regulada, también debe tener el permiso ASSIGN en la etiqueta regulada. Para obtener más información sobre las etiquetas, consulte Aplicar etiquetas a objetos protegibles del catálogo de Unity.

1. Haga clic en Configurar>opciones.

2. Haga clic en General.

3. En Etiquetas, agregue o actualice una etiqueta:

   • Si no hay etiquetas, haga clic en el botón Agregar etiquetas.
   • Si hay etiquetas, haga clic en el icono Agregar o editar etiquetas.

4. Seleccione una clave de etiqueta existente y un valor o escriba un nombre de una nueva etiqueta.

   • Las etiquetas que están gestionadas se encuentran en la cabecera de sección Gestionadas y tienen un icono de bloqueo
   • Se requieren claves de etiqueta. Si se requiere un valor de etiqueta depende de la clave de etiqueta.

Compartir un agente de Genie

Para restringir los datos que cada usuario puede ver en el mismo agente de Genie, aplique la seguridad de nivel de fila a las tablas subyacentes en el catálogo de Unity. Los filtros de fila y las máscaras de columna definidos en el catálogo de Unity se aplican automáticamente por usuario, independientemente de cómo se comparta el agente de Genie. Consulte Filtros de fila y máscaras de columna.

Al compartir un agente de Genie, los usuarios deben tener los permisos siguientes para interactuar con el agente:

• Derechos de acceso: El derecho de acceso del consumidor o al espacio de trabajo de Databricks SQL. Consulte Administración de derechos.
• Proceso: Las consultas se ejecutan con las credenciales de proceso insertadas por el autor que configuró el almacenamiento. Los usuarios finales no necesitan permisos de almacenamiento directo.
• Acceso a datos: Al menos SELECT privilegios en todos los objetos de datos de Catálogo de Unity usados en el agente. Los usuarios solo ven los datos a los que tienen permiso para acceder.
• Listas de control de acceso (ACL) del agente de Genie: Como mínimo, permisos CAN VIEW (PUEDE VER) y CAN RUN (PUEDE EJECUTAR) sobre el agente de Genie. Consulte ACL del agente Genie.

Los nuevos agentes de Genie se guardan en la carpeta de usuario de forma predeterminada. Al igual que otros objetos del área de trabajo, heredan permisos de su carpeta envolvente. Puede usar la estructura de carpetas del área de trabajo para compartirlas con otros usuarios. Consulte Explorador del área de trabajo.

También puede especificar determinados usuarios o grupos (incluidos todos los usuarios de la cuenta) con los que compartir en un nivel de permiso determinado: CAN MANAGE, CAN EDIT, CAN RUN y CAN VIEW.

Para compartir con usuarios o grupos específicos:

1. Haga clic en Compartir.
2. Escriba los usuarios o grupos con los que desea compartir el agente. Después, haga clic en Agregar y establezca los niveles de permisos adecuados. Los usuarios individuales y los miembros de grupos pequeños reciben una notificación por correo electrónico confirmando que se ha compartido el agente.
3. Use el botón Copiar vínculo situado en la parte inferior del cuadro de diálogo Compartir para obtener un vínculo que se pueda compartir con el agente de Genie. Los usuarios con privilegios pueden hacer clic en el vínculo para abrir el agente de Genie en una nueva pestaña y formular preguntas.

Para compartir con todos los usuarios de la cuenta:

1. Haga clic en Compartir.
2. Seleccione Todos los usuarios de la cuenta.
3. Establezca el nivel de permiso adecuado.

Los usuarios del agente también pueden compartir conversaciones individuales. Consulte Compartir una conversación.

Para compartir un agente de Genie con usuarios externos a su organización mediante OpenSharing, consulte Uso compartido de un agente de Genie mediante OpenSharing.

Más acciones de agentes

El El menú kebab en la esquina superior derecha de un agente ofrece las siguientes acciones.

Clonar un agente de Genie

La clonación de un agente de Genie crea una copia que incluye todo el contexto de instalación y las instrucciones. La clonación es útil cuando desea probar los cambios en un agente independiente o reutilizar el contexto original en uno nuevo. Después de clonar un agente, el nuevo agente es independiente del original. Puede realizar modificaciones y ajustes sin afectar al original.

Los siguientes elementos se copian a un Agente Genie clonado:

• Tablas y configuraciones
• Instrucciones generales
• Consultas SQL de ejemplo
• Funciones de SQL

Las conversaciones de chat existentes y los datos de la pestaña Monitor no se copian al nuevo agente.

Para clonar un agente de Genie, haga lo siguiente:

1. Abra el agente de Genie que desea clonar.
2. Haga clic en el menú de tres puntos situado en la esquina superior derecha del agente.
3. Haga clic en Clonar.
4. (Opcional) En el cuadro de diálogo Clonar , especifique una nueva ubicación de carpeta de nombre y área de trabajo para el agente de Genie clonado.
5. Haga clic en Clonar para crear el nuevo agente.

Exportar un Genie Agent como vista de métricas

Puede exportar el contexto de un Genie Agent como vista de métricas. Esto crea una vista de métrica basada en los datos y el contexto semántico configurados en el agente.

Para exportar un Agente Genie como vista de métricas, haga lo siguiente:

1. Abra el agente de Genie que desea exportar.
2. Haga clic en el menú de tres puntos situado en la esquina superior derecha del agente.
3. Seleccione Exportar en vista métrica.
4. Seleccione la ruta para la nueva vista de métricas.
5. (Opcional) Haga clic en el En la esquina superior derecha de la página para abrir Genie Code y refinar la definición de la vista de métricas.
6. Haga clic en Crear.

Asignar la certificación a un Agente Genie

Puedes marcar un Agente Genie como certificado o obsoleto para indicar su estatus de confianza o ciclo de vida. La certificación utiliza la etiqueta gobernada por Unity Catalog system.certification_status . Para aplicarla, debes tener el permiso ASSIGN en esa etiqueta.

Para asignar la certificación a un Agente Genie, haz lo siguiente:

1. Abre el agente Genie que quieres certificar.
2. Haz clic en el en la esquina superior derecha del agente y, a continuación, selecciona Asignar certificación.
3. Seleccione Certificado, En desuso o Ninguno.
4. Haz clic en Guardar.

Para más información sobre certificación, incluyendo cómo buscar por estado de certificación, consulte Datos de bandera como certificados o obsoletos.

Recursos adicionales

• Para obtener orientación sobre las mejores prácticas y ayuda para solucionar problemas, consulte Crear un agente Genie eficaz.
• Para obtener información sobre cómo agregar ejemplos, instrucciones y configuración de SQL, consulte Optimización de la calidad del agente de Genie.
• Para obtener información sobre cómo probar, revisar las respuestas y supervisar el agente, consulte Probar y supervisar un agente de Genie.
• Para obtener información sobre cómo usar registros de auditoría para realizar un seguimiento de la actividad y el uso en un agente de Genie, consulte Eventos del agente de Genie.
• Consulte Uso de Genie Agents API para obtener información sobre cómo importar y exportar Genie Agents mediante programación y usar la API de conversación de Genie. Consulte también la referencia de Genie API.
• Para obtener información sobre cómo crear un sistema multiagente mediante agentes personalizados, consulte Uso de Genie en sistemas multiagente (Servicio de modelos).