Tutoriales

Requisitos previos

Puede chatear con el bot y ver los mensajes y las tarjetas adaptables a medida que aparecen en Teams. También puede simular una actividad en el área de juegos de agentes mediante desencadenadores de actividad.

Esta guía paso a paso le ayuda a crear un bot de chat de inteligencia artificial mediante Agents Toolkit y depurar con la herramienta de prueba. Verá la siguiente salida después de completar esta guía, donde el usuario puede acceder al bot de chat de IA y usarlo:

Creación del área de trabajo del proyecto para la aplicación de bot de chat de IA

La funcionalidad de bot de una aplicación de Teams crea un bot de chat o un bot conversacional. Se comunica con un servicio web, facilitando el uso de sus servicios. El bot puede ejecutar tareas sencillas y automatizadas, como la entrega del servicio al cliente. Puede obtener la previsión meteorológica, realizar reservas o cualquier otro servicio ofrecido mediante un bot conversacional.

Como ya está preparado para crear estas aplicaciones, puede configurar un nuevo proyecto de Teams para crear la aplicación de bot de chat de IA.

Creación del área de trabajo del proyecto de bot

Si se cumplen los requisitos previos, comencemos.

1. Abra Visual Studio Code.

2. Seleccione el icono microsoft 365 Agents Toolkit en la barra de actividad de Visual Studio Code.

3. Seleccione Crear un nuevo agente o aplicación.

   

4. Seleccione Agentes para Teams>Azure OpenAI> escriba una entrada en Entrada Azure clave de servicio de API ahora

   

5. Seleccione Agentes básicos para Teams. Si necesita una funcionalidad diferente para el bot, seleccione la opción necesaria.

   

6. Seleccione el lenguaje de programación como JavaScript.

   

7. Seleccione Carpeta predeterminada.

   

   Para cambiar la ubicación predeterminada, siga estos pasos:

   1. Seleccione Examinar.

      

   2. Seleccione la ubicación del área de trabajo del proyecto.

   3. Seleccione Seleccionar carpeta.

      

8. Escriba un nombre adecuado para la aplicación y, a continuación, seleccione la tecla Entrar .

   

   Aparece un cuadro de diálogo en el que debe elegir sí o no para confiar en los autores de los archivos de esta carpeta.

   

Ahora, ha creado correctamente el área de trabajo del proyecto de bot de chat de IA.

Realice un recorrido por el código fuente de la aplicación bot.

Después de finalizar el scaffolding, explore los directorios y archivos del proyecto en la sección EXPLORER de la Visual Studio Code.

Compilación y ejecución de la aplicación de bot de chat de IA

Creación de una clave y un punto de conexión de OpenAI para el bot de chat de IA

1. Acceda a Portal Azure.

2. Seleccione Crear un recurso y busque Azure OpenAI.

3. Seleccione Azure OpenAI y seleccione Crear.

   

4. Rellene los detalles necesarios y seleccione Siguiente.

   

5. Seleccione Todas las redes, incluido Internet, para acceder a este recurso y, a continuación, seleccione Siguiente.

   

6. Rellene los detalles necesarios y seleccione Siguiente.

   

7. Seleccione Crear.

   

Ha creado correctamente la clave y el punto de conexión para el bot de chat de IA.

Obtener Azure claves y punto de conexión de OpenAI

1. Seleccione Ir a recursos.

   

2. Seleccione Claves y punto de conexión en el panel izquierdo y copie la clave y el punto de conexión. Puede copiar KEY 1 o KEY 2.

   

   Guarde la clave y el punto de conexión para su uso adicional.

3. Seleccione Implementaciones de modelos en el panel izquierdo y seleccione Administrar implementaciones.

   

   Aparece la ventana Azure OpenAI Studio.

4. Seleccione Implementaciones en el panel izquierdo y seleccione + Crear nueva implementación.

   

5. Seleccione los detalles siguientes:

   1. Seleccione gpt-35-turbo en la lista desplegable Seleccionar un modelo .

      Nota:

      Solo se admite el modelo gpt-35-turbo para el bot de chat de IA.

   2. Seleccione 0301 (valor predeterminado) en la lista desplegable Versión del modelo .

   3. Escriba El nombre de la implementación y seleccione Crear.

      

   4. Copie y guarde el nombre de la implementación para su uso posterior.

      

Actualización Azure clave y puntos de conexión de OpenAI

1. Abra el proyecto en Visual Studio Code.

2. En EXPLORADOR, vaya al archivo env.env.playground.user>.

3. Escriba su SECRET_AZURE_OPENAI_API_KEY y SECRET_AZURE_OPENAI_ENDPOINT.

   ...
   SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key>
   SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>
   

4. Vaya a src>app.js archivo.

5. Comente el OpenAI código y quite la marca de comentario del Azure OpenAI código.

6. Escriba el Azure nombre de la implementación de OpenAI en azureDefaultDeployment.

   
   // Use OpenAI
   // apiKey: config.openAIKey,
   // defaultModel: "gpt-3.5-turbo",
   
   azureApiKey: config.azureOpenAIKey,
   azureDefaultDeployment: "gpt-35-turbo",
   azureEndpoint: config.azureOpenAIEndpoint,
   
   

Depuración y ejecución de la aplicación de bot de chat de IA

1. En el panel izquierdo, seleccione EJECUTAR y DEPURAR (Ctrl+Mayús+D) y, a continuación, seleccione Depurar en el área de juegos de agentes en la lista desplegable.

   

2. Agents Playground abre el bot de chat de IA en una página web.

   

Desencadenadores de actividad

Hay dos tipos de desencadenadores de actividad:

Desencadenadores de actividad predefinidos

Agents Playground proporciona desencadenadores de actividad predefinidos para probar las funcionalidades del bot.

Los desencadenadores de actividad predefinidos están disponibles en el menú Simular una actividad en el área de juegos de agentes.

Para simular una actividad Agregar usuario , siga estos pasos:

1. En el área de juegos de agentes, vaya a Simulación de unusuario de adición de actividad>.

   

   Aparece un cuadro de diálogo para obtener una vista previa del controlador de actividad.

2. Seleccione Enviar actividad.

   

   El bot envía la siguiente respuesta:

   

Desencadenadores de actividad personalizados

Puede usar la actividad Personalizada para personalizar los desencadenadores de actividad, por ejemplo, reactionsAdded para cumplir los requisitos de la aplicación de bot. El área de juegos de agentes rellena automáticamente las propiedades necesarias de la actividad. También puede modificar el tipo de actividad y agregar más propiedades.

1. Seleccione Simular unaactividad personalizada de actividad>.

   

2. Agregue messageReaction para personalizar la actividad en la type propiedad :

   {
       "type": "messageReaction",
       "reactionsAdded": [
       {
           "type": "like"
       }
       ],
       "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
   }
   

3. Seleccione Enviar actividad.

   

   El bot envía un onReactionsAdded controlador en respuesta.

   

Desafío completo

¿Se le ocurrió una salida así?

Enhorabuena. Ha creado correctamente una aplicación de bot de chat de IA. Ahora, ha aprendido a depurar la aplicación de bot de chat de inteligencia artificial en Agents Playground.

Puede usar extensiones de mensajes basadas en API para integrar servicios externos que se usan habitualmente en el flujo de trabajo empresarial. Por ejemplo, una empresa que usa con frecuencia un sistema CRM para la administración de clientes podría usar una extensión de mensaje para capturar y mostrar datos de clientes directamente desde Teams. Esta aplicación ayuda a ahorrar tiempo y mejora la eficiencia al reducir la necesidad de cambiar entre diferentes aplicaciones. Esta característica se admite en todas las plataformas en las que Teams está disponible, incluidos los dispositivos móviles, web y de escritorio.

Requisitos previos para compilar una extensión de mensaje

Esta es una lista de las herramientas que necesita para compilar e implementar las aplicaciones.

Configuración del inquilino de desarrollo de Teams

Un inquilino es como un espacio o un contenedor para su organización en Teams, donde chatea, comparte archivos y ejecuta reuniones. Este espacio también es donde carga y prueba la aplicación personalizada. Vamos a comprobar si está listo para desarrollar con el inquilino.

Comprobación de la opción de carga de aplicaciones personalizadas

Después de crear la aplicación, debe cargarla en Teams sin distribuirla. Este proceso se conoce como carga de aplicaciones personalizada. Inicie sesión en su cuenta de Microsoft 365 para ver esta opción.

¿Ya tiene un inquilino y tiene acceso de administrador? ¡Vamos a comprobar si realmente lo haces!

Compruebe si puede cargar una aplicación personalizada en Teams:

1. En el cliente de Teams, seleccione el icono Aplicaciones .

2. Seleccione Administrar las aplicaciones.

3. Seleccione Cargar una aplicación.

4. Busque la opción Cargar una aplicación personalizada. Si ve la opción , la carga de aplicaciones personalizada está habilitada.

   

Creación de un inquilino para desarrolladores de Teams gratuito (opcional)

Si no tiene una cuenta de desarrollador de Teams, puede obtenerla de forma gratuita. ¡Únete al programa para desarrolladores de Microsoft 365!

1. Vaya al programa para desarrolladores de Microsoft 365.

2. Seleccione Unirse ahora y siga las instrucciones en pantalla.

3. En la pantalla de bienvenida, seleccione Configurar suscripción A5.

4. Configure su cuenta de administrador. Cuando haya terminado, aparecerá la siguiente pantalla.

   

5. Inicie sesión en Teams con la cuenta de administrador que acaba de configurar. Compruebe que tiene la opción Cargar una aplicación personalizada en Teams.

Obtener una cuenta de Azure gratuita

Si desea hospedar la aplicación o acceder a los recursos en Azure, debe tener una suscripción de Azure. Cree una cuenta gratuita antes de empezar.

Tiene todas las herramientas para configurar su cuenta. A continuación, vamos a configurar el entorno de desarrollo y empezar a compilar. Seleccione primero la aplicación que desea compilar.

Crear documento de descripción de OpenAPI

OpenAPI Description (OAD) es la especificación estándar del sector que describe cómo se estructuran y describen los archivos OpenAPI. Es un formato legible y independiente del lenguaje para describir las API. Es fácil para los humanos y las máquinas leer y escribir. El esquema es legible y se representa en YAML o JSON.

Para interactuar con las API, es necesario un documento de descripción de OpenAPI. El documento Descripción de OpenAPI debe cumplir los siguientes criterios:

• No se debe especificar la auth propiedad .

• JSON y YAML son los formatos admitidos.

• Se admiten las versiones 2.0 y 3.0.x de OpenAPI.

• Teams no admite las construcciones oneOf, anyOf, allOf y not (swagger.io).

• No se admite la construcción de matrices para la solicitud; sin embargo, se admiten objetos anidados dentro de un cuerpo de solicitud JSON.

• El cuerpo de la solicitud, si está presente, debe ser application/Json para garantizar la compatibilidad con una amplia gama de API.

• Defina una dirección URL del servidor de protocolo HTTPS para la servers.url propiedad .

• Solo se admite la búsqueda de parámetros únicos.

• Solo se permite un parámetro necesario sin un valor predeterminado.

• Solo se admiten los métodos HTTP POST y GET.

• El documento Descripción de OpenAPI debe tener un .operationId

• La operación no debe requerir parámetros Header o Cookie sin valores predeterminados.

• Un comando debe tener exactamente un parámetro.

• Asegúrese de que no haya referencias remotas en el documento Descripción de OpenAPI.

• Un parámetro obligatorio con un valor predeterminado se considera opcional.

  Hemos usado la siguiente descripción de OpenAPI como ejemplo para este tutorial:

  Descripción de OpenAPI

      openapi: 3.0.1
      info:
      title: OpenTools Plugin
      description: A plugin that allows the user to find the most appropriate AI tools for their use cases, with their pricing information.
      version: 'v1'
      servers:
          - url: https://gptplugin.opentools.ai
      paths:
      /tools:
      get:
      operationId: searchTools
      summary: Search for AI Tools
          parameters:
          - in: query
            name: search
            required: true
            schema:
            type: string
            description: Used to search for AI tools by their category based on the keywords. For example, a search for "tool to create music" provides a list of tools that can create music.
          responses:
          "200":
            description: OK
            content:
            application/json:
              schema:
              $ref: '#/components/schemas/searchToolsResponse'
          "400":
            description: Search Error
            content:
            application/json:
              schema:
              ref: '#/components/schemas/searchToolsError'
          components:
          schemas:
          searchToolsResponse:
          required:
          - search
          type: object
          properties:
          tools:
          type: array
          items:
          type: object
          properties:
          name:
          type: string
          description: The name of the tool.
          opentools_url:
          type: string
          description: The URL to access the tool.
          main_summary:
          type: string
          description: A summary of what the tool is.
          pricing_summary:
          type: string
          description: A summary of the pricing of the tool.
          categories:
          type: array
          items:
          type: string
          description: The categories assigned to the tool.
          platforms:
          type: array
          items:
          type: string
          description: The platforms that this tool is available on.
          description: The list of AI tools.
          searchToolsError:
          type: object
          properties:
          message:
          type: string
          description: Message of the error.
  
  

  Nota:

  Asegúrese de que la required: true propiedad solo está disponible para un parámetro. Si hay más de un parámetro necesario, puede actualizar la propiedad requerida a required: false para los demás parámetros.

Puede validar si el documento Descripción de OpenAPI es válido. Para comprobarlo, siga estos pasos:

1. Vaya a Validador de Swagger o OpenAPI y valide el documento Descripción de OpenAPI.

2. Guarde el documento Descripción de OpenAPI.

3. Vaya al Editor de Swagger.

4. En el panel izquierdo, pegue la descripción de OpenAPI en el editor.

5. En el panel derecho, seleccione GET.

6. Seleccione Probar.

7. Escriba los valores del parámetro de búsqueda como Herramienta para crear música.

8. Seleccione Ejecutar. El editor swagger muestra una respuesta con una lista de productos.

   

9. Vaya a Cuerpoderespuesta de respuesta> del servidor.

10. En products, copie el primer producto de la lista y guárdelo para futuras referencias.

    

Creación de una plantilla de representación de respuesta

Un documento de descripción de OpenAPI requiere una plantilla de representación de respuesta para que la aplicación responda a las solicitudes GET o POST. La plantilla de representación de respuesta consta de una plantilla de tarjeta adaptable, una plantilla de tarjeta de vista previa y metadatos.

Plantilla de tarjeta adaptable

Para crear una plantilla de tarjeta adaptable, siga estos pasos:

1. Vaya a ChatGPT y pregunte a la siguiente consulta en el área de redacción del mensaje:

   
   Create an Adaptive Card Template that binds to the following response:
       "categories": [
           "Music Generation",
           "AI Detection"
       ],
       "chatbot_short_url": "https://goto.opentools.ai/c/ai-music-generator",
       "main_summary": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. With advanced AI technology, AI Music Generator makes music production accessible to everyone.",
       "name": "AI Music Generator",
       "opentools_url": "https://goto.opentools.ai/ai-music-generator",
       "platforms": [
           "Web",
           "App",
           "API"
       ]
   

2. Seleccione Enviar mensaje.

3. ChatGPT genera una respuesta con una plantilla de tarjeta adaptable que se enlaza a los datos de ejemplo. Guarde la plantilla tarjeta adaptable para futuras referencias.

   A continuación se muestra un ejemplo de la plantilla tarjeta adaptable:

   Plantilla de tarjeta adaptable

   
   {
   "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
   "type": "AdaptiveCard",
   "version": "1.4",
   "body": [
       {
       "type": "TextBlock",
       "text": "AI Music Generator",
       "weight": "Bolder",
       "size": "Large"
       },
       {
       "type": "TextBlock",
       "text": "Categories",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
        "text": "Music Generation, AI Detection",
        "wrap": true
       },
       {
       "type": "TextBlock",
       "text": "Description",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
       "text": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. AI Music Generator is powered by advanced AI technology, and it makes music production accessible to everyone.",
       "wrap": true
       },
       {
       "type": "TextBlock",
       "text": "Platform",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
       "text": "Web, App, API",
       "wrap": true
       }
   ],
   "actions": [
       {
       "type": "Action.OpenUrl",
       "title": "Learn More",
       "url": "https://goto.opentools.ai/ai-music-generator"
       },
       {
       "type": "Action.OpenUrl",
       "title": "Try It",
       "url": "https://goto.opentools.ai/c/ai-music-generator"
       }
   ]
   }
   
   

4. Para comprobar si la tarjeta adaptable generada se enlaza a los datos de ejemplo, siga estos pasos:

   1. Vaya a Designer de tarjeta adaptable.

   2. Vaya a Seleccionar aplicación host y, a continuación, seleccione Microsoft Teams en la lista desplegable.

   3. Vaya a CARD PAYLOAD EDITOR y pegue el código de plantilla de tarjeta adaptable.

   4. Vaya a SAMPLE DATA EDITOR (EDITOR DE DATOS DE EJEMPLO ) y pegue la respuesta GET API que guardó anteriormente.

      

   5. Seleccione Modo de vista previa. El diseñador de tarjetas adaptables muestra una tarjeta adaptable con los datos que enlazan la respuesta a la plantilla.

      

Creación de una plantilla de tarjeta en versión preliminar

La plantilla de tarjeta de vista previa puede contener propiedades title, subtitley image . Si la respuesta de API no tiene una imagen, puede quitar la propiedad image.

A continuación se muestra un ejemplo de una plantilla de tarjeta en versión preliminar:

   "previewCardTemplate": {
        "title": "${if(name, name, 'N/A')}",
        "subtitle": "$${if(price, price, 'N/A')}"
    } 

Plantilla de representación de respuesta

La plantilla de representación de respuesta debe ajustarse al esquema hospedado en https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json.

Para crear una plantilla de representación de respuesta, siga estos pasos:

1. Cree un archivo JSON y agregue el código siguiente al archivo:

   { 
     "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json", 
     "version": "1.0", 
     "jsonPath": "", 
     "responseLayout": "", 
     "responseCardTemplate": { 
    },
    "previewCardTemplate": {
        }
    }
   

2. Actualice las propiedades de la plantilla de representación de respuesta como se indica a continuación:

   #	Nombre de la propiedad	Valor
   1.	"$schema"	"https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json"
   2.	"version"	"1.0" version es la versión de la plantilla de representación que se va a usar.
   3.	"jsonPath"	"tools" jsonPath es la ruta de acceso a uno o más resultados en la respuesta JSON de respuesta. Agregue a jsonPath los datos o matrices pertinentes de la lista de productos en la respuesta de la API. En este caso, son herramientas jsonPath . Para obtener más información sobre cómo determinar la ruta de acceso JSON, consulte Consulta de JSON con ruta de acceso JSON.
   4.	"responseLayout"	"list" responseLayout especifica el diseño de los datos adjuntos. Se usa para las respuestas del resultado de tipo. Los tipos admitidos son list y grid. Si el cuerpo de la respuesta contiene un objeto con varios elementos, como texto, título e imagen, el diseño de la respuesta debe establecerse en list. Si la respuesta de API solo contiene imágenes o miniaturas, el diseño de la respuesta debe establecerse en grid.
   5.	"responseCardTemplate"	Pegue el código de plantilla de tarjeta adaptable que guardó anteriormente. responseCardTemplate es una plantilla de tarjeta adaptable para asignar la respuesta JSON a una tarjeta adaptable.
   6.	"previewCardTemplate"	Pegue el código de plantilla de tarjeta de vista previa que guardó anteriormente. previewCardTemplate es una plantilla de tarjeta de vista previa que se usa para mostrar una vista previa de los resultados en el control flotante de la extensión de mensaje.

3. Guarde la plantilla de representación de respuesta en la misma carpeta en la que guardó el documento Descripción de OpenAPI.

El código siguiente es un ejemplo de una plantilla de representación de respuesta:

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json",
    "version": "1.0",
    "jsonPath": "tools",
    "responseLayout": "list",
    "responseCardTemplate": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
            {
            "type": "TextBlock",
            "text": "AI Music Generator",
            "weight": "Bolder",
            "size": "Large"
            },
            {
            "type": "TextBlock",
            "text": "Categories",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "Music Generation, AI Detection",
            "wrap": true
            },
            {
            "type": "TextBlock",
            "text": "Description",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. With advanced AI technology, AI Music Generator makes music production accessible to everyone.",
            "wrap": true
            },
            {
            "type": "TextBlock",
            "text": "Platform",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "Web, App, API",
            "wrap": true
            }
        ],
        "actions": [
            {
            "type": "Action.OpenUrl",
            "title": "Learn More",
            "url": "https://goto.opentools.ai/ai-music-generator"
            },
            {
            "type": "Action.OpenUrl",
            "title": "Try It",
            "url": "https://goto.opentools.ai/c/ai-music-generator"
            }
        ]
    },
    "previewCardTemplate": {
        "title": "${if(name, name, 'N/A')}",
        "subtitle": "$${if(price, price, 'N/A')}"
    } 
}

Creación de un manifiesto de aplicación

Ahora, debe crear un manifiesto de aplicación (anteriormente denominado manifiesto de aplicación de Teams). En el manifiesto de la aplicación se describe cómo se integra la aplicación en el producto de Microsoft Teams.

Creación de un manifiesto de aplicación de Teams

Para crear el manifiesto, siga estos pasos:

1. Cree un nuevo archivo JSON. El manifiesto de la aplicación debe cumplir la versión 1.20 del esquema definido en Esquema de manifiesto de aplicación.

2. Agregue el código siguiente al archivo JSON:

   Manifiesto de aplicación

   {
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.schema.json",
    "manifestVersion": "1.20",
    "version": "1.0.3",
    "id": "<<YOUR-MICROSOFT-APP-ID>>",
    "packageName": "com.microsoft.teams.extension",
    "developer": {
        "name": "Teams App, Inc.",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    },
    "name": {
        "short": "Search ME API",
        "full": "Search ME API full"
    },
    "description": {
        "short": "product app for testing API Message Extensions",
        "full": "product app for testing API Message Extensions"
    },
    "accentColor": "#FFFFFF",
    "composeExtensions": [
        {
            "composeExtensionType": "",
            "apiSpecificationFile": "",
            "commands": [
                {
                    "context": [
                        "compose"
                    ],
                    "type": "query",
                    "title": "API for fetching Klarna.",
                    "id": "",
                    "parameters": [
                        {
                            "name": "",
                            "title": "",
                            "description": ""
                        }
                    ],
                    "description": "",
                    "apiResponseRenderingTemplateFile": ""
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "validDomains": []
   }
   

3. Actualice las propiedades del manifiesto de la aplicación de la siguiente manera:

   • Reemplace por <<YOUR-MICROSOFT-APP-ID>> el identificador de aplicación de Microsoft del bot.
   • Actualice el valor de a composeExtensionTypeapiBased.
   • Actualice el valor de apiSpecificationFile a la ruta de acceso del archivo de descripción de OpenAPI.
   • Actualice el valor de a commands.idsearchTools.
   • Actualice el valor de a commands.titleSearch for AI Tools.
   • Actualice el valor de a commands.descriptionSearch for AI Tools.
   • Actualice el valor de a parameters.namesearch. Si no hay parámetros, los valores deben ser parámetros de consulta o properties.name si hacen referencia a una propiedad en el esquema del cuerpo de la solicitud.
   • Actualice a apiResponseRenderingTemplateFile la ruta de acceso del archivo de plantilla de representación de respuesta.
   • Actualice el valor de validDomains al punto de service URL conexión definido en el archivo de descripción de OpenAPI.

4. Guarde el manifiesto de aplicación de Teams en la misma carpeta en la que guardó el documento Descripción de OpenAPI y la plantilla de representación de respuesta.

   • Necesita una imagen de color y una imagen de esquema. Estas imágenes deben incluirse en la carpeta y hacer referencia a ellas en el manifiesto de la aplicación de Teams.

   • Comprima el contenido de la carpeta. El archivo ZIP debe incluir los siguientes archivos:

     • Documento de descripción de OpenAPI
     • Plantilla de representación de respuesta
     • Manifiesto de la aplicación
     • Icono de color
     • Icono de esquema

Carga de una aplicación personalizada en Teams

Inicie sesión en el entorno de prueba de Teams para probar la aplicación en Teams. Para cargar una aplicación personalizada en Teams, siga estos pasos:

1. Vaya a Microsoft Teams e inicie sesión con sus credenciales de inquilino de prueba.

2. Vaya a Aplicaciones>Administrar la aplicación>Carga de una aplicación.

3. Seleccione Cargar una aplicación personalizada.

4. Seleccione el archivo ZIP creado y seleccione Abrir.

5. Seleccione Agregar.

   

6. Seleccione Abrir.

   

7. Vaya a un chat, seleccione + en el área de redacción del mensaje y busque la aplicación.

8. Seleccione la aplicación y realice una consulta de búsqueda.

   

9. La aplicación responde con una tarjeta adaptable en la ventana de chat.

10. Seleccione Enviar.

    

Enhorabuena. ¡Lo ha conseguido! Ha aprendido a crear una extensión de mensaje basada en API mediante el documento Descripción de OpenAPI.

Un bot se comporta de forma diferente en función de la conversación en la que esté implicado:

• Los bots en conversaciones de chat de canal y grupo requieren que los usuarios accedan al @mention bot.
• Los bots en una conversación uno a uno no requieren una @mention. Todos los mensajes enviados por el usuario se enrutan al bot.

Esta guía paso a paso le ayuda a crear un bot con autenticación sso. Verá la siguiente salida:

Requisitos previos para compilar un bot

Asegúrese de instalar las herramientas siguientes y de configurar el entorno de desarrollo:

Configuración del inquilino de desarrollo de Teams

Un inquilino es como un espacio o un contenedor donde chatea, comparte archivos y ejecuta reuniones para su organización en Teams. También puede cargar y probar la aplicación personalizada.

Comprobación de una opción de carga de aplicación personalizada

Después de crear la aplicación, debe cargarla en Teams sin distribuirla. Este proceso se conoce como carga de aplicaciones personalizada. Inicie sesión en su cuenta de Microsoft 365 para ver esta opción.

¿Ya tiene un inquilino y tiene acceso de administrador? ¡Vamos a comprobar si realmente lo haces!

Para comprobar las aplicaciones de carga personalizadas en Teams:

1. En el cliente de Teams, seleccione el icono Aplicaciones .

2. Seleccione Administrar las aplicaciones.

3. Seleccione Cargar una aplicación.

4. Busque la opción Cargar una aplicación personalizada. Si ve la opción , la carga de aplicaciones personalizada está habilitada.

   

Creación de un inquilino para desarrolladores de Teams gratuito

Si no tiene una cuenta de desarrollador de Teams, puede obtenerla de forma gratuita. ¡Únete al programa para desarrolladores de Microsoft 365!

1. Vaya al programa para desarrolladores de Microsoft 365.

2. Seleccione Unirse ahora y siga las instrucciones en pantalla.

3. En la pantalla de bienvenida, seleccione Configurar suscripción E5.

4. Configure una cuenta de administrador. Una vez finalizada, se muestra la pantalla siguiente.

   

5. Inicie sesión en Teams con la nueva cuenta de administrador que acaba de configurar. Compruebe que tiene la opción Cargar una aplicación personalizada en Teams.

Configuración del entorno local

Siga estos pasos para clonar el repositorio:

1. Abra Microsoft-Teams-Samples.

2. Seleccione Código.

3. En el menú desplegable, seleccione Abrir con GitHub Desktop.

   

4. Seleccione Clonar.

Registro de Microsoft Entra aplicación

Los pasos siguientes le ayudan a crear y registrar el bot en el Azure Portal:

• Cree y registre la aplicación de Azure.
• Cree un secreto de cliente para habilitar la autenticación sso del bot.
• Agregue el canal de Teams para implementar el bot.
• Cree un túnel a los puntos de conexión del servidor web mediante el túnel de desarrollo (recomendado) o ngrok.
• Agregue el punto de conexión de mensajería al túnel de desarrollo que ha creado.

Agregar registro de aplicación

1. Acceda a Portal Azure.

2. Seleccione Registros de aplicaciones.

   

3. Seleccione + Nuevo registro.

   

4. Escriba el nombre de la aplicación.

5. Seleccione la opción de inquilino, según sea necesario.

6. Seleccione Registrar.

   

   La aplicación está registrada en Microsoft Entra ID. Aparece la página de información general de la aplicación.

   

   Nota:

   Guarde el identificador de la aplicación desde el identificador de aplicación (cliente) y el identificador de directorio (inquilino) para su uso posterior.

Creación de un túnel

Siga uno de los dos métodos siguientes para crear un túnel.

ngrok http --host-header=localhost 3978

Agregar autenticación web

1. En el panel izquierdo, en Administrar, seleccione Autenticación.

2. Seleccione Agregar una plataforma>web.

   

3. Escriba el URI de redireccionamiento de la aplicación anexando auth-end al nombre de dominio completo. Por ejemplo, https://your-devtunnel-domain/auth-end o https://your-ngrok-domain/auth-end.

4. En Flujos híbridos y de concesión implícita, seleccione las casillas Tokens de acceso y tokens de identificador .

5. Seleccione Configurar.

   

6. En Web, seleccione Agregar URI.

7. Escriba https://token.botframework.com/.auth/web/redirect.

8. Haga clic en Guardar.

   

Creación de un secreto de cliente

1. En el panel izquierdo, en Administrar, seleccione Certificados & secretos.

2. En Secretos de cliente, seleccione + Nuevo secreto de cliente.

   

   Aparece la ventana Agregar un secreto de cliente .

3. Escriba Descripción.

4. Seleccione Agregar.

   

5. En Valor, seleccione Copiar en el Portapapeles para guardar el valor del secreto de cliente para su uso posterior.

   

Agregar permisos de API

1. En el panel izquierdo, seleccione Permisos de API.

2. Seleccione + Agregar un permiso.

   

3. Seleccione Microsoft Graph.

4. Seleccione Permisos delegados

5. SeleccioneUsuario.Lectura>.

6. Seleccione Agregar permisos.

   

   Nota:

   • Si a una aplicación no se le concede el consentimiento del administrador de TI, los usuarios deben proporcionar su consentimiento la primera vez que usen una aplicación.
   • Los usuarios deben dar su consentimiento a los permisos de API solo si la aplicación de Microsoft Entra está registrada en un inquilino diferente.

Agregar uri de identificador de aplicación

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

2. Junto a URI de id. de aplicación, seleccione Agregar.

   

3. Actualice el URI del identificador de aplicación en el api://botid-{AppID} formato y seleccione Guardar.

   

Agregar un ámbito

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

2. Seleccione + Agregar un ámbito.

   

3. Escriba access_as_user como nombre del ámbito.

4. En ¿Quién puede dar su consentimiento?, seleccione Administradores y usuarios.

5. Actualice los valores del resto de los campos de la siguiente manera:

   1. Escriba Teams para acceder al perfil del usuario como Administración nombre para mostrar del consentimiento.

   2. Entrar Permite a Teams llamar a las API web de la aplicación como el usuario actual como Administración descripción del consentimiento.

   3. Escriba Teams para acceder al perfil de usuario y realizar solicitudes en nombre del usuario como nombre para mostrar del consentimiento del usuario.

   4. Escriba Habilitar Teams para llamar a las API de esta aplicación con los mismos derechos que el usuario que ladescripción del consentimiento del usuario.

6. Asegúrese de que Estado se establece en Habilitado.

7. Seleccione Agregar ámbito.

   En la imagen siguiente se muestran los campos y los valores:

   

   Nota:

   El nombre del ámbito debe coincidir con el URI del identificador de aplicación con /access_as_user anexado al final.

   

Agregar aplicación cliente

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

   En Aplicaciones cliente autorizadas, identifique las aplicaciones que desea autorizar para la aplicación web de la aplicación.

2. Seleccione + Agregar una aplicación cliente.

   

3. Agregue aplicaciones web de Teams para dispositivos móviles o de escritorio y Teams.

   1. Para equipos móviles o de escritorio de Teams: escriba el identificador de cliente como 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. En Web de Teams: escriba el identificador de cliente como 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Active la casilla Ámbitos autorizados .

5. Seleccione Agregar aplicación.

   

   En la imagen siguiente se muestra el identificador de cliente:

   

Actualizar el manifiesto

1. En el panel izquierdo, seleccione Manifiesto.

2. Establezca el valor de en requestedAccessTokenVersion2 y seleccione Guardar.

   

Creación del bot

Creación de un recurso de bot de Azure

1. Ve a Inicio.

2. Seleccione + Crear un recurso.

3. En el cuadro de búsqueda, escriba Azure Bot.

4. Seleccione Introducir.

5. Seleccione Azure Bot.

6. Seleccione Crear.

   

7. Escriba el nombre del bot en Identificador de bot.

8. Seleccione su Suscripción en la lista desplegable.

9. Seleccione el Grupo de recursos en la lista desplegable.

   

   Si no tiene un grupo de recursos existente, puede crear un nuevo grupo de recursos. Para crear un nuevo grupo de recursos, siga estos pasos:

   1. Seleccione Crear nuevo.
   2. Escriba el nombre del recurso y seleccione Aceptar.
   3. Seleccione una ubicación en la lista desplegable Nueva ubicación del grupo de recursos .

   

10. En Precios, seleccione Cambiar plan.

    

11. Seleccione FO FreeSelect (Seleccionar libre> de FO).

    

12. En Id. de aplicación de Microsoft, seleccione Tipo de aplicación como multiinquilino.

13. En Tipo de creación, seleccione Usar registro de aplicación existente.

14. Escriba el identificador de aplicación.

    Nota:

    No puede crear más de un bot con el mismo identificador de aplicación de Microsoft.

15. Seleccione Revisar y crear.

    

16. Una vez superada la validación, seleccione Crear.

    El bot tarda unos minutos en aprovisionarse.

17. Seleccione Ir a recursos.

    

    Ha creado correctamente el bot de Azure.

    

Agregar un canal de Teams

1. En el panel izquierdo, seleccione Canales.

2. En Canales disponibles, seleccione Microsoft Teams.

   

3. Active la casilla para aceptar los Términos de servicio.

4. Seleccione Aceptar.

   

5. Seleccione Aplicar.

   

Adición de un punto de conexión de mensajería

Use una de las siguientes maneras de agregar un punto de conexión de mensajería:

Agregar una configuración de conexión de OAuth

1. En el panel izquierdo, seleccione Configuración.

2. Seleccione el botón Agregar ajustes de conexión de OAuth en la pantalla Configuración.

3. En Nueva configuración de conexión, actualice los detalles siguientes:

   • Nombre: escriba un nombre para la nueva configuración de conexión. Puede usar el nombre en la configuración del código de bot service.
   • Proveedor de servicios: en la lista desplegable, seleccione Azure Active Directory v2.
   • Id. de cliente: actualice el identificador de aplicación de Microsoft.
   • Secreto de cliente: actualice el valor de los secretos de cliente.
   • Dirección URL de Intercambio de tokens: actualice el URI del identificador de aplicación.
   • Identificador de inquilino: escriba Común.
   • Ámbitos: escriba User.Read.

4. Haga clic en Guardar.

   

Configuración de la configuración de la aplicación y archivos de manifiesto

1. Vaya al archivo appsettings.json en el repositorio clonado.

   

2. Abra el archivo appsettings.json y actualice la siguiente información:

   • Establezca en "MicrosoftAppId" el identificador de aplicación de Microsoft del bot.
   • Establezca en "MicrosoftAppPassword" el valor de id. de secreto de cliente del bot.
   • Establezca ConnectionName como nombre de conexión de OAuth.
   • Establezca en "MicrosoftAppType"MultiTenant.
   • Establézcalo en "MicrosoftAppTenantId"común.

   

3. Vaya al archivo manifest.json en el repositorio clonado.

   

4. Abra el archivo manifest.json y actualice los cambios siguientes:

   • Reemplace todas las repeticiones de por su identificador de aplicación de "{TODO: MicrosoftAppId}" Microsoft.
   • Establezca en "<<domain-name>>" el dominio de ngrok o de túnel de desarrollo.

   

Compilación y ejecución del servicio

1. Abra Visual Studio.

2. Vaya a Archivo>Abrir>proyecto o solución....

   

3. En bot-conversation-sso-quickstart>csharp_dotnetcore carpeta y seleccione BotConversationSsoQuickstart.sln archivo.

   

4. Seleccione F5 para ejecutar el proyecto.

5. Si aparece un cuadro de diálogo Advertencia de seguridad , seleccione Sí.

   

   Se abre una página web con un mensaje El bot está listo.

   Nota:

   Esta página solo aparece cuando se navega a la dirección URL de localhost.

   

   Solución de problemas

   Si recibe el error No se puede encontrar el paquete , siga estos pasos:

   1. Vaya a Herramientas>Configuración del Administrador> depaquetes NuGet.
   2. En la ventana Opciones que aparece, seleccioneOrígenes de paquetes del Administrador > de paquetes NuGet.
   3. Seleccione Agregar.
   4. En Nombre, escriba nuget.org y, en Origen, escriba https://api.nuget.org/v3/index.json.
   5. Seleccione Actualizar y Aceptar.
   6. Recompile el proyecto.

Carga del bot en Teams

1. En el repositorio clonado, vaya a Microsoft-Teams-Samples>>bot-conversation-sso-quickstart>csharp_dotnetcore>TeamsApp>appPackage.

2. Cree un archivo .zip con los siguientes archivos presentes en la carpeta appPackage :

   • manifest.json
   • outline.png
   • color.png

   

3. Vaya a Microsoft Teams.

   1. En el cliente de Teams, seleccione Aplicaciones.
   2. Seleccione Administrar las aplicaciones.
   3. Seleccione Cargar una aplicación.
   4. Busque la opción Cargar una aplicación personalizada.

   

4. Seleccione Abrir para cargar el archivo .zip que ha creado en la carpeta Manifiesto .

   

5. Seleccione Agregar para agregar el bot al chat.

   

6. Seleccione Abrir.

   

   Puede interactuar con el bot enviándole un mensaje. El bot intercambia un token de SSO y llama a la Graph API en su nombre. Mantiene la sesión iniciada a menos que envíe un mensaje para cerrar la sesión.

7. Envíe un mensaje al bot. El bot de conversación pide consentimiento por primera vez.

8. Para escritorio: seleccione Continuar para conceder permisos al cliente de Teams para acceder al bot.

   

   Nota:

   Ahora ha configurado el inicio de sesión único con la aplicación de bot y es el único momento en que tendrá que dar su consentimiento.

9. Para dispositivos móviles: seleccione Aceptar.

   Nota:

   Ahora ha configurado el inicio de sesión único con la aplicación de bot en dispositivos móviles y es el único momento en que tendrá que dar su consentimiento.

   

¿Se te ocurrió algo como esto?

Ha completado el tutorial para empezar a compilar un bot con autenticación sso.

Esta guía paso a paso le ayuda a crear una pestaña con Microsoft 365 Agents Toolkit (anteriormente conocido como Kit de herramientas de Teams). Verá la siguiente salida después de completar esta guía:

Requisitos previos para compilar la aplicación

Esta es una lista de herramientas que debe instalar para compilar e implementar una aplicación de Teams.

Instalación del kit de herramientas de agentes

Agents Toolkit ayuda a simplificar el proceso de desarrollo con herramientas para crear un scaffolding de proyecto para la aplicación. Crea la estructura de directorios necesaria para todas las funcionalidades seleccionadas con los archivos necesarios en su lugar, listos para compilar el proyecto.

Puede descargar el instalador de Visual Studio más reciente. Agents Toolkit está disponible como extensión en Visual Studio.

Después de abrir el instalador de Visual Studio en la ventana de cargas de trabajo emergentes:

1. Seleccione ASP.NET y desarrollo web.

2. En Detalles de> instalaciónOpcional, seleccione Herramientas de desarrollo de Microsoft Teams.

3. Seleccione Instalar.

   

4. Seleccione Iniciar. Aparece la ventana de la aplicación de Visual Studio 2022.

   

5. Vaya a Extensiones>Administrar extensiones.

   

   Aparece la ventana Administrar extensión:

   

6. En el panel izquierdo, seleccione Instalado. La extensión Microsoft 365 Agents Toolkit está disponible.

   

Configuración del inquilino de desarrollo de Teams

Un inquilino es como un espacio o un contenedor para su organización en Teams, donde chatea, comparte archivos y ejecuta reuniones. Este espacio también es donde carga y prueba la aplicación personalizada. Vamos a comprobar si está listo para desarrollar con el inquilino.

Comprobación de la opción de carga de aplicaciones personalizadas

Después de crear la aplicación, debe cargarla en Teams sin distribuirla. Este proceso se conoce como carga de aplicaciones personalizada. Inicie sesión en su cuenta de Microsoft 365 para ver esta opción.

¿Ya tiene un inquilino y acceso de administrador? ¡Vamos a comprobar si lo haces!

Compruebe si puede cargar aplicaciones personalizadas en Teams:

1. Abra Microsoft Teams y seleccione el icono Aplicaciones .

2. Seleccione Administrar las aplicaciones.

3. Seleccione Cargar una aplicación.

4. Busque la opción Cargar una aplicación personalizada . Si ve la opción , la carga de aplicaciones personalizada está habilitada.

   

Creación de un inquilino para desarrolladores de Teams gratuito (opcional)

Si no tiene una cuenta de Teams, puede obtenerla de forma gratuita. ¡Únete al programa para desarrolladores de Microsoft 365!

1. Vaya al programa para desarrolladores de Microsoft 365.

2. Seleccione Unirse ahora y siga las instrucciones en pantalla.

3. En la pantalla de bienvenida, seleccione Configurar suscripción E5.

4. Configure su cuenta de administrador. Una vez finalizada, aparece la siguiente pantalla:

   

5. Inicie sesión en Teams con la cuenta de administrador que configuró. Compruebe que tiene la opción Cargar una aplicación personalizada en Teams.

Obtener una cuenta de Azure gratuita

Si desea hospedar la aplicación o acceder a los recursos en Azure, debe tener una suscripción de Azure. Cree una cuenta gratuita antes de empezar.

Ahora tiene todas las herramientas para configurar su cuenta. A continuación, vamos a configurar el entorno de desarrollo y empezar a compilar. Seleccione primero la aplicación que desea crear.

Creación del área de trabajo del proyecto para la aplicación de pestaña mediante C sharp

Inicie el desarrollo de aplicaciones de Microsoft Teams mediante la creación de la primera aplicación. Esta aplicación usa la funcionalidad de tabulación. Si se cumplen los requisitos previos, comencemos.

Los pasos siguientes le ayudan a crear el área de trabajo del proyecto para la aplicación de pestaña en Visual Studio:

1. Abra Visual Studio.

2. Seleccione Nuevo proyecto.

   

3. En el cuadro de búsqueda, escriba Teams.

4. Seleccione Microsoft 365 Agents Next (Agentes de Microsoft 365a continuación).>

   

5. Escriba los detalles siguientes para configurar el nuevo proyecto.

6. Escriba el nombre del proyecto requerido en Nombre del proyecto.

7. Seleccione la ubicación necesaria para guardar archivos y carpetas del proyecto.

8. Seleccione Crear.

   

9. SeleccioneCrearpestaña>.

   

La aplicación de pestaña Teams se crea en pocos segundos.

Compilación y ejecución de la primera aplicación de pestaña con C sharp

Después de configurar el área de trabajo del proyecto con Agents Toolkit, compile la aplicación de pestaña.

Inicio de sesión en su cuenta de Microsoft 365

Use su cuenta de Microsoft 365 para iniciar sesión en Teams. Si usa un inquilino del programa para desarrolladores de Microsoft 365, la cuenta de administrador que configuró al registrarse es la cuenta de Microsoft 365.

1. En el Explorador de soluciones, en Solución MyTeamsApp, haga clic con el botón derecho en MyTeamsApp.

2. Seleccione Microsoft 365 Agents Toolkit>Seleccione Cuenta de Microsoft 365.

   

3. SeleccioneContinuarcuenta> de Microsoft 365.

   

Compilación y ejecución de la aplicación localmente en Visual Studio

Para crear y ejecutar la aplicación localmente:

1. Seleccione Depurar>Iniciar depuración o F5.

   

   Visual Studio inicia el proceso de depuración y abre el cliente web de Teams en un explorador. Si se le solicita, inicie sesión con la cuenta de Microsoft 365.

2. Seleccione Agregar.

   

3. Seleccione Abrir para abrir la aplicación en el ámbito personal.

Como alternativa, puede buscar y seleccionar el ámbito necesario o seleccionar un canal o chat de la lista, y desplazarse por el cuadro de diálogo para seleccionar Ir.

Enhorabuena, la primera aplicación de pestaña se ejecuta en Teams.

Ha creado correctamente una aplicación de pestaña mediante C#. Agents Toolkit ha agregado el scaffolding necesario a la estructura de directorios de la aplicación. El tutorial ya está completo.

Esta guía paso a paso le ayuda a crear pestañas y extensiones de mensajes que habilitan la autenticación Microsoft Entra SSO. Verá la siguiente salida:

Requisitos previos para agregar sso a aplicaciones

Asegúrese de instalar las herramientas siguientes y de configurar el entorno de desarrollo:

Configuración del entorno local

1. Abra Microsoft-Teams-Samples.

2. Seleccione Código.

3. En el menú desplegable, seleccione Abrir con GitHub Desktop.

   

4. Seleccione Clonar.

Registro de Microsoft Entra aplicación

Los pasos siguientes le ayudan a crear y registrar el bot en Azure Portal:

• Cree y registre la aplicación de Azure.
• Cree un secreto de cliente para habilitar la autenticación sso del bot.
• Agregue el canal de Teams para implementar el bot.
• Cree un túnel a los puntos de conexión del servidor web mediante el túnel de desarrollo (recomendado) o ngrok.
• Agregue el punto de conexión de mensajería al túnel de desarrollo que ha creado.

Agregar registro de aplicación

1. Acceda a Portal Azure.

2. Seleccione Registros de aplicaciones.

   

3. Seleccione + Nuevo registro.

   

4. Escriba el nombre de la aplicación.

5. Seleccione Cuentas en cualquier directorio organizativo (cualquier inquilino Microsoft Entra ID multiinquilino).

6. Seleccione Registrar.

   

   La aplicación está registrada en Microsoft Entra ID. Aparece la página de información general de la aplicación.

   

   Nota:

   Guarde el identificador de la aplicación desde el identificador de aplicación (cliente) y el identificador de directorio (inquilino) para su uso posterior.

Creación de un túnel

Seleccione una de las siguientes maneras de crear un túnel:

ngrok http --host-header=localhost xxxx

Adición de una autenticación web

1. En el panel izquierdo, en Administrar, seleccione Autenticación.

2. Seleccione Agregar una plataforma>web.

   

3. Escriba el URI de redireccionamiento de la aplicación anexando auth-end al nombre de dominio completo. Por ejemplo, https://your-devtunnel-domain/auth-end o https://your-ngrok-domain/auth-end.

4. En Flujos híbridos y de concesión implícita, seleccione las casillas Tokens de acceso y tokens de identificador .

5. Seleccione Configurar.

   

6. En Web, seleccione Agregar URI.

7. Escriba https://token.botframework.com/.auth/web/redirect.

8. Haga clic en Guardar.

   

Creación de un secreto de cliente

1. En el panel izquierdo, en Administrar, seleccione Certificados & secretos.

2. En Secretos de cliente, seleccione + Nuevo secreto de cliente.

   

   Aparece la ventana Agregar un secreto de cliente .

3. Escriba Descripción.

4. Seleccione Agregar.

   

5. En Valor, seleccione Copiar en el Portapapeles para guardar el valor del secreto de cliente para su uso posterior.

   

Agregar permisos de API

1. En el panel izquierdo, seleccione Permisos de API.

2. Seleccione + Agregar un permiso.

   

3. Seleccione Microsoft Graph.

4. Seleccione Permisos delegados

5. SeleccioneUsuario.Lectura>.

6. Seleccione Agregar permisos.

   

   Nota:

   • Si a una aplicación no se le concede el consentimiento del administrador de TI, los usuarios deben proporcionar su consentimiento la primera vez que usen una aplicación.
   • Los usuarios deben dar su consentimiento a los permisos de API solo si la aplicación de Microsoft Entra está registrada en un inquilino diferente.

Agregar uri de identificador de aplicación

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

2. Junto a URI de id. de aplicación, seleccione Agregar.

   

3. Actualice el URI del identificador de aplicación en el api://your-devtunnel-domain/botid-{AppID} formato o api://your-ngrok-domain/botid-{AppID} y seleccione Guardar.

   

   En la imagen siguiente se muestra el nombre de dominio:

   

Agregar un ámbito

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

2. Seleccione + Agregar un ámbito.

   

3. Escriba access_as_user como nombre del ámbito.

4. En ¿Quién puede dar su consentimiento?, seleccione Administradores y usuarios.

5. Actualice los valores del resto de los campos de la siguiente manera:

   • Escriba Teams para acceder al perfil del usuario como Administración nombre para mostrar del consentimiento.

   • Entrar Permite a Teams llamar a las API web de la aplicación como el usuario actual como Administración descripción del consentimiento.

   • Escriba Teams para acceder al perfil de usuario y realizar solicitudes en nombre del usuario como nombre para mostrar del consentimiento del usuario.

   • Escriba Habilitar Teams para llamar a las API de esta aplicación con los mismos derechos que el usuario que ladescripción del consentimiento del usuario.

6. Asegúrese de que Estado se establece en Habilitado.

7. Seleccione Agregar ámbito.

   En la imagen siguiente se muestran los campos y los valores:

   

   Nota:

   El nombre del ámbito debe coincidir con el URI del identificador de aplicación con /access_as_user anexado al final.

   

Agregar aplicación cliente

1. En el panel izquierdo, en Administrar, seleccione Exponer una API.

   En Aplicaciones cliente autorizadas, identifique las aplicaciones que desea autorizar para la aplicación web de la aplicación.

2. Seleccione + Agregar una aplicación cliente.

   

3. Agregue aplicaciones web de Teams para dispositivos móviles o de escritorio y Teams.

   1. Para equipos móviles o de escritorio de Teams: escriba el identificador de cliente como 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. En Web de Teams: escriba el identificador de cliente como 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Active la casilla Ámbitos autorizados .

5. Seleccione Agregar aplicación.

   

   En la imagen siguiente se muestra el identificador de cliente:

   

Actualizar el manifiesto

1. En el panel izquierdo, seleccione Manifiesto.

2. Establezca el valor de en requestedAccessTokenVersion2 y seleccione Guardar.

   

Creación de un bot

Creación de un recurso de bot de Azure

1. Ve a Inicio.

2. Seleccione + Crear un recurso.

3. En el cuadro de búsqueda, escriba Azure Bot.

4. Seleccione Introducir.

5. Seleccione Azure Bot.

6. Seleccione Crear.

   

7. Escriba el nombre del bot en Identificador de bot.

8. Seleccione su Suscripción en la lista desplegable.

9. Seleccione el Grupo de recursos en la lista desplegable.

   

   Si no tiene un grupo de recursos existente, puede crear un nuevo grupo de recursos. Para crear un nuevo grupo de recursos, siga estos pasos:

   1. Seleccione Crear nuevo.
   2. Escriba el nombre del recurso y seleccione Aceptar.
   3. Seleccione una ubicación en la lista desplegable Nueva ubicación del grupo de recursos .

   

10. En Precios, seleccione Cambiar plan.

    

11. Seleccione FO FreeSelect (Seleccionar libre> de FO).

    

12. En Id. de aplicación de Microsoft, seleccione Tipo de aplicación como multiinquilino.

13. En Tipo de creación, seleccione Usar registro de aplicación existente.

14. Escriba el identificador de aplicación.

    Nota:

    No puede crear más de un bot con el mismo identificador de aplicación de Microsoft.

15. Seleccione Revisar y crear.

    

16. Una vez superada la validación, seleccione Crear.

    El bot tarda unos minutos en aprovisionarse.

17. Seleccione Ir a recursos.

    

    Ha creado correctamente el bot de Azure.

    

Agregar un canal de Teams

1. En el panel izquierdo, seleccione Canales.

2. En Canales disponibles, seleccione Microsoft Teams.

   

3. Active la casilla para aceptar los Términos de servicio.

4. Seleccione Aceptar.

   

5. Seleccione Aplicar.

   

Para agregar un punto de conexión de mensajería

Agregar una configuración de conexión de OAuth

1. En el panel izquierdo, seleccione Configuración.

2. Seleccione el botón Agregar ajustes de conexión de OAuth en la pantalla Configuración.

3. En Nueva configuración de conexión, actualice los detalles siguientes:

   • Nombre: escriba un nombre para la nueva configuración de conexión. Puede usar el nombre en la configuración del código de bot service.
   • Proveedor de servicios: en la lista desplegable, seleccione Azure Active Directory v2.
   • Id. de cliente: actualice el identificador de aplicación de Microsoft.
   • Secreto de cliente: actualice el valor de los secretos de cliente.
   • Dirección URL de Intercambio de tokens: actualice el URI del identificador de aplicación.
   • Identificador de inquilino: escriba Común.
   • Ámbitos: escriba User.Read.

4. Haga clic en Guardar.

   

Configuración de la aplicación

1. Vaya al archivo appsettings.json en el repositorio clonado.

   

2. Abra el archivo appsettings.json en Visual Studio.

3. Actualice la siguiente información:

   • Reemplace por "MicrosoftAppId" el identificador de aplicación de Microsoft del bot.
   • Reemplace por "MicrosoftAppPassword" el valor de los secretos de cliente del bot.
   • Reemplace por "SiteUrl" la dirección URL de ngrok.
   • Reemplace por "ConnectionName" el nombre de la configuración de conexión de OAuth.
   • Reemplace por "TenantId" el identificador de inquilino del inquilino donde se usa la aplicación.
   • Reemplace por "ClientId" el identificador de aplicación de Microsoft del bot.
   • Reemplace por "AppSecret" el valor de los secretos de cliente del bot.
   • Reemplace "ApplicationIdURI" en forma de api://*******.ngrok.io/botid-{AppID}.

   

Configuración del archivo de manifiesto

1. Vaya al archivo manifest.json en el repositorio clonado.

   

2. Abra el archivo manifest.json en Visual Studio y realice los siguientes cambios:

   • Reemplace por DOMAIN-NAME la dirección URL de ngrok.

   • Reemplace por YOUR-MICROSOFT-APP-ID el identificador de aplicación de Microsoft del bot.

     Nota:

     Dependiendo del escenario [YOUR-MICROSOFT-APP-ID] y [DOMAIN-NAME] puede producirse varias veces.

   • Reemplace resource como api://*******.ngrok.io/botid-{AppID}.
     

     

Compilación y ejecución del servicio

Para compilar y ejecutar el servicio, use Visual Studio o la línea de comandos.

dotnet run