snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/cs/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: AI agenti
+description: Integrujte možnosti AI přímo do svých automatizačních pracovních postupů.
+---
+
+## Přehled
+
+Integrujte možnosti AI přímo do svých automatizačních pracovních postupů pro inteligentní zpracování dat a rozhodování.
+
+## Možnosti
+
+| Funkce              | Popis                                                           |
+| ------------------- | --------------------------------------------------------------- |
+| **Akce AI**         | Přidejte do libovolného pracovního postupu kroky využívající AI |
+| **Obohacování dat** | Automaticky obohacujte záznamy externími daty                   |
+| **Klasifikace**     | Kategorizujte záznamy na základě analýzy obsahu                 |
+| **Shrnutí**         | Vytvářejte souhrny z textových polí                             |
+| **Vlastní prompty** | Přesně určete, jak AI zpracovává vaše data                      |
+
+## Případy použití
+
+* **Skórování leadů**: Automaticky ohodnocujte a upřednostňujte příchozí leady
+* **Čištění dat**: Standardizujte názvy společností a kontaktní informace
+* **Návrhy e-mailů**: Generujte návrhy následných e-mailů na základě poznámek ze schůzek
+* **Směrování záznamů**: Přiřazujte záznamy správnému členovi týmu na základě obsahu
+
+## Související
+
+* [Přehled pracovních postupů](/l/cs/user-guide/workflows/overview) — základy automatizace
+* [Oprávnění AI](/l/cs/user-guide/ai/capabilities/permissions-access-control) — řízení přístupu pro agenty AI

packages/twenty-docs/l/cs/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: AI chatbot
+description: Inteligentní asistent, který vám pomáhá pracovat s daty vašeho CRM pomocí přirozeného jazyka.
+---
+
+## Přehled
+
+Zeptejte se na otázky v přirozeném jazyce a asistent vyhledá a vysvětlí vaše údaje CRM pro vás.
+
+## Možnosti
+
+| Funkce                         | Popis                                                                                    |
+| ------------------------------ | ---------------------------------------------------------------------------------------- |
+| **Dotazy v přirozeném jazyce** | Pokládejte otázky v běžné angličtině místo vytváření filtrů                              |
+| **Plný přístup k datům**       | Vyhledávejte záznamy, vztahy a metriky napříč vaším pracovním prostorem                  |
+| **Kontext stránky**            | Odkazujte na "tuto společnost" nebo "tuto příležitost" podle vašeho aktuálního zobrazení |
+| **Konverzační**                | Navazující otázky zachovávají kontext z předchozích dotazů                               |
+
+## Příklady interakcí
+
+### Hledání záznamů
+
+* "Ukaž mi všechny příležitosti nad 50 000 $"
+* "Najdi kontakty, kterým jsem už 2 týdny neposlal e-mail"
+* "Vypiš společnosti ve zdravotnickém odvětví"
+
+### Získávání poznatků
+
+* "Jaká je moje celková hodnota pipeline?"
+* "Kolik obchodů se uzavřelo minulý měsíc?"
+* "Ve které fázi je nejvíce uvízlých příležitostí?"
+
+### Využití kontextu stránky
+
+* "Shrň moje interakce s touto osobou" (na stránce kontaktu)
+* "Které příležitosti jsou spojené s touto společností?" (na stránce společnosti)
+* "Kdy byl tento obchod naposledy aktualizován?" (na stránce příležitosti)

packages/twenty-docs/l/cs/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: MCP Server
+description: Připojte asistenty AI ke svému pracovnímu prostoru Twenty pomocí protokolu Model Context Protocol.
+---
+
+Twenty zpřístupňuje server [MCP](https://modelcontextprotocol.io/), aby AI asistenti — Claude Desktop, Claude Code, Cursor, ChatGPT a další — mohli číst a zapisovat data vašeho CRM pomocí přirozeného jazyka.
+
+Použijte svou **adresu URL pracovní oblasti** (adresu URL, kterou používáte k přístupu k Twenty) jako koncový bod MCP. V Twenty Cloud může vaše adresa URL pracovní oblasti být `https://{mycompany}.twenty.com` nebo vlastní doména. Server je dostupný na:
+
+| Prostředí           | Koncový bod MCP                                                               |
+| ------------------- | ----------------------------------------------------------------------------- |
+| **Cloud**           | `https://{your-workspace-url}/mcp` (např. `https://mycompany.twenty.com/mcp`) |
+| **Vlastní hosting** | `https://{your-domain}/mcp`                                                   |
+
+## Metody ověření
+
+Máte dva způsoby, jak ověřit svého klienta MCP: **OAuth** (doporučeno) nebo **klíč API**.
+
+### Možnost A — OAuth (doporučeno)
+
+S OAuth váš klient MCP otevře okno prohlížeče, abyste se mohli přihlásit. V konfiguračních souborech se neukládají žádné tajné údaje a tokeny se automaticky obnovují.
+
+<Note>
+OAuth vyžaduje klienta MCP, který podporuje [specifikaci autorizace MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Podporují ji Claude Desktop, Claude Code, Cursor a ChatGPT.
+</Note>
+
+Přidejte toto do konfigurace svého klienta MCP a nahraďte `{your-workspace-url}` hostitelem vaší pracovní oblasti (např. `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+To je vše — není potřeba žádný klíč API. Když se klient připojí poprvé, provede:
+
+1. Získá metadata OAuth služby Twenty pomocí `/.well-known/oauth-protected-resource` a `/.well-known/oauth-authorization-server`
+2. Zaregistruje se jako klient OAuth prostřednictvím dynamické registrace klienta (RFC 7591)
+3. Otevře váš prohlížeč k autorizaci přístupu
+4. Převezme tokeny a připojí se k serveru MCP
+
+Následující připojení znovu použijí uložené tokeny a automaticky je obnoví.
+
+### Možnost B — klíč API
+
+Pokud váš klient MCP nepodporuje OAuth, nebo dáváte přednost statickým přihlašovacím údajům, předejte klíč API v hlavičce `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+Váš klíč API poskytuje přístup k datům pracovní oblasti. Nenechávejte jej ve verzovacím systému ani ve sdílených dotfiles.
+</Warning>
+
+Chcete-li vytvořit klíč API, přejděte do **Settings → MCP & APIs → API → + Create key**. Podrobnosti viz [Rozhraní API](/l/cs/developers/extend/api#create-an-api-key).
+
+## Rychlý start
+
+### 1. Zkopírujte konfiguraci
+
+V Twenty přejděte do **Settings → MCP & APIs → MCP**. Vyberte metodu ověření (OAuth nebo klíč API), zkopírujte úryvek JSON (už bude používat adresu URL vaší pracovní oblasti) a vložte jej do konfiguračního souboru klienta MCP.
+
+| Klient             | Umístění konfiguračního souboru                                                                                                                                   |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) nebo `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                            |
+| **Claude Code**    | `~/.claude.json` (uživatel) nebo `.mcp.json` (projekt)                                                                                                            |
+| **Cursor**         | `.cursor/mcp.json` ve vašem projektu nebo `~/.cursor/mcp.json` globálně                                                                                           |
+| **ChatGPT**        | Zapněte Developer Mode v **Settings → Apps & Connectors → Advanced settings**, poté použijte **Create** v **Settings → Apps & Connectors** k přidání serveru MCP. |
+
+### 2. Připojení
+
+Restartujte svého klienta MCP (nebo znovu načtěte konfiguraci). Pokud používáte OAuth, budete přesměrováni do Twenty k autorizaci přístupu. Pokud používáte klíč API, připojení je okamžité.
+
+### 3. Začněte jej používat
+
+Požádejte svého AI asistenta, aby pracoval s vaším CRM:
+
+* *"Ukaž mi 5 nejnověji vytvořených společností"*
+* *"Vytvoř novou osobu jménem Jane Doe ve společnosti Acme Corp"*
+* *"Najdi všechny otevřené příležitosti s hodnotou vyšší než 10 000 $"*
+
+## Dostupné nástroje
+
+Po připojení server MCP zpřístupní nástroje, které odpovídají rozhraní Twenty API. Doporučený pracovní postup je:
+
+1. **`learn_tools`** — získat vstupní schéma pro konkrétní nástroje
+2. **`execute_tool`** — spustit nástroj
+
+Není potřeba si pamatovat názvy nástrojů. Zeptejte se svého AI asistenta, co umí, a automaticky zavolá `learn_tools`.
+
+## Oprávnění
+
+Připojení MCP dědí oprávnění ověřeného uživatele (OAuth) nebo roli přiřazenou ke klíči API. Chcete-li omezit, co může server MCP provádět:
+
+* **OAuth**: Platí role uživatele v pracovní oblasti.
+* **Klíč API**: Přiřaďte klíči API roli v **Settings → Members → Roles**. Viz [Oprávnění](/l/cs/user-guide/permissions-access/capabilities/permissions).
+
+## Konfigurace pro self-hosting
+
+U samostatně hostovaných instancí nahraďte `{your-workspace-url}` adresou URL svého serveru. Ujistěte se, že `SERVER_URL` ve vašem prostředí odpovídá veřejné adrese URL vaší instance Twenty — tato hodnota se používá k vygenerování metadat pro zjišťování OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+Koncový bod MCP, koncové body OAuth a metadata pro zjišťování se z této hodnoty odvozují.
+
+## Řešení potíží
+
+**Chyby "Unauthorized" nebo 401**
+
+* OAuth: Proveďte znovu autorizaci vymazáním uložených tokenů ve vašem klientovi MCP a znovu se připojte.
+* Klíč API: Ověřte, že je klíč platný a nevypršela mu platnost. V případě potřeby jej znovu vygenerujte.
+
+**Tok OAuth neotevírá prohlížeč**
+
+* Ujistěte se, že váš klient MCP podporuje autorizaci MCP. Pokud ne, použijte metodu s klíčem API.
+
+**Časový limit připojení**
+
+* Ověřte, že je adresa URL koncového bodu MCP dosažitelná z vašeho počítače. U samostatně hostovaných instancí zkontrolujte, že server běží a že je `SERVER_URL` nastaven správně.

packages/twenty-docs/l/cs/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: Oprávnění a řízení přístupu
+description: Ovládejte, k čemu mohou agenti AI ve vašem pracovním prostoru přistupovat a co mohou měnit.
+---
+
+## Přehled
+
+Agenti AI respektují vaši stávající strukturu oprávnění. To je obzvlášť důležité pro týmy, které chtějí přesně řídit, k čemu mohou automatizované procesy AI v jejich pracovním prostoru přistupovat nebo co mohou upravovat.
+
+## Přiřadit roli agentovi AI
+
+1. Přejděte na **Nastavení → Členové → Role**
+2. Klikněte na roli, kterou chcete přiřadit
+3. Otevřete záložku **Přiřazení**
+4. V části **Agenti AI** klikněte na **+ Přiřadit agentovi AI**
+5. Vyberte agenta AI ze seznamu
+6. Potvrďte přiřazení
+
+## Proč přiřazovat role agentům AI?
+
+| Výhoda              | Popis                                                           |
+| ------------------- | --------------------------------------------------------------- |
+| **Bezpečnost**      | Omezte, k jakým datům mohou agenti AI přistupovat nebo je měnit |
+| **Soulad**          | Zajistěte, aby AI zpracovávala pouze data, která potřebuje      |
+| **Kontrola**        | Zabraňte nechtěným akcím automatizací AI                        |
+| **Auditovatelnost** | Sledujte, které akce provedl který agent                        |
+
+<Note>
+U agentů AI běžících v pracovních postupech přiřazení role zajistí, že agent nebude mít přístup k datům mimo zamýšlený rozsah ani je nebude moci upravovat — i když má pracovní postup širší oprávnění.
+</Note>
+
+## Související
+
+* [Oprávnění](/l/cs/user-guide/permissions-access/capabilities/permissions) — podrobné informace o vytváření a správě rolí
+* [Agenti AI](/l/cs/user-guide/ai/capabilities/ai-agents) — možnosti AI v pracovních postupech

packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: Často kladené otázky k AI
+description: Často kladené otázky k funkcím AI v Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="Jaké možnosti AI jsou k dispozici?">
+    Dvě hlavní schopnosti AI jsou:
+
+    1. **AI Chatbot**: Asistent s kontextovým povědomím, který může přistupovat k vašim datům v Twenty a pomůže vám s dotazy
+    2. **AI agenti v pracovních postupech**: Inteligentní automatizace, která dokáže zpracovávat data, činit rozhodnutí a vykonávat úlohy ve vašich pracovních postupech
+  </Accordion>
+
+  <Accordion title="Mají AI agenti přístup ke všem mým datům?">
+    Zástupci AI pracují v rámci systému oprávnění. V části **Nastavení → Členové → Role** můžete AI agentům přiřadit konkrétní role, čímž získáte plnou kontrolu nad tím, k jakým datům mají přístup a jaké akce mohou provádět.
+  </Accordion>
+
+  <Accordion title="Jak fungují kredity pro AI?">
+    Akce AI spotřebovávají kredity pracovních postupů podle složitosti úlohy a použitého modelu AI.
+  </Accordion>
+
+  <Accordion title="Mohu používat vlastní modely AI?">
+    V cloudu můžete používat pouze modely AI poskytované Twenty. Ve své self‑hostované instanci můžete po získání licence Organization používat vlastní modely AI.
+  </Accordion>
+
+  <Accordion title="Nevidím roli přiřazenou agentovi AI, kde je?">
+    Ve výchozím nastavení je seznam rolí omezen na role přiřaditelné členům pracovního prostoru. Pokud je role přiřaditelná pouze agentům AI, musíte změnit filtr tak, aby zahrnoval role AI.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/cs/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: AI
+description: Funkce s podporou AI v Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="AI" />
+</Frame>
+
+## Funkce
+
+V současnosti Twenty nabízí:
+
+### 1. AI chatbot
+
+Konverzační asistent, který rozumí vašemu kontextu a má přístup ke všem vašim datům v Twenty.
+
+**Klíčové možnosti:**
+
+* **Plný přístup k datům**: Vyhledejte libovolný záznam, vztah či metriku ve vašem pracovním prostoru
+* **Znalost kontextu stránky**: Odkazujte na "tuto společnost" nebo "tuto příležitost" podle toho, kde se v Twenty nacházíte
+* **Přirozený jazyk**: Ptejte se a získávejte odpovědi bez procházení nabídek
+
+**Příklady promptů:**
+
+* "Které příležitosti se uzavírají tento měsíc?"
+* "Které obchody jsou ve fázi vyjednávání déle než 30 dní?"
+* "Shrň moje interakce s touto osobou"
+
+### 2. AI agenti v pracovních postupech
+
+Rozšiřte své pracovní postupy o akce poháněné AI a autonomní agenty.
+
+**Klíčové možnosti:**
+
+* **Akce AI**: Používejte AI k obohacení dat, klasifikaci záznamů, tvorbě souhrnů a dalším
+* **Autonomní agenti**: Nechte agenty provádět vícekrokové úlohy v rámci pracovního postupu
+* **Vlastní prompty**: Definujte přesně, jak má AI zpracovávat vaše data
+
+**Případy použití:**
+
+* Automaticky kategorizujte příchozí leady
+* Obohaťte firemní data z veřejných zdrojů
+* Generujte návrhy následných e-mailů na základě poznámek ze schůzek
+* Ohodnocujte příležitosti na základě vzorců zapojení
+
+## Oprávnění a řízení přístupu
+
+AI agenti jsou spravováni prostřednictvím stávajícího systému oprávnění:
+
+1. Přejděte na **Nastavení → Členové → Role**
+2. Nastavte, k jakým datům může mít každý AI agent přístup
+3. Nastavte oprávnění pro čtení/zápis pro jednotlivé objekty
+
+To zajistí, že AI agenti budou respektovat vaše zásady správy dat a budou přistupovat pouze k tomu, co potřebují.
+
+* Sledujte náš [GitHub](https://github.com/twentyhq/twenty) pro novinky o vývoji
+* Přidejte se na náš [Discord](https://discord.gg/UfGNZJfAG6) a podělte se o zpětnou vazbu a návrhy na nové funkce