Začínáme s vývojem v Agent 365

Agent 365 podporuje různé implementace agentů. Agent může uživatelům asistovat na vyžádání, běžet autonomně na pozadí nebo operovat s vlastní uživatelskou identitou v Microsoft 365. Je důležité pochopit, který typ nejlépe vystihuje vašeho agenta, protože to určuje jeho model identity, jaký má přístup ke zdrojům Microsoft 365 a které kroky životního cyklu se na něj vztahují.

Typy agentů

Než začnete, položte si otázku: Jaký typ agenta vytvářím?

Existují dva typy agentů podle typu přístupu, který mají.

Typ agenta Přehled
Agenti Mohou pracovat jménem uživatele s delegovaným přístupem nebo fungovat jako aplikace s omezenými oprávněními. Jsou registrovány jako aplikace Microsoft Entra nebo plány identit agentů.
AI spoluhráč Operují s vlastní uživatelskou identitou v Microsoft 365, včetně poštovní schránky, přítomnosti v Teams a záznamu v adresáři. Tento typ agenta je dostupný pouze pro klienty, kteří se účastní programu Frontier v režimu Preview.

Agenti

Agent pracuje jménem uživatele. Reaguje na požadavky, spouští úkoly na pozadí, připojuje se k API, zpracovává data a provádí akce.

Agenti jsou všech podob. Některé jsou konverzační – uživatel se zeptá na něco a agent odpoví. Některé běží tiše na pozadí – spuštěné harmonogramem, událostí nebo příchozí zprávou – aniž by se někdo aktivně zapojil. Někteří dělají obojí.

Ukázkové scénáře:

  • Uživatel požádá agenta, aby shrnul jeho nepřečtené e-maily a připravil pracovní odpovědi. Agent vykoná práci, přistupuje pouze ke zdrojům, ke kterým má uživatel přístup, a výsledek vrátí zpět.
  • Agent zákaznické podpory pomáhá technikovi podpory vyhledávat v interních znalostních bázích a sestavovat odpovědi během živé relace podpory.
  • Agent pro kontrolu dodržování předpisů běží každou noc, skenuje weby SharePoint, ke kterým má udělený přístup, z hlediska porušení zásad a ukládá zprávy o auditu,a to zcela autonomně, bez nutnosti lidského dohledu.
  • Agent zpracovávající objednávky vyzvedne nové prodejní objednávky z fronty, aktualizuje CRM a posílá potvrzovací e-maily – a to vše bez toho, aby to někdo začal.

Základ identity:

Tradičně registrujete agenty jako aplikace Microsoft Entra. Tento přístup stále funguje. V budoucnu budete moci agenty vytvářet také na základě ID agenta v Microsoft Entra prostřednictvím blueprintu identity agenta což je IT oddělením schválená a zásadami vynucená definice schopností agenta, jeho povoleného přístupu k nástrojům a omezení pro dodržování předpisů. Stavět na blueprintu je doporučená cesta pro nové agenty. Odemkne řízený přístup k nástrojům Work IQ, ochranu dat Microsoft Purview, monitorování hrozeb Microsoft Defender a správu Entra ID – čímž se váš agent stává plně řízenou podnikovou identitou od prvního dne. Pokud se uživatelé vašeho agenta přihlašují prostřednictvím poskytovatele identity třetí strany, podívejte se na Integrace Microsoft Entra ID agenta s poskytovateli identity třetích stran.

AI spoluhráč

Důležité

Abyste získali předčasný přístup k tomuto typu agenta, musíte být součástí programu Frontier (Preview). Frontier vás přímo spojí s nejnovějšími inovacemi AI od Microsoftu. Verze Frontier Preview podléhají stávajícím podmínkám verze Preview ve vašich zákaznických smlouvách. Vzhledem k tomu, že tyto funkce jsou stále ve vývoji, jejich dostupnost a funkce se mohou v průběhu času měnit.

AI kolega operuje v Microsoft 365 s vlastní agentní identitou. Můžete jej vybavit funkcemi, jako je odesílání a přijímání e-mailů prostřednictvím vlastní schránky, účast na Teams v 1:1 a skupinových konverzacích a zobrazení v adresáři a organizačních metadatech s přiřazeným manažerem. Lidé s ním mohou komunikovat prostřednictvím známých rozhraní Microsoft 365, jako jsou @mentions, e-mail, pozvánky do kalendáře a chat v Teams.

Tyto agenty vytvářejte na základě blueprintu agenta, což je definice schválená IT a vynucovaná správou, která stanovuje schopnosti agenta, povolený přístup k nástrojům a požadavky na shodu. Každá instance agenta dědí model identity, oprávnění a politiky ze svého nadřazeného blueprintu identity agenta.

To, co agent dělá – zda je konverzační, běží na pozadí, nebo obojí – záleží na tom, jak ho navrhnete. Někteří agenti jsou velmi interaktivní, odpovídají na zprávy a podporují pracovní procesy v reálném čase. Jiné zpracovávají úkoly na pozadí, provádějí akce na základě e-mailů nebo událostí bez přímého zapojení uživatele. Agent pracuje se svou vlastní uživatelskou identitou a jeho akce jsou řízeny a auditovatelné prostřednictvím této identity.

Pokud už máte agenta, nemusíte začínat znovu. Můžete rozšířit stávající agenty tak, aby fungovali se svou vlastní identitou, přidáním konfigurace identity a blueprintu, která je popsána později v tomto průvodci.

Ukázkové scénáře:

  • Přidejte AI kolegu pro HR onboarding do onboardingového kanálu nového zaměstnance v Teams. Odesílá uvítací e-maily ze své vlastní schránky, plánuje orientační schůzky ve svém kalendáři a odpovídá na dotazy pomocí schopností nakonfigurovaných pro danou instanci agenta.
  • Přiřaďte manažerský vztah v adresářových metadatech AI kolegovi pro nákup. Zaměstnanci posílají žádosti o nákup e-mailem do své schránky. Agent zpracovává požadavek, provádí dotazy do ERP a finančních systémů s využitím řízeného přístupu k nástroji Work IQ a odpovídá schválením nebo eskalací ze své vlastní identity.
  • Přidejte výzkumného AI spolupracovníka na SharePoint stránku a kanál Teams projektového týmu. Může zobrazovat relevantní dokumenty během schůzek, reagovat v konverzačních vláknech a sestavovat týdenní zprávy o stavu pomocí oprávnění a nástrojů nastavených pro daného agenta.

Základ identity:

Postaveno na modelu identity agenta, který vytváří Microsoft Entra ID agenta a přidružený uživatelský účet: vždy vyžadováno.

Postupné přidávání schopností Agent 365

Agent 365 nemusíte nasazovat najednou – lze jej zavádět postupně. Nemusíte vytvořit AI spoluhráče hned první den – nebo vůbec, pokud to váš scénář nevyžaduje. Přijímejte schopnosti postupně, začínejte tím, co váš agent potřebuje nyní, a rozšiřujte podle toho, jak se vaše požadavky vyvíjejí.

Proč využívat návrh identity agenta?

Když vytvoříte blueprint identity agenta, rozhraní příkazového řádku Agent 365 poskytne Microsoft Entra ID agenta pro vašeho agenta – prvotřídní identitu ve vašem klientovi podléhající stejným zásadám podnikové správy jako lidským uživatelům. Tato jediná identita je základem bezpečnostních výhod, které automaticky získává každý agent vytvořený podle blueprintu identity:

Zaměstnanecká výhoda Co to znamená pro vašeho agenta
Microsoft Entra ID Governance Identita agenta a životní cyklus jeho přístupových práv jsou spravovány stejnými podmíněnými přístupy, ochranou identity a kontrolami přístupových práv, které platí pro běžné uživatele.
Microsoft Purview Každá interakce s daty, kterou agent provádí, automaticky podléhá štítkům citlivosti, DLP politikám a politikám uchovávání vašeho klientu – bez nutnosti dalšího kódu.
Microsoft Defender Chování agenta je nepřetržitě monitorováno pro detekci anomálií a hrozeb. Podezřelá aktivita vyvolá stejné výstrahy a reakční postupy jako u kteréhokoli uživatele v klientovi.

Tyto výhody se vztahují na všechny agenty podle blueprintu, včetně agentů s přístupem delegovaným uživatelem i agentů, kteří fungují s vlastní identitou, a to od okamžiku vytvoření blueprintu. Nemusíte je konfigurovat samostatně.

Čtyři úrovně schopností níže představují stupně, které můžete zavádět postupně. Následující tabulka ukazuje, co je pro Agent 365 dostupné na základě vašeho výchozího bodu:

Schopnost Agent s vlastním modulem pro Microsoft 365 Všichni další agenti 1
Zaregistrovat se 2
Pozorovatelnost
Work IQ
AI kolega 3 3

1 Agenti, kteří jsou aktuálně registrováni jako aplikace Microsoft Entra, musí nejprve vytvořit blueprint identity agenta, aby mohli začít s jakoukoli schopností v tomto sloupci.

2 Agenti s vlastním modulem pro Microsoft 365 jsou již registrováni prostřednictvím stávající registrace aplikace Microsoft Entra — další nastavení není potřeba.

3 AI kolega pro agenty s vlastním modulem pro Microsoft 365 vyžaduje blueprint identity agenta. Dostupné pouze účastníkům programu Frontier.

Pokladna

Když zaregistrujete svého agenta, stane se viditelným a spravovatelným v Centru pro správu Microsoft 365. Administrátoři jej mohou objevit a vidět v inventáři agentů své organizace.

Co získáte:

  • Váš agent se zobrazí v Centru pro správu Microsoft 365; administrátoři jej mohou najít a vidět v inventáři agentů své organizace.
  • Agenti založení na agent identity blueprintu také získávají kompletní výhody správy Entra ID, Purview a Defender, které jsou popsány v části Proč stavět na agent identity blueprintu?

Co vytvoříte:

Zaregistrujte svého agenta pomocí stávající registrace aplikace Microsoft Entra nebo blueprintu.

Poznámka

Pokud vytváříte své agenty na Google Vertex AI nebo Amazon Bedrock, registrace nevyžaduje žádnou vývojovou práci. API Google a Amazon automaticky načítají agenty. Není potřeba integrace SDK, podrobný plán ani změny kódu. Po registraci můžete pomocí Agent 365 SDK postupně přidávat observability, přístup k nástrojům Work IQ a další funkce. Pro začátek viz Registrace agentů Google Vertex AI a Amazon Bedrock.

Jak vytvořit agenta:

Použijte nastavení řízené umělou inteligencí a odpovídajícím způsobem odpovězte na otázky týkající se typu agenta. Nastavení s podporou AI provádí potřebné kroky pro tuto úroveň. Agenti s vlastním modulem pro Microsoft 365 jsou již dnes dostupní pomocí jejich stávající registrace aplikací Microsoft Entra.

Pozorovatelnost

Po registraci agenta investujte do pozorovatelnosti. Tato investice poskytuje IT, bezpečnostním týmům a vašemu inženýrskému týmu náhled na to, co váš agent skutečně dělá. Veškerá inferenční volání, vyvolání nástrojů a interakce jsou zachycena, sledována a auditovatelná.

Pozorovatelnost je základem důvěry. Bez něj nemají administrátoři možnost ověřovat chování, auditovat dodržování předpisů ani diagnostikovat problémy ve velkém měřítku. Díky tomu se váš agent stává podnikovým aktivem, nikoli černou skříňkou.

Poznámka

Pokud je váš agent super agent – což znamená, že interně volá jednoho nebo více sub-agentů k dokončení úkolu – tato volání sub-agentů lze také zaznamenat v pozorovací pipeline. Zaznamenávejte je jako volání nástroje nebo volání mezi agenty (A2A), podle potřeby, aby byl celý delegační řetězec viditelný a auditovatelný.

Co získáte:

  • Plné trasování každé interakce agenta na bázi protokolu [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) vstupů, výstupů, volání nástrojů a vyvolání modelů.
  • Aktivita je viditelná v centru pro správu Microsoft 365 a na připojených monitorovacích rozhraních.
  • Auditní stopy, které jsou předávány do Microsoft Entra, Microsoft Purview a Microsoft Defender, podporují požadavky na dodržování předpisů, ochranu dat a reakci na hrozby.

Co vytvoříte:

Instrumentování pomocí API pro pozorovatelnost Agent 365 SDK: buď automatickou instrumentaci (pokud používáte OpenAI, LangChain nebo Agent Framework), nebo manuální instrumentaci pro jiné technologie.

Poznámka

U většiny nových integrací použijte Microsoft OpenTelemetry DistroAI-vedené nastavení může pro vás automaticky nakonfigurovat pozorovatelnost.

Pokud již máte kanál OpenTelemetry, pokud váš Agent Framework není kompatibilní s Agent 365 SDK, nebo pokud je váš agent vytvořen v jazyce, který zatím není SDK podporován (například Java), můžete posílat telemetrii přímo do Agent 365 prostřednictvím surového OTLP/HTTP bez závislosti na SDK. Další informace naleznete v Integraci s pozorovatelností Agent 365 prostřednictvím přímého OTel.

Jak vytvořit agenta:

Použijte nastavení řízené umělou inteligencí a odpovídajícím způsobem odpovězte na otázky týkající se pozorovatelnosti. Nastavení s podporou AI provádí potřebné kroky pro tuto funkci. K instrumentaci vašeho agenta slouží distribuce Microsoft OpenTelemetry.

Work IQ

Po registraci a zpřehlednění agenta mu dejte přístup k datům a akcím Microsoft 365 přes Work IQ. Work IQ je spravovaná sada nástrojů, která umožňuje vašemu agentovi pracovat s Mailem, Kalendářem, OneDrive, SharePointem, Teams a dalšími.

Nástroje Work IQ vyžadují souhlas správce, jsou auditovatelné a lze je odebrat. Váš agent je volá s využitím oprávnění definovaných v jeho Blueprintu – nejsou potřeba žádné další OAuth toky ani vlastní konektory.

Co získáte:

  • Získáte přístup k plnému katalogu nástrojů Work IQ – Mail, Kalendář, OneDrive, SharePoint, Teams a další.
  • Oprávnění, která administrátoři řídí a nastavují přesně podle potřeb vašeho agenta.
  • Každé volání nástroje je sledováno a auditovatelné prostřednictvím kanálu pozorovatelnosti.

Co vytvoříte:

Kód agenta, který volá nástroje Work IQ prostřednictvím API nástrojů Agent 365 SDK.

Jak vytvořit agenta:

Použijte Nástrojová rozhraní API sady Agent 365 SDK k ručnímu přidání volání nástrojů Work IQ do kódu agenta. Nastavení řízené pomocí AI tuto funkci zatím nepodporuje.

AI kolega

AI kolegové jsou k dispozici účastníkům programu Frontier.

Závěrečná fáze umožňuje agentovi fungovat v rámci Microsoft 365 s vlastní identitou. V závislosti na konfiguraci může mít schránku, přítomnost v Teams, záznam v adresáři a vztah s manažerem. Lidé mohou s agentem komunikovat prostřednictvím známých prostředí Microsoft 365, jako jsou e-mail, chat, schůzky a různé aplikace.

Poznámka

Posun modelu identity a oprávnění

Přechod na AI kolegu představuje zásadní změnu ve způsobu, jakým váš agent přistupuje ke zdrojům. Váš stávající agent může používat delegovaný uživatelský přístup, kdy agent jedná za přihlášeného uživatele a má přístup pouze ke zdrojům, ke kterým má uživatel přístup, nebo aplikační oprávnění přiřazená k service principal. Agent s uživatelskou identitou nezdědí přístup volajícího uživatele při spuštění. Místo toho funguje pod vlastní uživatelskou identitou, s vlastními přístupovými granty, politikami řízení a auditní stopou.

Tato změna znamená:

  • Při delegovaném přístupu uživatele jedná agent jménem přihlášeného uživatele a je omezen na přístup tohoto uživatele. S vlastní identitou agenta udělujete přístup ke zdrojům Microsoft 365, jako jsou schránka, kalendář, Teams a SharePoint, přímo identitě agenta.
  • Oprávnění udělená identitě agenta spravujete a auditujete jako jeho samostatný přístup. Nejsou totožné s oprávněními delegovanými uživatelem, který volá.
  • Pokud vaše současná implementace spoléhá na přístup delegovaného uživatele nebo aplikační oprávnění, zkontrolujte a upravte tato oprávnění pro identitu agenta před povolením této funkce.

Co získáte:

  • Vše od objevitelnosti, přes pozorovatelnost až po Work IQ.
  • Uživatelská identita agenta s vlastní poštovní schránkou – lidé mu mohou přímo posílat e-maily a on může odesílat e-maily ze své vlastní adresy.
  • Přítomnost napříč aplikacemi Microsoft 365 – uživatelé s ním mohou chatovat, @mention ho, přidávat ho do kanálů a zvát ho na schůzky v Teams; a přímo s ním komunikovat ve Wordu, Excelu, PowerPointu a dalších prostředích M365.
  • Záznam v organizační struktuře pod určeným vedoucím – agent je uveden v adresáři organizace.
  • Životní cyklus řízený administrátorem – agent je vytvářen, spravován a vyřazován prostřednictvím Centra pro správu Microsoft 365, s plným dohledem nad každou instancí.

Co vytvoříte:

Všechny funkce, plus vytváření instancí a (volitelně) publikování v Marketplace.

Jak vytvořit agenta:

Použijte nastavení řízené umělou inteligencí a odpovídajícím způsobem odpovězte na otázky člena týmu AI. Nastavení s podporou AI provádí potřebné kroky pro tuto úroveň.

Nastavení asistované umělou inteligencí

Použijte AI programovacího agenta k automatizaci nastavení a konfigurace vašeho agenta pro Agent 365. Nastavení řízené AI vás provede kontrolou předpokladů, konfiguračními kroky a integrací kódu potřebnými k umožnění funkcí, jako je registrace, pozorovatelnost, přístup k nástrojům Work IQ a funkce AI týmových kolegů.

Předpoklady nastavení řízené AI

Než začnete, zkontrolujte, zda máte následující položky:

Požadavek Detaily
Agent kódování AI Visual Studio Code s rozšířeními GitHub Copilot a GitHub Copilot Chat nebo jiným agentem kódování AI s přístupem k terminálu
Kód agenta Funkční projekt agenta v Python, Node.js nebo .NET. Pokud žádný nemáte, začněte s ukázkou rychlého startu.
role v Microsoft Entra Globální administrátor – dokončuje všechny kroky včetně udělování oprávnění OAuth2. ID Agenta vývojáře – dokončuje všechny kroky kromě udělení oprávnění OAuth2; nastavení generuje předání pro globálního administrátora.

Kroky nastavení řízené AI

Tyto kroky platí bez ohledu na to, zda povolujete jednoho agenta nebo továrnu agentů. Agent AI ověří potřebné nástroje a automaticky zajistí instalaci, autentizaci a ověření.

Otevřete svůj projekt agenta a zkopírujte tuto výzvu do AI agenta dle svého výběru. Pokud používáte GitHub Copilot, nejdřív přepněte do režimu Agent – režimy Ask a Edit nemají přístup k terminálu.

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

AI agent začíná tím, že vám položí tři otázky, aby zjistil, které schopnosti se na vašeho agenta vztahují:

Otázka 1: Je váš agent už dostupný v Teams nebo Copilot?

  • Ano
  • Ne

Otázka 2: Jak bude váš agent ověřen při volání cílových API?

  • On-behalf-of (OBO) – agent jedná jménem přihlášeného uživatele (delegovaná oprávnění)
  • Service-to-service (S2S) – agent jedná pod vlastní identitou (aplikační oprávnění)
  • Obě (OBO i S2S)

Otázka 3: Jaké schopnosti Agent 365 chcete aktivovat?

Nastavení automaticky zahrnuje všechny předpoklady pro váš výběr.

Agent AI pak automaticky prochází příslušné úrovně schopností, zastavuje se pouze proto, aby požádal o vaši interakci.

Schopnost Činnosti AI agenta 1
Zaregistrovat se Kontroluje .NET a CLI Agent 365 (instaluje nebo aktualizuje, pokud chybí), instaluje Azure CLI, pokud chybí, spustí az login, pokud není autentizován, ověřuje registraci vaší vlastní klientské aplikace, získá jméno agenta a e-mail manažera, konfiguruje vašeho agenta v Teams Developer Portal a registruje blueprint agenta
Pozorovatelnost Přidává instrumentaci pozorovatelnosti Agent 365 SDK do vašeho agentního kódu
AI spoluhráč Spustí a365 publish a provází vás následnými kroky po nasazení, včetně vytvoření instance agenta

1 Provedené kroky závisí na typu agenta a fázích, které jste zvolili na začátku nastavení.

Důležité

Pro Pozorovatelnost agent AI zapisuje kód přímo do vašeho projektu. Agenti kódování AI mohou dělat chyby. Vždy před nasazením do produkce změny zkontrolujte.

Informace potřebné k dokončení

Agent AI se během nastavení pozastaví, aby shromáždil konfiguraci:

Prompt Co je potřeba poskytnout
Jméno agenta, e-mail manažera Základní metadata agenta
Potvrzení odvozené hodnoty Zkontrolujte automaticky generovaná jména pro identitu agenta, blueprint a uživatelský účet
Kontrola manifestu Potvrďte, že váš manifest.json obsahuje jméno, popis a informace o vývojáři vašeho agenta.

Kroky po nasazení

Po dokončení automatizovaných úrovní agent AI čeká na dva kroky, které vyžadují interakci v prohlížeči.

  1. Vytvoření instance agenta

    (Pouze pro týmového kolegu AI) — V Microsoft Teams přejděte do Aplikací, vyhledejte svého agenta a zvolte Přidat. Pokud je vyžadováno schválení administrátorem, váš administrátor Microsoft 365 obdrží žádost. Po schválení se váš agent zobrazí v organizačním schématu. Viz Vytvoření instancí agentů pro další instance. Může trvat několik minut, než se nově publikovaný agent objeví ve vyhledávání Teams.

  2. Otestujte svého agenta

    Pošlete zprávu svému agentovi v Teams, abyste ověřili, že agent funguje.

Hotovo — váš agent je nasazen, publikován a v provozu. Viz Vytvořit instance agentů, pokud potřebujete další instance.

Pokud něco nefunguje, agent AI poskytuje cílené odstraňování problémů. Můžete také využít Průvodce řešením problémů Agent 365.

Ruční referenční cesta

Tento odkaz použijte pouze tehdy, pokud řešíte krok, budujete CI/CD automatizaci nebo pracujete bez AI agenta pro kódování.

Krok Co to dělá Příručka
Nastavení konfigurace Vytvoří a365.config.json s vaším klientem, předplatným a detaily projektu. Pokud již máte stávající nasazení, nastavte koncový bod pro zasílání zpráv zde. Nastavení konfigurace Agent 365
Nastavení podrobného plánu Zaregistruje identitu agenta v Entra a zřizuje Azure prostředky (resource group, App Service Plan, webová aplikace) Nastavení blueprintu agenta
Nasazení Nasadí váš kód agenta do Azure App Service. Nepovinné, pokud již hostujete jinde. Azure · AWS · GCP
Publikování Vytváří manifest.zip a nahrává do Centra pro správu Microsoft 365 Publikujte agenta

Podrobnosti o instalaci rozhraní příkazového řádku, příkazech a řešení problémů najdete v rozhraní příkazového řádku Agent 365.

Zveřejněte svého agenta na Microsoft Marketplace

Poté, co svého agenta plně vyvinete a otestujete ve svém vlastním klientovi nebo klientech, zpřístupněte jej v Microsoft Marketplace.

K tomu potřebujete účet v programu Microsoft AI Cloud Partner v Partnerském centru. Pokud jej nemáte, vytvořte si účet, abyste získali PartnerID. Dále se přihlaste do programu Microsoft 365 a Copilot, který vám poskytne přístup ke zdrojům a podpoře potřebné k publikování nabídek agentů. Po zapsání do programu si prostudujte kontrolní seznam pro podání a pokyny pro validaci a poté odešlete svého agenta prostřednictvím průvodce krok za krokem v Partnerském centru.

Naučte se, jak odeslat svého agenta do Microsoft Marketplace pomocí Partnerského Centra

Po dokončení je váš agent zveřejněn v Microsoft Marketplace a k dispozici zákazníkům k objevení a nasazení.

Řešení problémů při nastavení řízeném AI

Pokud narazíte na problémy během nastavení řízeného AI, podívejte se na následující běžné problémy a jejich řešení.

Problém Popis
Agent AI nevykonává terminálové příkazy Agent AI popisuje příkazy, ale nevykonává je
Agent AI přeskočí kroky Nastavení zřejmě přeskakuje potřebné kroky
Příkazy rozhraní příkazového řádku selžou kvůli chybám oprávnění Chyby autorizace při spouštění příkazů rozhraní příkazového řádku a365
Konfigurační hodnoty jsou nesprávné Konfiguraci je třeba změnit po vytvoření a365.config.json

Agent AI nevykonává terminálové příkazy

Pokud AI agent popisuje příkazy, ale nevykoná je, ujistěte se, že používáte režim Agent GitHub Copilot Chat. Režimy Ask and Edit nemají přístup k terminálu.

Agent AI přeskočí kroky

Soubor instrukcí vynucuje přísné pořadí kroků. Pokud se zdá, že AI agent přeskočí krok, požádejte ho, aby začal znovu:

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

Příkazy rozhraní příkazového řádku selžou kvůli chybám oprávnění

Pokud a365 příkazy rozhraní příkazového řádku selžou kvůli chybám autorizace, nejčastější příčinou je chybějící nebo neúplná registrace vlastní klientské aplikace. agent AI tuto registraci ověřuje během nastavení, avšak pokud byla validace vynechána, podívejte se na Registrace vlastní klientské aplikace.

Pro obecné řešení problémů viz Průvodce odstraňováním problémů Agent 365.

Konfigurační hodnoty jsou nesprávné

Pokud potřebujete změnit konfigurační hodnoty po vytvoření a365.config.json, buď:

  • Upravte soubor přímo a spusťte znovu a365 config init -c ./a365.config.json
  • Požádejte agenta AI, aby aktualizoval konkrétní hodnoty