Aloita Agent 365:n kehittäminen

Agent 365 tukee monenlaisia agenttien toteutuksia. Agentti voi auttaa käyttäjiä tarvittaessa, toimia autonomisesti taustalla tai käyttää omaa käyttäjäidentiteettiään Microsoft 365:ssä. On tärkeää ymmärtää, mikä toimintamalli parhaiten kuvaa agenttiasi, koska se määrittää agentin identiteettimallin, sen pääsyn Microsoft 365 -resursseihin ja mitkä elinkaaren vaiheet ovat relevantteja.

Agenttityypit

Ennen kuin aloitat, kysy itseltäsi: Millaista agenttia rakennat?

Agentteja on kahta tyyppiä sen mukaan, millainen pääsy niillä on.

Agentin tyyppi Yleiskatsaus
Agentit Toimii käyttäjän puolesta delegoidulla käyttöoikeudella tai sovelluksena rajatuilla käyttöoikeuksilla. Rekisteröity Microsoft Entra -sovelluksiksi tai agentin identiteetin blueprinteiksi.
Tekoälytiimikaveri Toimii omalla käyttäjäidentiteetillään Microsoft 365:ssä, mukaan lukien postilaatikko, Teamsin läsnäolo ja hakemistomerkintä. Tämä agenttityyppi on saatavilla vain Frontier-esiversio-ohjelmaan osallistuville vuokralaisille.

Agentit

Agentti toimii käyttäjän puolesta. Se vastaa pyyntöihin, suorittaa tehtäviä taustalla, yhdistyy API:eihin, käsittelee dataa ja ohjaa toimintoja.

Agentteja on monenlaisia. Jotkut ovat keskustelevia – käyttäjä kysyy jotain ja agentti vastaa. Jotkut pyörivät hiljaa taustalla – aikataulun, tapahtuman tai saapuvan viestin laukaisemana – ilman että kukaan on aktiivisesti mukana. Jotkut tekevät molempia.

Esimerkkiskenaariot:

  • Käyttäjä pyytää agenttia tiivistämään lukemattomat sähköpostinsa ja luonnostelemaan vastauksia. Agentti suorittaa tehtävän, käyttää vain käyttäjän käytettävissä olevia resursseja ja palauttaa tuloksen käyttäjälle.
  • Asiakaspalvelija auttaa tuki-insinööriä tekemään kyselyjä sisäisiin tietokantoihin ja laatimaan vastauksia reaaliaikaisen tukisession aikana.
  • Sääntöjen noudattamisen valvonta-agentti toimii joka yö, tarkistaa SharePoint-sivustot, joihin agentille on myönnetty pääsy käytäntörikkomusten osalta, ja laatii auditointiraportteja – ilman, että kukaan seuraa.
  • Tilausten käsittelyagentti noutaa uudet myyntitilaukset jonosta, päivittää CRM-järjestelmää ja lähettää vahvistussähköposteja – täysin automaattisesti, ilman manuaalista käynnistystä.

Identiteetin perusta:

Perinteisesti agentit rekisteröidään Microsoft Entra -sovelluksina. Tämä lähestymistapa toimii edelleen. Jatkossa voit myös rakentaa agentteja Microsoft Entra -agenttitunnuksen avulla hyödyntäen agentin identiteetti -blueprintia – IT:n hyväksymä, hallintovaatimusten mukainen määritelmä agentin kyvykkyyksistä, sallitusta työkalujen käytöstä ja vaatimustenmukaisuuden rajoituksista. Blueprintin pohjalta rakentaminen on suositeltu tapa uusille agenteille. Se mahdollistaa hallitun Work IQ -työkalujen käytön, Microsoft Purviewin datan suojauksen, Microsoft Defenderin uhkien valvonnan ja Entra ID -tunnus:n hallinnan – tehden agentistasi täysin hallitun yritysidentiteetin alusta alkaen. Jos agenttisi käyttäjät kirjautuvat sisään kolmannen osapuolen identiteettipalveluntarjoajan kautta, katso Integroi Microsoft Entra -agenttitunnus kolmannen osapuolen identiteettipalveluntarjoajiin.

Tekoälytiimikaveri

Tärkeää

Saadaksesi varhaisen pääsyn tämän tyyppiseen agenttiin, sinun täytyy olla Frontier-esiversio-ohjelman jäsen. Frontier yhdistää sinut suoraan Microsoftin uusimpiin tekoälyinnovaatioihin. Frontier-esiversiot noudattavat asiakassopimustesi olemassa olevia esiversioehtoja. Koska nämä ominaisuudet ovat vielä kehitteillä, niiden saatavuus ja ominaisuudet voivat muuttua ajan myötä.

Tekoälyagentti toimii Microsoft 365:ssä käyttäen omaa agentti-identiteettiään. Voit määrittää sille ominaisuuksia, kuten sähköpostin lähettämisen ja vastaanottamisen omasta postilaatikostaan, osallistumisen Teamsin 1:1- ja ryhmäkeskusteluihin sekä näkymisen hakemistossa ja organisaation metatiedoissa määrätyn esimiehen kanssa. Ihmiset voivat olla vuorovaikutuksessa sen kanssa tuttujen Microsoft 365 -käyttöliittymien, @mentions, sähköpostin, kalenterikutsujen ja Teams-keskustelujen kautta.

Luo nämä agentit agentti-identiteettisuunnitelman pohjalta, joka on IT-hyväksytty ja hallinnon valvoma määritelmä agentin kyvykkyyksistä, sallituista työkalujen käytöistä ja vaatimustenmukaisuusrajoitteista. Jokainen agentti-instanssi perii identiteettimallin, käyttöoikeudet ja käytännöt agentin identiteettisuunnitelmasta.

Se, mitä agentti tekee – onko se keskusteleva, taustalla toimiva vai molempia – riippuu siitä, miten sen suunnittelet. Jotkut agentit ovat erittäin vuorovaikutteisia, vastaavat viesteihin ja tukevat työskentelyä reaaliajassa. Toiset käsittelevät tehtäviä taustalla, toimien sähköpostien tai tapahtumien perusteella ilman suoraa käyttäjän osallistumista. Agentti toimii omalla käyttäjäidentiteetillään, ja sen toiminnot ovat hallittuja ja auditoitavissa kyseisen identiteetin kautta.

Jos sinulla on jo agentti, sinun ei tarvitse aloittaa alusta. Voit laajentaa olemassa olevia agentteja toimimaan omalla identiteetillään lisäämällä agentin identiteetti- ja blueprint-määrityksen, joka on kuvattu myöhemmin tässä oppaassa.

Esimerkkiskenaariot:

  • Lisää HR:n perehdytyksen tekoälytiimikaveri uuden työntekijän Teams-kanavalle. Se lähettää tervetulosähköposteja omasta postilaatikostaan, suunnittelee perehdytyskokoukset omaan kalenteriinsa ja vastaa kysymyksiin hyödyntäen kyseiselle agentin instanssille määritettyjä ominaisuuksia.
  • Aseta esimiessuhde hakemiston metatiedoissa hankinta-AI-tiimikaverille. Työntekijät lähettävät ostopyyntöjä sähköpostitse sen postilaatikkoon. Agentti käsittelee pyynnön, hakee tietoja ERP- ja talousjärjestelmistä käyttäen säädeltyä Work IQ -työkalun käyttöoikeutta ja vastaa hyväksynnällä tai eskalaatiolla oman identiteettinsä kautta.
  • Lisää tutkimustekoälyagentti projektitiimin SharePoint-sivustolle ja Teams-kanavalle. Se voi tuoda esiin relevantteja dokumentteja kokousten aikana, vastata keskusteluketjuissa ja laatia viikoittaisia tilanneraportteja käyttämällä kyseisen agentin käyttöoikeuksia ja työkaluja.

Identiteetin perusta:

Perustuu agentin identiteettisuunnitelmaan, joka luo Microsoft Entra -agenttitunnuksen ja siihen liittyvän käyttäjätilin; vaaditaan aina.

Agent 365 -ominaisuuksien käyttöönotto vaiheittain

Agent 365 ei ole kaikki tai ei mitään. AI-tiimikaveria ei tarvitse rakentaa heti alkuun – tai ollenkaan, jos käyttötapauksesi ei sitä vaadi. Omaksu ominaisuudet vaiheittain, aloittaen siitä, mitä agenttisi tarvitsee nyt ja laajentaen niitä tarpeidesi kehittyessä.

Miksi rakentaa agentti identiteettiblueprintin pohjalle?

Kun luot agentin identiteettiblueprintin, Agent 365 CLI provisioi agentillesi Microsoft Entra -agenttitunnuksen – ensiluokkaisen identiteetin vuokraajassasi, joka on samojen yrityshallinnon käytäntöjen alainen kuin ihmiskäyttäjät. Yksittäinen identiteetti on perustana niille turvallisuushyödyille, jotka tulevat automaattisesti kaikille blueprint-pohjaisille agenteille.

Etu Mitä tämä tarkoittaa agentillesi
Integroitu Microsoft Entra ID Agentin identiteetin ja käyttöoikeuden elinkaaria hallinnoidaan samoilla ehdollisilla käyttöoikeuksilla, identiteetin suojauksella ja käyttöoikeustarkastuksilla, jotka koskevat ihmiskäyttäjiä.
Microsoft Purview Jokainen agentin suorittama datan käsittely kuuluu vuokralaisesi herkkyystunnisteiden, DLP-käytäntöjen ja säilytyskäytäntöjen piiriin – automaattisesti, ilman ylimääräistä koodia.
Microsoft Defender Agentin käyttäytymistä seurataan jatkuvasti poikkeamien ja uhkien varalta. Epäilyttävä toiminta laukaisee samat hälytykset ja vastausprosessit kuin kenellä tahansa käyttäjällä vuokraajassa.

Nämä edut koskevat kaikkia blueprint-pohjaisia agentteja, mukaan lukien sekä agentit, joilla on käyttäjädelegoidulla käyttöoikeudella että agentit, jotka toimivat omalla identiteetillä, heti blueprintin luomisen jälkeen. Sinun ei tarvitse määrittää niitä erikseen.

Alla olevat neljä ominaisuustasoa edustavat tasoja, jotka voit ottaa käyttöön asteittain. Seuraava taulukko näyttää, mitä Agent 365:lle on saatavilla lähtöpisteesi perusteella:

Ominaisuus Microsoft 365 räätälöity moottoriagentti Kaikki muut agentit 1
Rekisteri ✓ 2 ✓
Näkyvyys ✓ ✓
Work IQ ✓ ✓
AI-tiimiavustaja ✓ 3 ✓ 3

1 Agentit, jotka ovat tällä hetkellä rekisteröityneet Microsoft Entra -sovelluksiksi, täytyy ensin luoda agentin identiteettisuunnitelma aloittaakseen tämän sarakkeen ominaisuuksien hyödyntämisen.

2 Microsoft 365 -räätälöidyt moottoriagentit on jo rekisteröity olemassa olevan Microsoft Entra -sovellusrekisteröinnin kautta — lisäasetuksia ei vaadita.

3 AI-tiimikaveri Microsoft 365 custom engine -agenteille vaatii agentin identiteetin blueprintin. Saatavilla vain Frontier-ohjelman osallistujille.

Rekisteri

Kun rekisteröit agenttisi, teet sen näkyväksi ja hallittavaksi Microsoft 365 -hallintakeskuksessa. Ylläpitäjät voivat löytää sen ja nähdä sen organisaationsa agenttiluettelossa.

Mitä saat:

  • Agenttisi näkyy Microsoft 365 -hallintakeskuksessa; ylläpitäjät voivat löytää sen ja nähdä sen organisaationsa agenttiluettelossa.
  • Blueprint-pohjaiset agentit saavat myös kaikki Entra ID -tunnus -hallintohyödyt, Purview- ja Defender-edut, jotka on kuvattu osiossa Miksi rakentaa agentin identiteettisuunnitelmaan?

Mitä rakennat:

Rekisteröi agenttisi käyttämällä olemassa olevaa Microsoft Entra -sovellusrekisteröintiäsi tai mallipohjaa.

Muistiinpano

Jos rakennat agenttisi Google Vertex AI:n tai Amazon Bedrockin päälle, rekisteröityminen ei vaadi kehitystyötä. Googlen ja Amazonin API:t noutavat automaattisesti agentit. SDK-integrointia, suunnitelma ja koodin muutoksia ei tarvita. Rekisteröinnin jälkeen voit käyttää Agent 365 SDK:ta lisätäksesi havaittavuutta, pääsyn Work IQ -työkaluihin ja muita ominaisuuksia asteittain. Aloita tutustumalla Google Vertex AI- ja Amazon Bedrock -agenttien rekisteröintiin.

Näin rakennat:

Käytä tekoälyohjattua käyttöönottoa ja vastaa agenttityyppiin liittyviin kysymyksiin ohjeiden mukaisesti. Tekoälyohjattu käyttöönotto toteuttaa vaaditut toimenpiteet tälle tasolle. Microsoft 365:n mukautetut moottoriagentit ovat jo tunnistettavissa olemassa olevalla Microsoft Entra -sovelluksen rekisteröinnillä.

Näkyvyys

Kun olet rekisteröinyt agenttisi, panosta havainnointiin. Tämä investointi antaa IT-ylläpidolle, tietoturvatiimeille ja tekniselle tiimille näkyvyyden agentin todelliseen toimintaan. Kaikki inferenssikutsut, työkalukutsut ja vuorovaikutukset kirjataan, jäljitetään ja ovat auditointikelpoisia.

Havainnointi on luottamuksen perusta. Ilman sitä ylläpitäjillä ei ole keinoa tarkistaa käyttäytymistä, auditoida vaatimustenmukaisuutta tai diagnosoida ongelmia laajassa mittakaavassa. Sen avulla agenttisi muuttuu yrityksen resurssiksi eikä enää ole musta laatikko.

Muistiinpano

Jos agenttisi on superagentti – eli se kutsuu sisäisesti yhtä tai useampaa aliagenttia tehtävän suorittamiseksi – nämä aliagenttikutsut voidaan myös tallentaa havaittavuusjärjestelmään. Kirjaa ne työkalukutsuna tai agentti-agentti (A2A) -kutsuna, kuten mahdollista, jotta koko delegointiketju on näkyvissä ja auditoitavissa.

Mitä saat:

  • Kattava [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) -perustuva jäljitys jokaisesta agentin interaktiosta: syötteet, tulosteet, työkalukutsut ja mallikutsut.
  • Toiminta näkyy Microsoft 365 -hallintakeskuksessa ja integroiduissa valvontanäkymissä
  • Tarkastusjäljet siirtyvät Microsoft Entraan, Microsoft Purviewiin ja Microsoft Defenderiin, tukien vaatimustenmukaisuutta, tietosuojaa ja uhkien torjuntaa.

Mitä rakennat:

Instrumentointi Agent 365 SDK:n havaittavuus-APIen avulla: joko automaattinen instrumentointi (jos käytät OpenAI:ta, LangChainia tai Agent Frameworkia) tai manuaalinen instrumentointi muihin järjestelmiin.

Muistiinpano

Useimmissa uusissa integraatioissa käytä Microsoft OpenTelemetry Distroa — tekoälyohjattu asennus voi määrittää havaittavuuden puolestasi automaattisesti.

Jos käytössäsi on jo OpenTelemetry-putki, jos agenttikehys ei tue Agent 365 SDK:ta tai jos agentti on rakennettu kielellä, jota SDK ei vielä tue (esimerkiksi Java), voit lähettää telemetriatiedot suoraan Agent 365:een raaka OTLP/HTTP:n kautta ilman SDK:ta. Katso Integroi Agent 365:n havainnointikyky suoraan OTel-rajapintaan.

Näin rakennat:

Käytä tekoälyohjattua asetusta ja vastaa havaittavuuskysymyksiin asianmukaisesti. Tekoälyohjattu käyttöönotto toteuttaa vaaditut toimenpiteet tälle ominaisuudelle. Tämä käyttää Microsoftin OpenTelemetry-jakelua agentin instrumentointiin.

Work IQ

Kun olet rekisteröinyt agentin ja tehnyt siitä havaittavan, anna sille pääsy Microsoft 365 -tietoihin ja toimintoihin Work IQ:n kautta. Work IQ on hallittu työkalujoukko, jonka avulla agenttisi voi käyttää Sähköpostia, Kalenteria, OneDrivea, SharePointia, Teamsia ja muita palveluita.

Work IQ -työkalut edellyttävät ylläpitäjän suostumusta, ne ovat auditoituja ja peruutettavissa. Agenttisi hyödyntää blueprintissa määriteltyjä oikeuksia – ilman ylimääräisiä OAuth-virtoja tai mukautettuja liittimiä.

Mitä saat:

  • Pääsy koko Work IQ -työkaluluetteloon – Mail, Kalenteri, OneDrive, SharePoint, Teams ja paljon muuta.
  • Oikeudet, jotka ylläpitäjät hallitsevat ja määrittelevät tarkasti agenttisi tarpeiden mukaan.
  • Jokainen työkalukutsu jäljitetään ja on auditoitavissa havaittavuusputken kautta.

Mitä rakennat:

Agenttikoodi, joka kutsuu Work IQ -työkaluja käyttämällä Agent 365 SDK -työkalurajapintoja.

Näin rakennat:

Käytä Agent 365 SDK -työkalurajapintoja lisätäksesi Work IQ -työkalukutsut agenttikoodiisi manuaalisesti. Tekoälyohjattu käyttöönotto ei tällä hetkellä tue tätä ominaisuutta.

Tekoälytiimikaveri

Tekoälytiimikaverit ovat saatavana Uranuurtajayritysohjelman osallistujille.

Viimeinen vaihe mahdollistaa agenttisi toimimisen Microsoft 365:ssä omalla identiteetillä. Kokoonpanosta riippuen sillä voi olla postilaatikko, Teams-läsnäolo, hakemistomerkintä ja esimiessuhde. Ihmiset voivat olla vuorovaikutuksessa agentin kanssa tuttujen Microsoft 365 -kokemusten, kuten sähköpostin, chatin, kokousten ja sovellusten kautta.

Muistiinpano

Identiteetti- ja käyttöoikeusmallin muutos

Siirtyminen AI-tiimikaveriin merkitsee perustavanlaatuista muutosta siinä, miten agenttisi käyttää resursseja. Nykyinen agentti saattaa käyttää edustajakäyttäjän käyttöoikeutta, jolloin agentti toimii kirjautuneen käyttäjän puolesta ja voi käyttää vain niitä resursseja, joihin kyseisellä käyttäjällä on pääsy, tai sovellusoikeuksia, jotka on rajattu palvelutunnukseen. Agentti, jolla on käyttäjäidentiteetti, ei peri kutsuvan käyttäjän käyttöoikeuksia ajonaikana. Sen sijaan se toimii omalla käyttäjäidentiteetillään, omilla käyttöoikeusmyönnytyksillään, hallintopolitiikoillaan ja auditointijäljellään.

Tämä muutos tarkoittaa:

  • Käyttäjän delegoidussa pääsyssä agentti toimii kirjautuneen käyttäjän puolesta ja agentin pääsy on rajoitettu kyseisen käyttäjän oikeuksiin. Agentin omalla identiteetillä voit myöntää pääsyn Microsoft 365 -resursseihin, kuten postilaatikkoon, kalenteriin, Teamsiin ja SharePointiin, suoraan agentin identiteetille.
  • Hallinnoit ja tarkastat agentille myönnetyt käyttöoikeudet agentin omina käyttöoikeuksina. Ne eivät ole sama asia kuin käyttäjän delegoimat oikeudet, jotka siirtyvät kutsuvalta käyttäjältä.
  • Jos nykyinen toteutuksesi perustuu edustajakäyttäjäkäyttöoikeuksiin tai sovellusoikeuksiin, tarkista ja määrittele uudelleen nämä oikeudet agentin identiteetille ennen tämän ominaisuuden käyttöönottoa.

Mitä saat:

  • Sisältää kaiken Discoverability-, Observability- ja Work IQ -ominaisuuksista.
  • Agentti-käyttäjätili, jolla on oma postilaatikko – ihmiset voivat lähettää sille sähköpostia suoraan ja se voi lähettää sähköpostia omasta osoitteestaan.
  • Läsnäolo Microsoft 365 -sovelluksissa – ihmiset voivat keskustella sen kanssa, @mention lisätä sen kanaviin ja kutsua kokouksiin Teamsissa; sekä olla vuorovaikutuksessa sen kanssa suoraan Wordissa, Excelissä, PowerPointissa ja muilla M365-pinnoilla.
  • Agentti näkyy organisaatiokaaviossa nimetyn johtajan alaisuudessa ja organisaation hakemistossa.
  • Ylläpitäjän hallitsema elinkaari – agentti luodaan, hallinnoidaan ja poistetaan käytöstä Microsoft 365 -hallintakeskuksen kautta, ja ylläpitäjällä on täysi hallinta jokaiseen instanssiin.

Mitä rakennat:

Kaikki ominaisuudet, sekä instanssien luonti ja (valinnaisesti) Marketplace-julkaisu.

Näin rakennat:

Käytä tekoälyohjattua kokoonpanoa ja vastaa AI-tiimikaverin kysymyksiin sen mukaisesti. Tekoälyohjattu käyttöönotto toteuttaa vaaditut toimenpiteet tälle tasolle.

AI-ohjattu määritys

Hyödynnä tekoälypohjaista koodausagenttia Agent 365 -agenttisi käyttöönoton ja konfiguroinnin automatisointiin. Tekoälyohjattu kokoonpano johdattaa sinut vaadittavien tarkistusten, konfigurointivaiheiden ja koodin integraation läpi, jotta ominaisuudet kuten rekisteröinti, observointi, Work IQ -työkalun käyttö ja AI-tiimikaverin toiminnallisuus voidaan ottaa käyttöön.

Tekoälyohjatun kokoonpanon edellytykset

Varmista ennen aloittamista, että käytettävissä ovat seuraavat kohteet:

Vaatimus Tiedot
AI-koodausagentti Visual Studio Code -editori GitHub Copilot- ja GitHub Copilot Chat -laajennuksilla, tai muu tekoälypohjainen koodausagentti, jolla on pääsy terminaaliin
Agenttikoodi Toimiva agenttiprojekti Pythonissa, Node.js:ssa tai .NET:ssä. Jos sinulla ei ole sellaista, aloita pika-aloitusmallilla.
Entra-rooli Yleinen järjestelmänvalvoja – suorittaa kaikki vaiheet, mukaan lukien OAuth2-käyttöoikeuksien myöntäminen. Agent ID Developer – suorittaa kaikki vaiheet paitsi OAuth2-käyttöoikeuksien myöntämisen; asetus luo siirtymän Global Administratorille.

Tekoälyohjatut asennusvaiheet

Nämä vaiheet pätevät riippumatta siitä, ovatko yksi agentti käyttöön vai agenttitehdas. Tekoälyagentti tarkistaa tarvittavat työkalut ja hoitaa asennuksen, todennuksen sekä validoinnin automaattisesti.

Avaa agenttiprojektisi ja kopioi tämä kehote valitsemaasi tekoälyagenttiin. Jos käytät GitHub Copilotia, vaihda ensin agenttitilaan – Kysy- ja muokkaustiloissa ei ole pääsyä terminaaliin.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

Tekoälyagentti aloittaa esittämällä sinulle kolme kysymystä selvittääkseen, mitkä ominaisuudet koskevat agenttiasi.

Kysymys 1: Onko agenttisi jo käytettävissä Teamsissa tai Copilotissa?

  • Kyllä
  • Ei

Kysymys 2: Miten agenttisi tunnistautuu kutsuessaan alavirran rajapintoja?

  • On-behalf-of (OBO) — agentti toimii kirjautuneena käyttäjänä (delegoidut käyttöoikeudet)
  • Service-to-service (S2S) — agentti toimii omana identiteettinään (sovelluksen käyttöoikeudet)
  • Molemmat (OBO ja S2S)

Kysymys 3: Mitä Agent 365 -ominaisuuksia haluat ottaa käyttöön?

Kokoonpano sisältää automaattisesti kaikki valintasi edellyttämät ominaisuudet.

Tekoälyagentti käy sitten automaattisesti läpi soveltuvat tasot, pysähtyen vain pyytämään tarvittavaa syötettä sinulta:

Ominaisuus Mitä tekoälyagentti tekee 1
Rekisteri Tarkistaa .NET:n ja Agent 365 CLI:n (asentaa tai päivittää tarvittaessa), asentaa Azure CLI:n, jos puuttuu, suorittaa az login jos ei ole kirjautunut sisään, validoi mukautetun asiakassovelluksen rekisteröinnin, kerää agentin nimen ja managerin sähköpostiosoitteen, konfiguroi agentin Teams Developer Portalissa, ja rekisteröi agentin blueprintin
Havaittavuus Lisää Agent 365 SDK:n observability-instrumentoinnin agenttikoodiisi
Tekoälytiimikaveri Suorittaa a365 publish ja vie sinut läpi käyttöönoton jälkeiset vaiheet, mukaan lukien agentti-instanssin luomisen

1 Vaiheet riippuvat agentin tyypistä ja vaiheista, jotka valitsit asennuksen alussa.

Tärkeää

Observability-toiminnossa, tekoälyagentti kirjoittaa koodia suoraan projektiisi. Tekoälykoodaajat voivat tehdä virheitä. Tarkista muutokset aina ennen tuotantoon käyttöönottoa.

Tarvittavat tiedot täytettäväksi

Tekoälyagentti pysähtyy keräämään konfiguraatiotietoja asennuksen aikana:

Kehote Mitä tarjota
Agentin nimi, esimiehen sähköpostiosoite Agentin perusmetatiedot
Johdetun arvon vahvistus Tarkista automaattisesti luodut nimet agentin identiteetille, blueprintille ja käyttäjäperiaatteen osalta
Manifestin tarkistaminen Varmista, että manifestisi manifest.json sisältää agentin nimen, kuvauksen ja kehittäjätiedot

Kirjaa käyttöönotto-ohjeet

Kun automaattiset tasot on suoritettu, tekoälyagentti pysähtyy kahteen vaiheeseen, jotka edellyttävät selaimen käyttöä.

  1. Luo agentin esiintymä

    (Vain AI-tiimikaverille) — Siirry Microsoft Teamsissa kohtaan Sovellukset, etsi agenttisi ja valitse Lisää. Jos hyväksyntä ylläpitäjältä vaaditaan, Microsoft 365 -ylläpitäjäsi saa pyynnön. Kun hyväksyntä on saatu, agenttisi näkyy organisaatiokaaviossasi. Lisätietoja löytyy kohdasta Luo agenttiesiintymiä. Uuden agentin ilmestyminen Teams-hakuun voi kestää muutaman minuutin.

  2. Agentin testaaminen

    Lähetä viesti agentillesi Teamsissa varmistaaksesi, että se toimii.

Valmis — agenttisi on otettu käyttöön, julkaistu ja toiminnassa. Katso Luo agentti-instansseja jos tarvitset lisää instansseja.

Jos jokin ei toiminut, tekoälyagentti tarjoaa kohdennettua vianmääritystä. Voit myös tutustua Agent 365 -vianmääritysoppaaseen.

Manuaalinen polkuviite

Käytä tätä viitettä vain, jos selvität vaihetta, rakennat CI/CD-automaatiota tai työskentelet ilman tekoälykoodausagenttia.

Vaihe Toiminnot Opas
Asennusasetukset Luo a365.config.json vuokralaisen, tilauksen ja projektin tiedoilla. Jos käytössäsi on jo käyttöönotettu ympäristö, määritä viestipäätepiste tässä. Määritä Agent 365 -konfiguraatio
Blueprintin määritys Rekisteröi agentti-identiteettisi Entraan, ja luo Azure-resurssit (resource group, App Service Plan, Web App) Agentin suunnitelman määrittäminen
Käyttöönotto Ottaa agenttikoodisi käyttöön Azure-sovelluspalvelussa. Valinnainen, jos agenttikoodi on jo isännöity muualla. Azure · AWS · GCP
Julkaiseminen Luo manifest.zip ja lataa Microsoft 365 -hallintokeskukseen Julkaise agentti

CLI-asennusta, komentoja ja vianetsintää varten tarkemmat ohjeet löydät Agent 365 CLI.

Julkaise agenttisi Microsoft Marketplacessa

Kun olet täysin kehittänyt ja testannut agenttisi omassa vuokralaisessa tai vuokralaisissa, julkaise se Microsoft Marketplace -palvelussa.

Tätä varten tarvitset Microsoft AI Cloud Partner Program -tilin Kumppanikeskuksessa. Jos sinulla ei ole sellaista, luo tili saadaksesi PartnerID:n. Seuraavaksi rekisteröidy Microsoft 365- ja Copilot-ohjelmaan, joka antaa sinulle pääsyn agenttitarjousten julkaisemiseen tarvittaviin resursseihin ja tukeen. Kun olet liittynyt ohjelmaan, tarkista lähettämisen tarkistuslista ja validointiohjeet, ja lähetä agenttisi Kumppanikeskuksen vaiheittaisen lähettämisen oppaan avulla.

Lue, miten voit lähettää agenttisi Microsoft Marketplaceen Kumppanikeskuksen kautta.

Kun olet valmis, agenttisi julkaistaan Microsoft Marketplaceen ja on asiakkaiden löydettäväksi ja käyttöönotettavaksi.

Tekoälyohjatun käyttöönoton vianmääritys

Jos kohtaat ongelmia tekoälyohjatun asennuksen aikana, tutustu seuraaviin yleisiin ongelmiin ja niiden ratkaisuihin.

Ongelma Description
tekoälyagentti ei suorita terminaalikomentoja Tekoälyagentti selostaa komentoja, mutta ei suorita niitä
Tekoälyagentti ohittaa vaiheet Asennus näyttää ohittavan vaaditut vaiheet
CLI-komennot epäonnistuvat käyttöoikeusvirheiden vuoksi Valtuutusvirheitä kun suoritetaan a365 CLI-komentoja
Konfiguraatioarvot ovat vääriä Konfiguraatiota täytyy muuttaa a365.config.json-tiedoston luomisen jälkeen

Tekoälyagentti ei suorita terminaalikomentoja

Jos tekoälyagentti kuvailee komentoja mutta ei suorita niitä, varmista, että käytät Agentti-tilaa GitHubin Copilot Chatissa. Kysy- ja muokkaustiloilla ei ole pääsyä terminaaliin.

Tekoälyagentti ohittaa vaiheet

Ohjetiedosto vaatii tiukan vaihejärjestyksen. Jos tekoälyagentti näyttää ohittavan jonkin vaiheen, pyydä sitä aloittamaan alusta:

Please start from Step 1 in the setup instructions and work through each step in order.

CLI-komennot epäonnistuvat käyttöoikeusvirheiden vuoksi

Jos a365 CLI-komennot epäonnistuvat valtuutusvirheiden vuoksi, yleisin syy on puuttuva tai epätäydellinen mukautetun asiakassovelluksen rekisteröinti. Tekoälyagentti vahvistaa rekisteröinnin asennuksen aikana, mutta jos validointi on ohitettu, katso Mukautettu asiakassovelluksen rekisteröinti.

Yleistä vianmääritystä varten katso Agent 365:n vianmääritysopas.

Konfiguraatioarvot ovat vääriä

Jos sinun täytyy muuttaa konfiguraatioarvoja luomisen a365.config.jsonjälkeen, joko:

  • Muokkaa tiedostoa suoraan ja suorita uudelleen a365 config init -c ./a365.config.json
  • Pyydä tekoälyagenttia päivittämään tietyt arvot
  • Last updated on