Yhteyden muodostaminen Microsoft Foundry -agenttiin (esiversio)

Huomautus

Tässä artikkelissa kuvataan ominaisuuksia, joita käytetään agenteissa tai agenttivirroissa, joita käytetään standardivaljastuksen voimalla.

[Tämä artikkeli on esijulkaisuasiakirja, ja se voi muuttua.]

Microsoft Foundry -agentti voidaan yhdistää mukautettuun agenttiin, jolloin se voi kutsua tämän agentin vastaamaan käyttäjälle tai reagoimaan käynnistimeen.

Important

Tämä artikkeli sisältää Microsoft Copilot Studion esiversiota koskevia ohjeita. Tiedot voivat muuttua.

Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta voit käyttää niitä aikaisessa vaiheessa ja antaa palautetta.

Jos olet luomassa tuotantovalmista agenttia, katso lisätietoja kohdasta Microsoft Copilot Studion yleiskuvaus.

edellytykset

Ennen kuin yhdistät Microsoft Foundryn agentin Copilot Studio'hun, Foundry-agentilla täytyy olla Activity-protokollan päätepiste käytössä. Uusi Foundry-agentti paljastaa oletuksena vain Responses - ja A2A-protokollan päätepisteet. Jos Activity-päätepiste ei ole käytössä, yhteys Copilot Studio:hun epäonnistuu ajonaikaisesti 400-virheellä. Lue lisää artikkelista Ota käyttöön saapuva A2A Foundry-agentissa.

Voit tällä hetkellä ottaa Activity-päätepisteen käyttöön vain ohjelmallisesti käyttämällä REST API:ta tai Python SDK:ta. Microsoft Foundryn portaalista ei ole vaihtoehtoa ottaa sitä käyttöön. Lue lisää käyttöönottoprosessista kohdasta Määritä ja jaa agenttisi.

Kun otat Activity -päätepisteen käyttöön, Foundry-portaalin Endpoints-osio agentille näyttää edelleen vain Vastaukset ja A2A. Tämä käyttöliittymän puute on odotettavissa eikä tarkoita, että muutos olisi epäonnistunut. Yhteys Copilot Studio toimii päivityksen jälkeen.

Yhteyden muodostaminen Microsoft Foundry -agenttiin

1. Siirry pääagentin Agentit-sivulle ja valitse Lisää agentti.

2. Valitse Yhdistä ulkoiseen agenttiin -kohdassa agentin tyypiksi Microsoft Foundry.

3. Valitse haluamasi yhteys käytettävissä olevien yhteyksien luettelosta tai luo uusi yhteys Microsoft Foundryn ja Copilot Studio -agentin välille. Uuden yhteyden luonti edellyttää Foundry-projektin päätepisteen URL-osoitteen ilmoittamista.

   Huomautus

   Kun muodostat yhteyden Microsoft Foundry -agentteihin Copilot Studiosta, voit muodostaa yhteyden vain uudessa Microsoft Foundry -portaalissa luotuihin agentteihin. Yhdistäminen edellisessä portaalissa luotuun agenttiin johtaa virheeseen, joka osoittaa 404 - Version not found.

4. Kun yhteys on luotu, valitse Seuraava.

5. Anna SDK-agentille sopiva nimi ja kuvaus . Kuvauksen on kuvailtava Microsoft Foundry -agentin tarkoitusta, jolloin pääagentti ymmärtää, milloin sitä kannattaa käyttää. Lisätietoja on kohdassa Tehokkaiden metatietojen kirjoittaminen.

6. Syötä sen Microsoft Foundry -agentin tunnus, johon yhteys halutaan muodostaa.

7. Muokkaa kuvausta (tarvittaessa) siten, että pääagentti hahmottaa sen kontekstin paremmin. Tarkenna kuvaus esimerkiksi silloin, jos käytössä on muita työkaluja tai agentteja, joiden kuvaukset saattavat olla päällekkäisiä. Päivitä kuvaus varmistaaksesi, että Copilot Studio ymmärtää, milloin tämä agentti tulee ottaa käyttöön.

8. Valitse Lisää agentti.

9. Kun agentti on luotu, sitä voidaan testata heti. Jos agentin tunnusta on muutettava myöhemmin, se voidaan tehdä tietosivulla valitsemalla agentti Agentit-luettelosta.

Huomautus

• Jos ensimmäinen testikutsusi yhdistetylle Foundry-agentille epäonnistuu virheellä, joka muistuttaa "Liitin 'Azure AI Foundry Agent Service' palautti HTTP-virheen koodilla 400. Sisäinen virhe: Agentin <name> päätepiste ei tue toimintaa. Päivitä agentin päätepiste tukemaan tätä protokollaa.", Foundry-agentilla ei ole Activity-protokollan päätepistettä käytössä. Katso tämän artikkelin Ennakkovaatimukset ja ota Activity-päätepiste käyttöön seuraamalla Microsoft Foundryn dokumentaatiossa Määritä ja jaa agenttisi.

• Sinun vastuullasi on tarkastella ja testata yhdistetyt agentit huolellisesti omien käyttötapaustesi kontekstissa sekä tehdä kaikki tarvittavat päätökset ja mukautukset. Kun muodostat yhteyden Copilot Studion ulkopuolisiin agentteihin, olet vastuussa tällaisten agenttien käytöstä. Huomioitaviin asioihin kuuluu varmistaa:

  • Datavirrat, datan käsittely ja tiedon jakaminen agenttien välillä sopivat käyttötapaukseesi ja täyttävät asiaankuuluvat vaatimukset ja lait.
  • Välittäjät täyttävät asianmukaiset laatu-, luotettavuus-, turvallisuus- ja luotettavuusvaatimukset.
  • Sopivat luvat, rajat ja hyväksynnät annetaan, jos ne sopivat käyttötapaukseesi.
  • Asianmukainen havaittavuus, identiteetti ja jäljitettävyys sekä ihmisen valvontatoiminnot ovat käytössä.