Externí nástroje pro agenta

Zkratka MCP se v aplikaci Consulaio objevuje ve dvou významech. V článku Consulaio v jiných AI nástrojích se váš AI nástroj ptá znalostní báze Consulaio. Tady jde o opačný směr: agent Consulaio dostane nástroje z cizího MCP serveru.

Od plánu ProfiAktualizováno

Co jsou externí nástroje pro agenta Consulaio?

Externí nástroje rozšiřují agenta Consulaio o schopnosti cizí služby. Připojíte její MCP server a Consulaio jeho nástroje nabídne agentovi vedle znalostní báze. Kdy nástroj zavolá, rozhoduje agent sám podle dotazu. Nástroj, který něco mění nebo odesílá, ale spustí až po vašem souhlasu.

Než začnete

Potřebujete adresu MCP serveru, která začíná https://, a přihlašovací údaj, pokud ho server vyžaduje. Obojí najdete v dokumentaci služby.

Jak přidám MCP server do Consulaio?

MCP servery přidáte v Nastavení na kartě Propojení, v části Nástroje pro agenta (MCP). Servery pro celou organizaci přidává správce stejně, jen v přepínači účtu pod Spravovat organizaci na stránce Propojení.

  1. Klikněte na Přidat server.

  2. Do pole Adresa serveru (URL) vložte adresu z dokumentace služby.

    Název nezadáváte: Consulaio server pojmenuje tak, jak se sám představí, a když žádný název nepošle, podle adresy. V seznamu ho pak můžete přejmenovat.

  3. U položky Způsob přihlášení zvolte Bez přihlášení, API klíč nebo OAuth. U API klíče vyplňte Název hlavičky (nepovinné), jen když to služba vyžaduje.

  4. Potvrďte tlačítkem Připojit, u OAuth tlačítkem Přihlásit přes OAuth.

    Přihlášení ke službě se otevře na nové kartě.

Poznámka

Consulaio se k serveru hned připojí a načte jeho nástroje. Když se to nepovede, neuloží se nic a okno zůstane otevřené s vysvětlením chyby. Vyžaduje-li server OAuth, Consulaio způsob přihlášení přepne samo a vy formulář odešlete znovu.

Název serveru později změníte, když jeho řádek rozbalíte a kliknete na ikonu Přejmenovat.

Nové nástroje serveru načtete ikonou Obnovit nástroje. Přihlašovací údaj u připojeného serveru změnit nejde: server odstraňte a přidejte znovu s novým údajem.

Jak zapnu nebo vypnu jednotlivé nástroje?

Kliknutím na název serveru rozbalíte seznam jeho nástrojů. Zaškrtnutím nástroj zapnete, odškrtnutím vypnete. Celý server vypnete přepínačem u jeho řádku. Změna platí od další zprávy.

Vypnutý nástroj agent vůbec nevidí. Užší výběr mu pomáhá zvolit správný nástroj. Vyplatí se vypnout i akce, které nechcete nechat na něm. Nově načtené nástroje jsou zapnuté, pokud se vejdou do limitu.

Připojený server s rozbaleným seznamem nástrojů
Rozbalený server a nástroje, které nabízí.
  1. 1Kliknutím na název serveru rozbalíte seznam jeho nástrojů.
  2. 2Zaškrtnutý nástroj smí agent použít.
  3. 3Každý nástroj zapnete nebo vypnete zvlášť.

Co když má nástroj něco zapsat nebo odeslat?

Nástroj, který jen čte, použije agent rovnou. Nástroj, který něco mění nebo odesílá, sám nespustí. Pod odpověď připojí kartu s názvem nástroje a přesnými údaji, se kterými by ho zavolal. Tlačítkem Ano nástroj zavoláte, tlačítkem Ne volání zamítnete a odpověď pak pod kartou pokračuje.

  • Dokud nerozhodnete, nic se neodešle a v konverzaci nemůžete psát dál.
  • Consulaio zavolá nástroj přesně s údaji z karty. Agent je po vašem potvrzení změnit nemůže.
  • Jedna odpověď navrhuje nejvýš jedno takové volání.
  • Rozhoduje jen ten, kdo se ptal. Kolega, který konverzaci vidí, má tlačítka neaktivní.
  • Na kartě zůstane, jak volání dopadlo: Provedeno, Zamítnuto, nic se neprovedlo nebo Něco se nepovedlo. Agent to ví i v dalších zprávách.

V seznamu nástrojů má každý nástroj štítek čte nebo zapisuje, který Consulaio přebírá od serveru. Když server neuvede, že nástroj jen čte, Consulaio ho bere jako zapisující a vždy se zeptá.

Stejnou kartou se agent zeptá i tehdy, když by volání nástroje neslo skutečné jméno, které Consulaio jinak nahrazuje. Popisuje to článek Pseudonymizace osobních údajů.

Poznámka

Pojistka chrání i před podvrženými pokyny. Když dokument nebo výsledek jiného nástroje vyzve agenta, aby něco odeslal, agent může volání nanejvýš navrhnout. Bez vašeho Ano se nic neodešle.

Kolik MCP serverů a nástrojů můžu mít zapnutých?

Připojených serverů může být libovolně mnoho, zapnutých jen omezený počet. Limity platí pro celý účet, takže se v organizaci počítají i servery kolegů a servery organizace. Vypnout server může jen ten, kdo ho připojil, a server organizace jen správce. Když je limit serverů vyčerpaný, nový server přibude vypnutý a nástroje nad limit Consulaio samo vypne.

LimitHodnota
Souběžně zapnuté MCP servery5
Zapnuté nástroje napříč všemi servery60

Consulaio omezuje také, kolikrát a jak dlouho smí agent v jedné zprávě volat jeden nástroj.

Co znamenají stavy Připojeno, Chyba a Vyžaduje přihlášení?

Stav serveru se mění jen při potížích se spojením nebo přihlášením. Chyba jednoho nástroje stav serveru nemění – agent ji ohlásí v odpovědi a pokračuje s tím, co má. Server ve stavu Chyba nebo Vyžaduje přihlášení agent nepoužívá, dokud potíž nevyřešíte.

StavCo znamenáCo s tím
PřipojenoServer odpovídá a jeho zapnuté nástroje má agent k dispozici.Nic, vše funguje.
ChybaConsulaio se k serveru nepřipojilo, nebo server odmítl přihlašovací údaje.Klikněte na ikonu Obnovit nástroje. Pokud chyba trvá, server odstraňte a přidejte znovu s ověřenou adresou a přihlašovacím údajem.
Vyžaduje přihlášeníPlatnost přihlášení přes OAuth vypršela.Klikněte na ikonu Přihlásit znovu a projděte přihlášení na nové kartě.

Je připojení externího MCP serveru bezpečné?

Externí MCP server vidí to, co mu agent při volání pošle, tedy údaje odvozené z vaší konverzace. Consulaio má několik pojistek, ale komu důvěřovat, rozhodujete vy. Připojujte jen služby, které znáte a kterým své podklady svěříte.

  • Consulaio přijímá jen adresy začínající https:// a ověřuje je při každém volání. Na vnitřní síť je nasměrovat nelze.
  • Přihlašovací údaje ukládá šifrovaně, odděleně pro každý server, a zpět je nezobrazuje. Když server odstraníte, nevratně je smaže.
  • Popisy nástrojů i jejich odpovědi bere agent jako nedůvěryhodná data.
  • Nástroj, který něco mění nebo odesílá, spustí Consulaio až po vašem potvrzení.

Kdo z účtu server uvidí a kam jdou údaje?

Server, který připojíte v Nastavení, používáte jen vy a kolegové ho nevidí. Server, který připojí správce v přepínači účtu pod Spravovat organizaci, patří organizaci: agent ho používá v konverzacích všech v organizaci pod přihlášením, které zadal správce.

Zda si kolegové smějí připojit vlastní server, určuje správce pravidlem Vlastní MCP servery, jak popisuje článek Sdílená organizace.

Připojený nástroj si vybíráte sami, takže příjemce údajů určujete vy. Jeho provozovatel není naším dodavatelem a za to, jak s údaji naloží, neodpovídáme. Pokud vás váže mlčenlivost, posuďte předem, zda mu údaje smíte předat.

Časté potíže

ProjevCo s tím
Server s API klíčem hlásí neplatné přihlášení, i když je klíč správnýBez vyplněného názvu hlavičky posílá Consulaio klíč v hlavičce Authorization přesně tak, jak jste ho vložili. Vyžaduje-li služba tvar Bearer, server odstraňte a přidejte znovu s klíčem ve tvaru „Bearer klíč“.
Server má štítek Pozastaveno a agent ho nepoužíváSprávce vypnul pravidlo Vlastní MCP servery. Nic se nesmazalo a po zapnutí pravidla server zase funguje. Do té doby ho můžete jen odstranit. Do limitu zapnutých serverů se počítá dál. Viz Sdílená organizace.
Server nepodporuje přihlášení přes OAuthPřipojte ho přes API klíč. Klíč získáte v nastavení služby.
Přepínač u serveru nebo zaškrtávací políčko u nástroje nejde zapnoutLimit zapnutých serverů nebo nástrojů je vyčerpaný. Nejdřív jiný vypněte, případně o to požádejte kolegu nebo správce, který ho připojil.
Připojení skončí hláškou „Server nabízí příliš mnoho nástrojů nebo příliš velká data.“Server posílá víc dat, než Consulaio dokáže načíst. Zeptejte se jeho provozovatele, jestli nemá verzi s menší sadou nástrojů.

Časté dotazy

Uvidí externí server moje dokumenty z Consulaio?

Ne, pokud mu je agent sám nepošle při volání. Dokumenty ani znalostní bázi Consulaio externím serverům nezpřístupňuje.

Zůstane nastavení serverů po změně plánu?

Na plánu, který externí nástroje nezahrnuje, se servery i jejich nastavení zamknou a agent je nepoužívá. Co se se zamčenými daty stane dál, popisuje článek Plány, dotazy a platby.

Související

Našli jste v článku chybu nebo něco nesedí? Napište nám