Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Recomendación
Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.
Los complementos permiten a los agentes declarativos de Microsoft 365 Copilot llamar a servidores de Protocolo de contexto de modelo (MCP) o API de REST para recuperar datos y realizar tareas. Microsoft 365 Copilot debe llegar al servidor MCP o API a través de Internet. Normalmente, las herramientas de depuración hospedan sesiones de depuración en localhost (127.0.0.1), a las que solo se puede acceder desde el equipo que ejecuta la herramienta de depuración. Mediante el uso de un proxy inverso, como los tuneles dev, puede exponer la sesión de depuración a Internet para habilitar las llamadas de depuración de Microsoft 365 Copilot.
En este artículo se muestra cómo usar la herramienta para habilitar la devtunnel depuración local para su servidor MCP o API.
Nota
Es posible que las herramientas de depuración ya proporcionen una solución de proxy inverso. Te recomendamos que compruebes la documentación de las herramientas de desarrollo para confirmarlo. Por ejemplo, si ha creado una nueva API con el Kit de herramientas de agentes de Microsoft 365, el kit de herramientas controla la configuración del proxy inverso por usted.
Requisitos previos
- La
devtunnelCLI instalada en el equipo donde hospeda las sesiones de depuración - El número de puerto HTTP que usa la herramienta de depuración
Crear un túnel de desarrollo persistente
La devtunnel CLI le permite crear un túnel de desarrollo persistente, un túnel que puede detener e iniciar según sea necesario sin que cambie la dirección URL hospedada. El uso de un túnel con una dirección URL persistente simplifica la depuración de complementos, ya que no es necesario actualizar los paquetes de la aplicación de agente declarativo con nuevas direcciones URL.
Si aún no ha iniciado sesión en la CLI de devtunnel, use
devtunnel user login --helppara ver las opciones disponibles. Inicie sesión en la CLI antes de continuar.Cree el túnel, permitiendo el acceso anónimo. El acceso anónimo es necesario para permitir que Microsoft 365 Copilot acceda a su túnel y no está relacionado con ninguna autenticación requerida por su API.
devtunnel create --allow-anonymousRecomendación
La creación de un nuevo túnel cambia el túnel predeterminado al recién creado. Esto le permite omitir el
tunnel-idargumento en comandos posteriores. Si crea varios túneles, es posible que tenga que usar eltunnel-idargumento para asegurarse de que está usando el túnel esperado. Para obtener más información, usa eldevtunnel --helpcomando o consulta Referencia de línea de comandos de túneles de desarrollo.Agregue el número de puerto HTTP que usa la herramienta de depuración. Reemplácelo
<port>por el número de puerto y establezca el--protocolparámetrohttpssi la herramienta de depuración usa HTTPS en el puerto ohttpsi no usa HTTPS.devtunnel port create --port-number <port> --protocol httpsInicie el túnel de desarrollo.
devtunnel hostLa primera vez que ejecute este túnel de desarrollo, copie la dirección URL etiquetada Conectar a través del explorador. Abra esta dirección URL en el explorador y seleccione Continuar para habilitar el túnel.
Nota
Después de seleccionar Continuar, el explorador mostrará un error. Esto es esperado y se puede ignorar.
Una vez habilitado el túnel, puede detenerlo con CTRL + C. Puede reiniciar el túnel con el devtunnel host host-id comando.
Uso del túnel de desarrollo
Para usar el túnel de desarrollo para la depuración, transfiera localmente un paquete de la aplicación con la dirección URL del túnel de desarrollo en lugar de la dirección URL del servidor.
Establezca la url propiedad del objeto de especificación del servidor MCP dentro del manifiesto del complemento.
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "<your-dev-tunnel-url>",
}
}
]
Si usa Agents Toolkit en Visual Studio Code para administrar el agente declarativo, puede agregar una variable de entorno al archivo /env/.env.dev.user con nombre PLUGIN_SERVER_URL y usarlo en lugar de la dirección URL del túnel de desarrollo. Utilice el paso Aprovisionar del panel de ciclo de vida para transferir localmente el agente. En el archivo /env/.env.dev.user , agrega:
OPENAPI_SERVER_URL=<your-dev-tunnel-url>
En el manifiesto del complemento, actualiza la url propiedad:
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "${{PLUGIN_SERVER_URL}}",
}
}
]
Si no usa Agents Toolkit, puede generar un nuevo archivo ZIP de paquete de aplicación y cargar su agente.