Sovelluksen ja mukautettujen työkalujen ottaminen käyttöön Microsoft 365 Copilotissa

[Tämä ohjeaihe sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Microsoft 365 Copilotin Power Appsin avulla käyttäjät voivat käyttää mallipohjaista sovellustasi suoraan Copilotista. Kun käyttäjä puhuu agentille, se voi näyttää sovelluksesi tiedot vuorovaikutteisena käyttöliittymänä, ruudukkona tietueiden selaamista varten tai lomakkeen niiden tarkastelemista, muokkaamista tai luomista varten, kaikki tämä poistumatta Copilot-kokemuksesta. Lisäksi voit lisätä mukautettuja MCP-työkaluja ja vuorovaikutteisen käyttöliittymän sovelluksen deklaratiiviseen edustajaan. Tämä toiminto toteutetaan MCP-sovellusten kautta, mikä on MCP:n laajennus, jonka avulla MCP-palvelimet voivat tarjota vuorovaikutteisia käyttöliittymiä isännille. Ominaisuus toimii luomalla MCP-palvelimen ja määrittävän agentin sovelluksestasi.

Edellytykset

• Mallipohjainen sovellus. Tällä hetkellä tämä ominaisuus on käytettävissä vain mallipohjaisissa sovelluksissa.
• Microsoft 365 Copilot -käyttöoikeus. Pakollinen sekä tekijälle, joka ottaa agentin käyttöön että loppukäyttäjät, jotka käsittelevät agenttia.
• Oikeus ladata mukautettuja sovelluksia Microsoft Teamsiin. Microsoft 365 -järjestelmänvalvojasi saattaa joutua ottamaan tämän käyttöön. Tarkista Teams-järjestelmänvalvojan asetukset, jos latausvaihtoehto ei ole näkyvissä.

Power Appsin määrittäminen Copilotissa

1. Siirry Power Appsiin, valitse haluamasi ympäristö ja avaa sitten haluttu mallipohjainen sovellus.

2. Valitse sovelluksen MCP-kuvake vasemmasta siirtymispalkista ja valitse sitten Määritä MCP. Tämä toiminto määrittää sovelluksen MCP-palvelimen, joka tarjoaa MCP-työkaluja Copilot-keskusteluihin. Tämä on kertaluonteinen vaihe, jonka suorittaminen voi kestää muutamia sekunteja.

   

3. Tallenna ja julkaise sovellus.

4. Lataa sovelluksesi MCP:n luoma deklaratiivisen agentin tiedosto valitsemalla Lataa sovelluspaketti . Tämä paketti sisältää agentin määrityksen, sisäiset tallennus- ja tietotyökalut sekä määritykset, joita tarvitaan sovelluksesi käyttökokemuksen käyttöönottoon Microsoft 365 -copilotissa.

   

5. Lataa Microsoft Teamsiin tai Microsoft 365 -agentteihin pakattu tiedosto, jonka nimi on vastaava kuin deklaratiivisen agentin ja sovelluksen name.zip :

   • Teams: Lataa henkilökohtaiseen käyttöön mukautettuna sovelluksena Teamsissa. Lisätietoja Sovelluksen lataaminen Teamsiin
   • Microsoft 365 -agentit: Julkaise paketti työryhmälle tai ryhmälle Microsoft 365 -hallintakeskuksesta. Lisätietoja: Julkaisuagentit

Voit nyt esittää kysymyksiä sovelluksen taulukoista tästä määrittävästä agentista. Sisäiset työkalut voivat näyttää vuorovaikutteisen ruudukon tietojoukkokyselyille.

Lisäksi älykkäitä lomakkeita voidaan käyttää tietueiden luomiseen, tarkastelemiseen ja muokkaamiseen Microsoft 365 Copilot -kontekstissa.

Mukautettujen työkalujen luominen

Sovelluksen deklaratiivisen agentin sisäisen työkalun lisäksi sen toimintaa voidaan laajentaa sisällyttämällä mukautettuja työkaluja ja pienoissovelimia. Kehotteeseen perustuvan muodostimen avulla voidaan integroida mukautettuja MCP-työkaluja ja vuorovaikutteisia käyttöliittymäkomponentteja sovelluksen deklaratiiviseen edustajaan. Esimerkiksi Zava Airlines -sovelluksessa voidaan lisätä mukautettu työkalu, joka näyttää lentokartan lentoaikajanan rinnalla Gantt-kaaviona rinnakkaisessa näkymässä.

1. Valitse Luo mukautettu työkaluSovelluksen MCP -välilehden Työkalut-osassa.

2. Anna työkalulle selkeä, kuvaava nimi ja kuvaus , sillä Microsoft 365 Copilot käyttää näitä tietoja sen määrittämiseen, milloin se kannattaa käynnistää.

3. Lisää ohjeet sellaisten työkalujen tietojen tulostamiseen, joiden oletusarvo on JSON-muoto. Voit muuttaa sen tekstiksi, jos työkaluun ei ole liitetty käyttökokemusta. Ohjeet voivat sisältää kyselyjä tietyille taulukon tietueille sovelluksessa tai se voi olla syöteparametri työkalun ketjuttamiseen käytettävälle työkalulle. Muista kokeilla ja valita oikea kehote tekoälymallille.

   

4. Valitse Testaa , jos haluat tarkistaa ja vahvistaa työkalun tulokset, ja valitse sitten Seuraava. Voit nyt luoda ja liittää tähän työkaluun liittyviä valinnaisia mukautettuja HTML-koodia . Voit luoda tämän HTML:n /generate-mcp-apps-ui skill tai oman kehitystyökalusi avulla. Valitse Tallenna.

   

5. Lataa päivitetty sovelluspaketti zip ja lataa uusin versio Microsoft Teamsiin tai Microsoft 365 -agentteihin.

6. Käynnistä työkalu antamalla asianmukainen kysely sovellusagentissa, jotta näet mukautetun käyttöliittymän käytännössä.

   

Dynaamisten työkalujen ketjutus

Työkalujen ketjutus Power Appsin deklaratiivisissa agentteissa käyttää Microsoft 365 Copilot -orkestraattoria käyttäjäaikeiden ylittämiseen ja useiden MCP:tä hyödyntävien toimintojen (työkalujen) dynaamiseen käynnistämiseen järjestyksessä tehtävän suorittamiseksi. Järjestelijä valitsee, parametrisoi ja suorittaa MCP-sovelluksen toimintojen oikean yhdistelmän kontekstin ja funktioiden kuvausten perusteella ja mahdollistaa päästä päähän -työnkulut Power Appsissa ja yritysjärjestelmissä. Näin voit luoda työkalun, joka käyttää parametrisoitua syötettä.

1. Valitse Luo mukautettu työkaluSovelluksen MCP -välilehden Työkalut-osassa.

2. Anna työkalulle selkeä, kuvaava nimi ja kuvaus , sillä Microsoft 365 Copilot käyttää näitä tietoja sen määrittämiseen, milloin se kannattaa käynnistää.

3. Tässä esimerkissä käytämme Sankey-kaavion visualisointia. Määritä ensin Sankey-kaavion luomiseen tarvittava JSON-syöterakenne. Luo seuraavaksi kehote Sankey-kaavion visualisointityökalulle. Työkalu näyttää syöteparametrin nimeltä SankeyDiagramVisualizationInputData. Työkalu tulkitsee tämän parametrin ja muuntaa sen visualisoinnin odottamaksi JSON-rakenteeksi. Valitse selkeä ja kuvaava syöteparametrin nimi, jotta LLM tunnistaa työkalun ja käynnistää sen oikein.

   

4. Voit nyt luoda ja liittää tähän työkaluun erityisesti mukautetun HTML: n. Voit luoda tämän HTML:n /generate-mcp-apps-ui skill tai oman kehitystyökalusi avulla. Valitse Tallenna.

5. Lataa päivitetty sovelluspaketti zip ja lataa uusin versio Microsoft Teamsiin tai Microsoft 365 -agentteihin.

6. Copilot voi nyt käyttää luonnollisen kielen kyselyjä tietojen noutamiseen ja välittämiseen visualisointityökalulle. Voit esimerkiksi käyttää monitasoista kyselyä, jos haluat saada dynaamisesti syötteitä ongelmat-taulukkotiedoista, ja visualisoida ne Sankey Chart Visualizer -työkalun avulla.

   

7. Voit tarkentaa Sankey-kaaviota jatkamalla keskustelua.

   

Esimerkki koko näytön näytöstä

Tässä esimerkissä Laajenna-painike hahmonnetaan vain, jos isäntä tukee koko näytön tilaa.

function renderExpandButton(app) {
  const ctx = app.getHostContext();

  // Don't render the button if the host doesn't support fullscreen
  if (!ctx?.availableDisplayModes?.includes('fullscreen')) {
    return null;
  }

  const btn = document.createElement('button');
  btn.addEventListener('click', async () => {
    const result = await app.requestDisplayMode({ mode: 'fullscreen' });
    // Always use result.mode — the host may grant a different mode than requested
    console.log('Granted mode:', result.mode);
  });
  return btn;
}

Sama suojaus koskee mitä tahansa isäntäominaisuutta. Tarkista getHostContext() ennen käyttöä:

const ctx = app.getHostContext();

// Theme
if (ctx?.theme) applyTheme(ctx.theme);

// Current display mode
if (ctx?.displayMode === 'fullscreen') { /* adjust layout */ }

// Available modes
if (ctx?.availableDisplayModes?.includes('inline')) { /* show collapse option */ }

Reagoi kyvykkyyksien muutoksiin ajon aikana onhostcontextchanged — isäntäympäristö voi päivittyä connect() jälkeen.

app.onhostcontextchanged = (ctx) => {
  if (ctx.theme) applyTheme(ctx.theme);
  if (ctx.displayMode) updateLayout(ctx.displayMode);
};

Koko näytön tilan käyttäminen työkalutulosten kanssa

Yleinen malli on vaihtaa koko näyttöön automaattisesti, kun pienoissovellus vastaanottaa tietoja, mikä antaa sisällölle enemmän tilaa hahmontaa.

app.ontoolresult = async (result) => {
  const data = result.structuredContent;
  if (!data) return;

  // Expand to fullscreen when data arrives, if the host supports it
  const ctx = app.getHostContext();
  if (ctx?.availableDisplayModes?.includes('fullscreen') && currentMode !== 'fullscreen') {
    const granted = await app.requestDisplayMode({ mode: 'fullscreen' });
    currentMode = granted.mode;
    document.body.classList.toggle('mode-fullscreen', currentMode === 'fullscreen');
  }

  renderData(data);
};

Voit myös antaa käyttäjän päättää – hahmontaa ensin nykyiseen tilaan ja tarjota sitten Laajenna-painikkeen:

app.ontoolresult = (result) => {
  const data = result.structuredContent;
  if (!data) return;

  renderData(data);        // render in whatever mode is active
  updateExpandBtn();       // show the expand button now that there is content
};

Aiheeseen liittyviä artikkeleita

MCP-sovelluksen pienoissovellusten luominen tekoälykoodin muodostustyökaluilla

Usein kysyttyjä kysymyksiä Power Appsille agentteissa