Conecta un Agente Genie a herramientas y fuentes externas

Un Agente Genie puede utilizar conectores MCP (Model Context Protocol) proporcionados por Databricks para extraer contexto y realizar acciones en herramientas y fuentes externas durante una conversación en modo Agente . Un autor de agentes adjunta los conectores y cada usuario se autentica en ellos de forma individual. Cada llamada a la herramienta se ejecuta con los permisos del usuario que hace la pregunta.

Cómo funcionan los conectores MCP en un agente Genie

Los conectores MCP permiten que un Genie Agent combine su SQL y análisis de archivos con las aplicaciones externas que tu organización ya utiliza. Por ejemplo, una sola conversación puede analizar una tabla de ventas, extraer contexto relacionado de Google Drive y redactar un correo resumen. Azure Databricks gobierna cada llamada a herramientas a través de Unity Catalog y Unity Gateway. Consulta Gobernar un MCP.

Las herramientas MCP se dividen en dos categorías:

• Las herramientas de solo lectura (búsqueda, obtención y lista) se ejecutan automáticamente.
• Las herramientas de escritura (por ejemplo, enviar un mensaje o redactar un correo electrónico) pausan y piden al usuario que apruebe la acción antes de que se ejecute.

Los Agentes Genie soportan los siguientes conectores MCP proporcionados por Databricks:

• Google Drive: Buscar y crear Google Docs, Sheets y Slides; editar Docs que creó.
• Gmail: Buscar, leer y redactar correos electrónicos.
• Google Calendar: Busca y crea eventos en el calendario.
• Microsoft 365: Busca en SharePoint, Teams, Outlook y Calendario; redacta el correo electrónico de Outlook.
• Atlassian: Busca y actualiza Jira y Confluence.
• Glean (Beta): Busca entre las aplicaciones conectadas de tu organización usando Glean.
• Slack: Busca mensajes y canales de Slack, y envía mensajes.
• GitHub: Buscar y actualizar repositorios, incidencias y pull requests.

Requirements

Los siguientes requisitos se aplican al agente y a sus usuarios:

• Catálogo de Unity habilitado en el área de trabajo.
• Modo de agente disponible en la región. Consulte Servicios designados de Databricks.

• Unity Gateway disponible en tu región. Consulte las regiones admitidas.

• Tanto el derecho Acceso al espacio de trabajo como el derecho Acceso a Databricks SQL para cada usuario del agente. Los usuarios exclusivos de Consumer, los exclusivos de Databricks SQL y los exclusivos de la cuenta no pueden usar herramientas MCP. Consulte Derechos de acceso.
• Una cuenta en cada sistema externo conectado para cada usuario del agente.

Añadir conectores a un agente Genie

Para adjuntar conectores a un Agente Genie:

1. Abre tu Genie Agent.
2. Abra la pestaña Orígenes y haga clic en Agregar.
3. Selecciona uno o más servicios MCP.

Para adjuntar un conector, necesitas EXECUTE en el servicio MCP del conector en el Catálogo de Unity, además de USE CATALOG y USE SCHEMA en su catálogo y esquema padre. Los conectores que no tienes permiso para usar no están disponibles. Consulta los MCPs proporcionados por Databricks.

Configuración de herramientas

Después de conectar un conector, configura cómo lo utiliza el agente:

• Añade una descripción clara que explique cómo y cuándo el agente debe usar las herramientas del conector. Por ejemplo, puedes indicar al agente un formato obligatorio de título de ticket o decirle que busque el perfil de un usuario al inicio de cada conversación.
• Activa o desactiva herramientas individuales dentro de un conector para determinar qué acciones puede realizar el agente.

Utiliza las herramientas MCP en una conversación

Para usar herramientas MCP en un Agente Genie:

1. Abre un Genie Agent que tenga conectores MCP conectados.
2. Active el modo agente en el cuadro de chat.
3. Autentíquese en el conector desde el panel Configurar. Si el agente necesita un conector que no has autorizado, o tu autenticación ha caducado, el agente te pide iniciar sesión.
4. Envía un prompt que use el conector. Cuando el agente llame a una herramienta de escritura, elija Permitir una vez para aprobar la acción concreta, Permitir siempre en este chat para aprobar esa herramienta durante el resto de la conversación, o Rechazar para denegarla.

Para confirmar que un conector funciona, haz una pregunta que lo requiera, por ejemplo: "Busca en mi Google Drive el plan de ventas del tercer trimestre." El agente cita el recurso externo que utilizó en su respuesta.

Limitations

Se presentan las siguientes limitaciones:

• Las herramientas MCP solo funcionan en modo Agente. No funcionan en modo chat.
• A través de las API del modo agente, solo funcionan las herramientas de lectura, y los usuarios no pueden autenticarse en un conector. Completa la autenticación y la aprobación de la herramienta de escritura en la interfaz de usuario.
• Para orientaciones de cumplimiento para aplicaciones conectadas, consulte Requisitos de proveedores externos.

Las siguientes secciones describen limitaciones para conectores específicos.

Google Drive

• Al autorizar Google Drive, puede que veas una pantalla de Aplicación no verificada. Haga clic en Avanzadas y continúe con el proceso de autorización.
• El tamaño máximo de archivo es de 25 MB.
• Solo se admiten archivos nativos de Google Workspace (Docs, Sheets, Slides). No se admiten archivos PDF, imágenes y otros formatos binarios.
• El conector puede crear Google Docs, Sheets y Slides, y editar Google Docs que haya creado. No puede editar documentos creados fuera del conector, ni editar hojas o diapositivas existentes.
• Leer un documento muy grande puede ser lento.

Gmail

• El conector puede buscar, leer y redactar correos electrónicos, pero no puede enviar correos ni editar mensajes existentes.
• El conector no puede añadir archivos de Drive como archivos adjuntos nativos de Gmail. Como solución alternativa, incluye enlaces a los archivos en el cuerpo del correo.

Microsoft 365

• Incluye SharePoint, Teams, Outlook y Calendario.
• El conector puede redactar el correo de Outlook pero no puede enviarlo.
• El tamaño máximo de archivo es de 25 MB para archivos SharePoint.
• Los tipos de archivo admitidos SharePoint incluyen documentos, hojas de cálculo y presentaciones integrados, así como formatos comunes basados SharePoint en texto, como .txt, .csv, .json, .mdy otros. No se admiten archivos PDF, imágenes y otros formatos binarios.

Glean (Beta)

• Glean solo permite búsquedas. No puede leer un documento desde un enlace directo.
• Un administrador de metastore debe configurar primero el ID de tenant de Glean antes de que los usuarios no administradores puedan usar la conexión. El administrador puede introducir el ID del tenant cuando se conecta por primera vez a Glean.
• Para conectarse a un servidor MCP específico de Glean, un administrador de metastore puede opcionalmente establecer la ruta del servidor MCP (por ejemplo, /mcp/eng) al configurar la conexión. Deja este campo en blanco para usar la ruta predeterminada (/mcp/default). Los usuarios no administradores no pueden especificar ni cambiar la ruta del servidor MCP de Glean.

Slack

• El conector no puede editar ni borrar un mensaje después de enviarlo.

GitHub

• La escritura se limita al contenido de los archivos, las incidencias y las pull requests.
• De forma predeterminada, el conector de Databricks GitHub MCP solo puede acceder a repositorios públicos. Para conceder al conector acceso de lectura a los repositorios privados de la empresa, un administrador de una organización de GitHub debe realizar una configuración adicional. Consulta Habilitar el acceso de escritura en GitHub y el acceso al repositorio privado.
• GitHub Enterprise Server (la versión autohospedada de GitHub) no se admite.

Recursos adicionales

Consulte los siguientes recursos para obtener información relacionada:

• Conecta Genie One a herramientas y fuentes externas
• MCPs proporcionados por Databricks
• Proveedores OAuth gestionados
• Servidores MCP externos
• Gobernanza de IA con Unity Gateway