Compartir por

Crea un agente Agent 365 desplegado en Google Cloud Platform (GCP)

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Aprende a construir, alojar, registrar y publicar un agente Agent 365 que se ejecute en Google Cloud Run, usando la CLI de Agent 365. Microsoft Entra & Graph proporciona la identidad del agente, los permisos y el blueprint, mientras que Google Cloud Run proporciona el tiempo de ejecución.

Si lo único que quieres es apuntar tu agente a tu código que reside detrás de un endpoint de AWS, solo necesitas este paso adicional: configura para hosting no Azure y luego sigue todos los demás pasos del ciclo de vida de desarrollo del Agente 365.

Objetivos

Aprende a usar Agent 365 y Microsoft 365 como 'plano de control' y:

  • Despliega el tiempo de ejecución del agente en Google Cloud Run
  • Configure a365.config.json for non-Azure hosting
  • Crear Plano de Agente en Entra ID
  • Configurar OAuth2 + permisos heredables
  • Registro del punto final de mensajería del Bot Framework apuntando a GCP
  • Crear identidad de agente + usuario de agente
  • Publicar en Microsoft 365 app surfaces
  • Interacciones de prueba de extremo a extremo

Prerrequisitos

Antes de comenzar, asegúrate de que se cumplen los siguientes requisitos de Azure / Microsoft 365, Google Cloud Platform (GCP) y entorno local.

Azure / Microsoft 365 prerequisites

Confirma el acceso a tu usuario de Microsoft Entra e instala las siguientes herramientas para crear identidades, planos y registrar a tu agente.

Requisitos previos para GCP

  • Proyecto GCP creado

  • API Cloud Run habilitada

  • SDK gcloud instalado y autenticado:

    gcloud auth login
gcloud config set project <GCP_PROJECT_ID>
gcloud config set run/region us-central1   # or your preferred region

Requisitos previos para el entorno del desarrollo local

Crear y desplegar el agente 365 en la nube

Este ejemplo utiliza un agente de ejemplo mínimo que:

  • Responde a GET /
  • Acepta actividades del Marco Bot en POST /api/messages

Crear proyecto

Sigue estos pasos para andar un agente de Node.js mínimo que funcione en Cloud Run y acepte actividades del Bot Framework.

  1. Crea el directorio del proyecto

    mkdir gcp-a365-agent
cd gcp-a365-agent

  2. Inicializar el proyecto Node

    npm init -y
npm install express body-parser

  3. Crear index.js

    const express = require("express");
const bodyParser = require("body-parser");

const app = express();
app.use(bodyParser.json());

app.get("/", (req, res) => {
res.status(200).send("GCP Agent is running.");
});

// Bot Framework Activity Handler
app.post("/api/messages", (req, res) => {
console.log("Received activity:", JSON.stringify(req.body, null, 2));

// Echo activity
const reply = {
   type: "message",
   text: `You said: ${req.body?.text}`
};

res.status(200).send(reply);
});

const port = process.env.PORT || 8080;
app.listen(port, () => console.log("Server listening on port " + port));

Despliega en Google Cloud Run

Úsalo gcloud run deploy para construir y ejecutar el servicio en Cloud Run, luego apunta la URL pública de tu messagingEndpointarchivo de archivo .

  1. Utiliza los siguientes comandos para desplegar tu proyecto en Google Cloud Run:

    gcloud run deploy gcp-a365-agent `
--source . `
--region us-central1 `
--platform managed `
--allow-unauthenticated

  2. Cuando termines, apunta tu punto final:

    https://gcp-a365-agent-XXXX-uc.run.app

    Esta URL es la messagingEndpoint que utiliza la CLI de herramientas de desarrollo de Agent 365 en el siguiente paso.

Configure for Non-Azure Hosting

Crea a365.config.json en tu carpeta de proyectos Run en la nube ejecutando a365 config init:

{
  "tenantId": "YOUR_TENANT_ID",
  "subscriptionId": "YOUR_AZURE_SUBSCRIPTION_ID",
  "resourceGroup": "a365-gcp-demo",
  "location": "westus",
  "environment": "prod",

  "messagingEndpoint": "https://gcp-a365-agent-XXXX-uc.run.app/api/messages",
  "needDeployment": false,

  "agentIdentityDisplayName": "MyGcpAgent Identity",
  "agentBlueprintDisplayName": "MyGcpAgent Blueprint",
  "agentUserDisplayName": "MyGcpAgent User",
  "agentUserPrincipalName": "mygcpagent@testTenant.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "managerEmail": "myManager@testTenant.onmicrosoft.com",

  "deploymentProjectPath": ".",
  "agentDescription": "GCP-hosted Agent 365 Agent"
}

La siguiente tabla resume los campos de configuración importantes y su propósito.

Campo Meaning
messagingEndpoint URL de Tu Cloud Run + /api/messages
"needDeployment"=false Le dice a CLI: 'Yo alojo mi propio servidor; no despliegue en Azure'
deploymentProjectPath Donde .env se produce el estampado

Agente de construcción 365

Una vez que tengas el código de tu agente ejecutándose contra un endpoint de AWS, sigue los pasos restantes del ciclo de vida de desarrollo del Agente 365 para configurar tu agente del Agente 365.

Verifica el agente de principio a fin

Utiliza estas comprobaciones para confirmar que tu agente alojado en GCP está localizable, recibe actividades del Bot Framework y responde correctamente en las superficies del Agente 365.

Verificar conectividad Cloud Run

Envía una GET solicitud al messagingEndpoint valor de tu a365.config.json:

curl https://gcp-a365-agent-XXXX.run.app/

El órgano de respuesta debe incluir:

GCP Agent is running.

Revisa los registros de Cloud Run para ver si llegan mensajes de Bot Framework

Puedes consultar Google Cloud Log Explorer o ejecutar:

gcloud run services logs read gcp-a365-agent --region <your region> --limit 50

Después de que un mensaje llegue a tu agente, deberías ver:

POST 200 /api/messages
Received activity: { ... }

Agente de prueba de superficies del Agente 365

Dependiendo de tu entorno:

  • Sitio de prueba de agentes
  • Equipos (si se publican)
  • Agente Shell

Ahora puedes enviar mensajes y verificar tus registros de Cloud Run. Y también puedes aprender a probar agentes usando el Microsoft Agent 365 SDK y validar la funcionalidad de tu agente con la herramienta de pruebas Agents Playground.

Flujo de trabajo del desarrollador

Una vez completada la configuración, sigue este flujo de trabajo para el desarrollo iterativo:

  1. Cambia tu código de agente

    Haz tus cambios de código, guarda y prueba localmente antes de desplegar.

  2. Redeploy to Google Cloud Run

    gcloud run deploy gcp-a365-agent --source .

  3. Pruebas y supervisión

    Prueba a través de superficies Agent 365 y monitoriza los registros de Google Cloud Run.

    Nota:

    Tu identidad, blueprint, endpoint del bot y permisos NO necesitan ser recreados.

Solución de problemas

Utiliza esta sección para diagnosticar problemas comunes al desplegar y ejecutar tu agente Agent 365 en Google Cloud Run, y para aplicar rápidamente soluciones para problemas de conectividad, configuración y licencias.

El endpoint de mensajería no está afectado

Consulta los siguientes detalles:

  • El punto final es exactamente:
    https://<cloud-run-url>/api/messages
  • Cloud Run permite el acceso no autenticado
  • No hay reglas de cortafuegos

Fallo en la cesión de licencias

Asigna manualmente una licencia Frontier válida de Microsoft 365, o utiliza una ruta de usuario sin licencia si es compatible.

Obtener ayuda

Más opciones de ayuda

Considera lo siguiente para encontrar ayuda:

  • Last updated on