Připojení k agentu Microsoft Foundry (Preview)

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Agenta Microsoft Foundry můžete připojit k vašemu vlastnímu agentu, což mu umožní volat tohoto agenta, aby reagoval na uživatele nebo trigger.

Důležité

Tento článek obsahuje dokumentaci Microsoft Copilot Studio Preview a může se změnit.

Funkce náhledu nejsou určeny pro produkční použití a mohou mít omezenou funkčnost. Jsou to funkce, které jsou poskytnuté před oficiálním vydáním, abyste si je mohli co nejdříve vyzkoušet a napsat nám své názory.

Pokud vytváříte agenta připraveného pro produkční prostředí, přečtěte si Přehled Microsoft Copilot Studio.

Předpoklady

Než připojíte agenta Microsoft Foundry ke Copilot Studio, musí mít agent Foundry zapnutý endpoint protokolu Activity. Nově vytvořený Foundry agent ve výchozím nastavení zpřístupňuje pouze koncové body protokolu Responses a A2A . Pokud není povolen endpoint Aktivity, připojení k Copilot Studio selže za běhu s chybou 400. Další informace najdete v tématu Zapnutí příchozích A2A u agenta Foundry.

Momentálně můžete Activity endpoint povolit pouze programovaně, pomocí REST API nebo Python SDK. Není možnost to povolit v portálu Microsoft Foundry. Více o postupu zpřístupnění se dozvíte v Configure and share your agent.

Po zapnutí koncového bodu Aktivita sekce Koncové body na portálu Foundry pro agenta nadále zobrazuje pouze Odpovědi a A2A. Tato absence uživatelského rozhraní je očekávaná a neznamená, že změna selhala. Připojení ke Copilot Studio funguje po aplikaci aktualizace.

Spojte se s agentem Microsoft Foundry

1. Přejděte na stránku Agenti pro hlavního agenta a vyberte Přidat agenta.

2. V části Připojit k externímu agentu vyberte Microsoft Foundry z dostupných typů agentů.

3. V seznamu dostupných připojení vyberte požadované připojení nebo vytvořte nové připojení mezi Microsoft Foundry a vaším agentem Copilot Studio. Pokud chcete vytvořit nové připojení, musíte zadat adresu URL koncového bodu projektu Foundry.

   Note

   Při připojování k agentům Microsoft Foundry z Copilot Studia se můžete připojit jenom k agentům vytvořeným na novém portálu Microsoft Foundry. Připojení k agentovi vytvořenému v předchozí verzi portálu způsobí chybu s oznámením 404 - Version not found.

4. Po vytvoření připojení vyberte Další.

5. Zadejte odpovídající název a popis agenta sady SDK. Popis by měl popisovat účel vašeho agenta Microsoft Foundry, který umožňuje hlavnímu agentu pochopit, kdy se má použít. Další informace najdete v článku o psaní efektivních metadat.

6. Zadejte ID agenta Microsoft Foundry, ke kterému se chcete připojit.

7. Upravte popis (v případě potřeby), aby byl pro hlavního agenta více kontextový. Pokud máte například jiné nástroje nebo agenty, u kterých se popisy mohou překrývat, napište konkrétnější popis. Aktualizujte popis, aby Copilot Studio vědělo, kdy má tohoto agenta vyvolat.

8. Vyberte Přidat agenta.

9. Po vytvoření agenta můžete agenta okamžitě otestovat. Pokud budete později potřebovat upravit ID agenta, můžete to udělat na stránce údajů tak, že vyberete svého agenta ze seznamu Agenti.

Note

• Pokud vaše první testovací volání připojenému agentovi Foundry selže s chybou podobnou "Konektor 'Azure AI Foundry Agent Service' vrátil chybu HTTP s kódem 400. Vnitřní chyba: Endpoint agenta <name> nepodporuje aktivitu. Prosím, aktualizujte endpoint agenta, aby podporoval tento protokol.", Foundry agent nemá zapnutý endpoint protokolu Activity . Podívejte se na Požadavky v tomto článku, poté povolte endpoint Activity kliknutím na Konfigurace a sdílejte svého agenta v dokumentaci Microsoft Foundry.

• Jste zodpovědní za pečlivé přezkoumání a testování propojených agentů v kontextu vašich konkrétních případů použití a za přijímání všech vhodných rozhodnutí a úprav. Pokud se připojíte k agentům mimo Copilot Studio, nesete odpovědnost za používání těchto agentů. Mezi úvahy patří zajištění:

  • Datové toky, zpracování dat a sdílení dat mezi agenty jsou vhodné pro váš případ použití a splňují příslušné požadavky a zákony.
  • Agenti splňují odpovídající standardy kvality, spolehlivosti, bezpečnosti a důvěryhodnosti.
  • Vhodná oprávnění, hranice a schválení jsou nastavena, pokud je to rozumné pro váš případ použití.
  • Správná pozorovatelnost, identita a sledovatelnost a funkce lidského dohledu jsou zavedeny.