Vlastní konektory

Které prostředí používáte?

Tato dokumentace pokrývá obě prostředí. Pokud je k dispozici Settings → Personal → My Okou, postupujte podle kroků pro My Okou. Pokud používáte stránku Agents s New agent, postupujte podle kroků pro Legacy Agents. Dostupnost se může mezi členy lišit; tato dokumentace vaše prostředí nemění.

V obou prostředích můžete spouštět několik chatů nebo úloh současně, znovu používat pracovní postupy a sdílet s týmem zkontrolovanou práci. Runtime subagent je nástroj pro vykonávání, ne samostatný profil produktu, který byste museli vytvářet.

Rozdíly v nastavení: My Okou používá osobní Instructions v Settings → Personal → My Okou a pracovní postupy pracovního prostoru. Každý krok níže, který vás žádá o výběr, vytvoření nebo autorizaci pojmenovaného Agenta, platí pouze pro Legacy Agents. V My Okou používejte svůj vlastní Chat a postupujte podle zobrazeného požadavku na účet a pojmenované oprávnění. Sdílené pracovní postupy nesdílejí přihlašovací údaje; Automations používají kontext a přístup svého vlastníka.

Vlastní konektor umožňuje administrátorovi organizace zaregistrovat HTTPS API nebo tam, kde je to povoleno, Streamable HTTP MCP server, který není v integrovaném katalogu. Definuje síťovou hranici a metodu ověření. Automaticky nevytvoří pro agenta úplnou referenci API.

Kdo co konfiguruje

• Administrátoři organizace vytvářejí, upravují a odstraňují definici konektoru.
• Členové připojují svůj vlastní tajný údaj nebo dokončují OAuth tok konektoru.
• Autorizace a oprávnění řídí, které pojmenované akce může Okou s připojením požadovat. Legacy Agents také používají autorizaci specifickou pro Agenta.

Definice je v organizaci sdílená. Přihlašovací údaje člena zůstávají omezené na daného člena a organizaci.

Konektor HTTP API

1. Otevřete Connectors → Custom a vyberte New connector.
2. Vyberte HTTP API a zadejte zobrazovaný název.
3. Přidejte jeden nebo více HTTPS Prefixes, každý na samostatný řádek. Požadavek musí před autorizací konektoru odpovídat nakonfigurovanému prefixu.
4. Pokud API vyžaduje ověření, přidejte je:
   • API authentication: zadejte název hlavičky a šablonu hlavičky obsahující {{secret}}, například Authorization a Bearer {{secret}}.
   • OAuth 2.0: zadejte autorizační URL, tokenovou URL, ID klienta, tajný klíč klienta, scope a metodu ověření na tokenovém endpointu. U poskytovatele zaregistrujte přesnou URL pro přesměrování zobrazenou ve formuláři.
5. Vytvořte konektor. Každý člen, který jej potřebuje, pak vybere Connect a zadá svůj tajný údaj nebo dokončí OAuth.
6. Zkontrolujte a autorizujte požadovaná pojmenovaná oprávnění. V Legacy Agents také vyberte zamýšleného Agenta.

Změna existující definice OAuth nebo jejích přihlašovacích údajů klienta odpojí aktuální připojení OAuth. Po změně se musí členové znovu připojit.

Konektor MCP

Pokud se ve vašem pracovním prostoru zobrazuje MCP jako typ konektoru, zadejte koncový bod MCP HTTPS Streamable HTTP a ve stejném formuláři nastavte ověřování pomocí API nebo OAuth. Pokud MCP v nabídce není, není pro tento pracovní prostor povolen.

Naučte agenta postup API

Vlastní konektor poskytuje bezpečný síťový přístup a vkládání přihlašovacích údajů. Formulář pro vytvoření nenahrává ani automaticky neobjevuje dokument OpenAPI. Dejte agentovi v požadavku endpoint, metodu, parametry a očekávanou odpověď, nebo tento postup zachyťte ve pracovním postupu s přiloženou referencí API jako soubor.

Nový konektor ověřte pomocí úzkého, jen pro čtení určeného požadavku na známý endpoint. Neexistuje obecný požadavek Test connection, protože mnoho API neexponuje smysluplný kořenový endpoint.

Bezpečnostní hranice

• Přijímají se pouze HTTPS prefixy a MCP endpointy.
• Firewall vkládá uložené přihlašovací údaje pouze do odpovídajících požadavků.
• Uložený tajný údaj je při uložení šifrovaný a není agentovi vystaven jako proměnná prostředí.
• Nezadávejte klíče, tokeny ani tajné klíče klienta do zpráv v chatu, instrukcí workflow ani přiložených souborů.
• Používejte servisní přihlašovací údaje s minimálními upstream scopes, které workflow potřebuje.

Řešení problémů

Co dál

• Podívejte se na Pracovní postupy pro zachycení opakované práce s vlastním konektorem.
• Podívejte se na Oprávnění, jak se nakládá s přihlašovacími údaji vlastního konektoru.
• Před vytvářením vlastního řešení se podívejte do Katalogu — vaše služba už může být podporována.