> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synkrony.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistente IA (Chatbot)

> Converse com seu workspace para consultar dados, gerenciar tarefas, documentos e planejar sprints em linguagem natural

# Assistente IA (Chatbot)

O **Assistente IA** (também exibido como **Chat IA**) é o copiloto conversacional do seu workspace no Synkrony. Com ele, você consulta informações, cria e organiza tarefas, move cards no Kanban, atualiza checklists e comentários, analisa a capacidade das sprints e transforma ideias em tarefas prontas — tudo em linguagem natural.

***

## Qual Ferramenta de IA Usar?

No Synkrony, cada recurso de inteligência artificial tem um foco específico no seu fluxo de trabalho:

| Recurso | Para que Serve | Onde Atua |
| - | - | - |
| **Assistente IA (Chatbot)** | Consultar dados, organizar backlog, mover cards, atualizar checklists/comentários, gerenciar documentos, checar sprints e refinar ideias | Gestão do workspace dentro do Synkrony |
| **Kanbino (Modo IA)** | Ler sua codebase no GitHub, gerar plano técnico, implementar código, rodar testes e abrir Pull Requests | Desenvolvimento de código em tarefas específicas |
| **MCP Externo** | Conectar ferramentas externas (Claude Code, Cursor, Windsurf) ao Synkrony via token de API | IDEs e clientes externos ([ver guia MCP](https://docs.synkrony.ai/model-context-protocol.md)) |

***

## Como Funciona

Do seu pedido até a ação concluída no quadro, o Assistente IA segue um fluxo simples e transparente:

**1. Envie seu pedido em linguagem natural**

Escreva o que precisa no chat — como pedir um resumo da sprint, buscar uma tarefa pelo código ou solicitar uma criação/movimentação — ou clique em uma das **4 sugestões rápidas** exibidas em conversas novas.

**2. Acompanhe as etapas ao vivo**

Enquanto processa sua mensagem, o assistente verifica a segurança e o contexto da empresa, exibe em tempo real o que está consultando ou preparando e mantém tudo restrito aos dados do seu workspace.

**3. Confirme decisões importantes quando solicitado**

Para manter você sempre no controle, o assistente pausa e exibe um card de escolha antes de seguir em dois casos:

* **Ideia em aberto:** pergunta se você prefere **Refinar ideia**, **Criar task agora** ou **Cancelar**;
* **Ações sensíveis:** exige clicar em **Confirmar** antes de excluir uma tarefa ou arquivar um documento.

**4. Interaja com os resultados na conversa**

Ao concluir, você recebe a resposta explicada em texto junto com **cards visuais clicáveis** (tarefas criadas ou movidas com link direto para o Kanban, listas de resultados, checklists e resumo de capacidade).

***

## Como Acessar

> [tab] Painel Lateral no Kanban (Desktop)
>
> Ao abrir o quadro Kanban (no modo Workspace ou no Modo IA), clique no **botão flutuante** com ícone de estrelas no canto inferior direito:
>
> * Abre o painel lateral do **Assistente IA** sem tirar você do quadro;
> * Pressione **`Esc`** para fechar o painel rapidamente;
> * Clique no botão de **expandir** no cabeçalho para abrir a conversa em tela cheia.

> [tab] Página Dedicada (/chat)
>
> Acesse a visualização completa em `/chat` (ou pelo menu **Chat IA** na navegação mobile):
>
> * No **desktop**, conta com barra lateral fixa para alternar entre conversas e iniciar uma **Nova conversa**;
> * No **mobile**, traz um seletor suspenso no topo para navegar, criar ou excluir conversas com praticidade;
> * Pressione **`Enter`** para enviar mensagens (`Shift + Enter` adiciona quebra de linha).

***

## Disponibilidade e Modo Somente Leitura

O Assistente IA fica disponível quando os recursos de IA estão habilitados para a empresa, variando conforme a assinatura:

| Situação da Empresa | Acesso ao Chat | Como Funciona |
| - | - | - |
| **Plano pago ativo ou acesso vitalício** | **Completo** | Pronto para uso utilizando a IA da plataforma |
| **Plano gratuito com chave de API própria** | **Completo** | Utiliza a chave configurada pela empresa em **Configurações → Kanbino IA** |
| **Plano gratuito sem chave configurada** | **Modo somente leitura** | Permite consultar e excluir conversas antigas, mas bloqueia o envio de novas mensagens |

### Como Desbloquear o Envio de Mensagens

Caso o chat exiba o aviso de **Modo somente leitura** no rodapé:

1. **Assine um plano pago** em **Configurações → Assinatura** ([ver planos](https://docs.synkrony.ai/planos.md)); ou
2. **Adicione uma chave de API própria** em **Configurações → Kanbino IA** (ative o recurso Kanbino em **Configurações → Funcionalidades** para exibir essa tela, caso ainda esteja oculta) usando o provedor **Anthropic API Key** ou **Z.ai API Key**.

> [!WARNING]
>
> Chaves cadastradas como **Claude Code API Key** servem para execução de código pelo agente, não para o chat conversacional. Para liberar o Assistente IA com chave própria, utilize **Anthropic API Key** ou **Z.ai API Key**.

***

## O Que o Assistente Pode Fazer

> [card] Busca Unificada
>
> Encontre tarefas por código (ex.: `SYN-42`), título ou descrição, além de documentos e projetos com múltiplos filtros.

> [card] Gestão de Tarefas e Kanban
>
> Crie tarefas completas, atualize campos, mova cards entre colunas e sprints ou reordene prioridades no quadro.

> [card] Checklists e Comentários
>
> Adicione itens ao checklist, marque etapas concluídas, leia comentários recentes e publique atualizações nas tarefas.

> [card] Sprints, Capacidade e Docs
>
> Consulte a capacidade disponível da próxima sprint, alocação por membro/equipe e gerencie documentos do projeto.

### Exemplos Práticos por Área

> [tab] Consultas e Busca
>
> * *"Quais são as tarefas em andamento na sprint atual?"*
> * *"Pesquise tarefas urgentes no projeto Checkout"*
> * *"Mostre tudo que temos sobre autenticação entre tarefas e documentos"*
> * *"Liste os projetos ativos do workspace"*
>
> **O que você vê:** cards clicáveis com código da tarefa, título, projeto, status colorido, estimativa em SP e link direto para abrir no Kanban.

> [tab] Tarefas e Kanban
>
> * *"Crie uma tarefa no projeto Backend para validar o webhook de pagamento com prioridade alta e 4h de estimativa"*
> * *"Mova a tarefa SYN-42 para Em Andamento no topo da coluna"*
> * *"Passe a tarefa SYN-18 para a próxima sprint e atribua para a Maria"*
> * *"Exclua a tarefa duplicada SYN-99"* *(solicita confirmação antes)*
>
> **Comportamento inteligente:** ao editar ou atribuir tarefas em uma sprint, o assistente verifica automaticamente a capacidade configurada dos responsáveis e alerta se alguém ficar acima da capacidade.

> [tab] Checklists e Comentários
>
> * *"Mostre o checklist da tarefa SYN-42"*
> * *"Adicione 'Validar payload do webhook' ao checklist da SYN-42"*
> * *"Marque o item de testes da SYN-42 como concluído"*
> * *"Quais são os últimos comentários da SYN-18?"*
> * *"Comente na SYN-18 que o deploy foi validado em staging"*
>
> **Atualização instantânea:** novos comentários são publicados em seu nome com formatação em Markdown e refletem imediatamente na tarefa aberta pelo time.

> [tab] Sprints e Capacidade
>
> *(Disponível quando o módulo de Sprints está habilitado no workspace.)*
>
> * *"Mostre o resumo de capacidade da próxima sprint"*
> * *"Como está a alocação de cada membro na sprint atual?"*
> * *"Quais pessoas fazem parte do time de Frontend?"*
>
> **O que você vê:** um card com os indicadores de **Capacidade**, **Alocado** e **Disponível** da sprint, além da lista de tarefas no backlog aguardando responsável.

> [tab] Documentos
>
> *(Disponível quando o módulo de Documentos está ativo no workspace.)*
>
> * *"Liste os documentos do projeto App Mobile"*
>
> * *"Leia o conteúdo do documento de arquitetura da API"*
>
> * *"Crie um documento no projeto Backend com o checklist de deploy"*
>
> * *"Atualize o documento #12 adicionando a nova seção de autenticação"*
>
> * *"Arquive o documento antigo de onboarding"* *(solicita confirmação antes)*
>
> > [!NOTE]
> >
> > As ações de documentos no chat atuam sobre documentos compartilhados com a equipe no workspace, preservando documentos de acesso restrito. Ao editar documentos de texto, uma nova versão é salva no histórico automaticamente.

***

## Refinamento Guiado de Ideias

Quando você ainda está amadurecendo uma demanda — em vez de mandar criar a tarefa direto — o Assistente IA ajuda a estruturar o escopo antes de colocar no backlog.

Ao enviar uma mensagem exploratória (por exemplo: *"Estou pensando em criar um fluxo de onboarding para novos clientes, o que devemos considerar?"*), o assistente exibe o card **Refinamento de Ideia / Possível Task** com três caminhos:

1. **Refinar ideia:** inicia uma conversa colaborativa para estruturar objetivos, considerações técnicas/UX e critérios de aceitação **sem criar nenhuma tarefa antes da hora**. Um indicador fixo mantém o botão **Criar task agora** visível para quando você estiver pronto (ou basta pedir *"pode criar a task"*).
2. **Criar task agora:** consolida a ideia e tudo o que já foi discutido em uma tarefa estruturada com título e descrição em Markdown.
3. **Cancelar:** descarta a criação de tarefa caso queira apenas seguir para outro assunto.

> [!TIP]
>
> Se o card de refinamento aparecer e você simplesmente digitar uma nova mensagem continuando a discussão, o assistente entende automaticamente que você quer seguir refinando a ideia.

***

## Segurança, Confirmações e Permissões

### Controle Antes de Ações Críticas

Consultas, movimentações, criação e edição acontecem diretamente para manter sua produtividade. Já ações destrutivas ou de arquivamento exibem um **card de confirmação** onde nada muda até você clicar em **Confirmar**:

| Ação | Comportamento | Detalhes Exibidos no Card |
| - | - | - |
| **Excluir tarefa** | **Exige confirmação** | Código, título e projeto da tarefa com alerta de exclusão permanente |
| **Arquivar documento** | **Exige confirmação** | Título e identificador do documento antes de ocultá-lo das listas ativas |
| **Demais ações** | **Execução direta** | Card visual do resultado logo após concluir |

### Permissões por Papel de Usuário

O assistente segue exatamente as mesmas regras de acesso do restante da plataforma:

| Papel no Workspace | O Que Pode Fazer no Chat |
| - | - |
| **Owner, Super Admin, Member e Guest** | Consultar dados, criar/editar/mover tarefas, gerenciar checklists e comentários, planejar sprints e operar documentos acessíveis |
| **Client** | Consultar informações e comentar nas tarefas a que tem acesso; não pode criar, editar, mover ou excluir tarefas nem documentos pelo chat |

### Proteção dos Dados

* **Privacidade das conversas:** seu histórico de chat é individual — outros membros da empresa não veem suas conversas.
* **Isolamento por empresa:** todas as buscas e alterações operam exclusivamente dentro do seu workspace.
* **Filtro de segurança e escopo:** mensagens vazias, acima de **4.000 caracteres**, fora do contexto de trabalho/gestão ou com tentativas de burlar regras de segurança são bloqueadas automaticamente com aviso explicativo.

***

## Gerenciamento de Conversas

* **Múltiplas conversas:** crie conversas separadas com **Nova conversa** para organizar temas diferentes (ex.: planejamento da sprint, triagem de bugs, documentação).
* **Título automático:** na primeira mensagem enviada, o título `"Nova conversa"` é substituído automaticamente por um resumo da sua mensagem (até 60 caracteres).
* **Rascunhos preservados:** o texto digitado fica salvo localmente por conversa ao alternar entre conversas ou fechar o painel lateral.
* **Exclusão:** quando houver mais de uma conversa, você pode remover conversas antigas pelo ícone de lixeira.

***

## Dicas para Melhores Resultados

### 1. Dê Referências Claras

**Menos preciso:**

> "Atualiza aquela tarefa do login"

**Melhor:**

> "Mova a tarefa SYN-42 para Aguardando Revisão e comente que os testes unitários foram corrigidos."

### 2. Aproveite as Sugestões Iniciais

Em conversas novas, clique nos comandos prontos na tela inicial para ver como o assistente estrutura tabelas, resumos de capacidade e cards de tarefas no seu workspace.

### 3. Divida Pedidos Muito Grandes

Para alterações em massa (como criar ou reorganizar dezenas de tarefas de uma vez), faça por partes — por exemplo, por módulo ou por projeto — para manter as respostas rápidas e fáceis de conferir.

***

## Limites Conhecidos

* **Tamanho máximo da mensagem:** até **4.000 caracteres** por envio.
* **Ações encadeadas por mensagem:** o assistente realiza até **3 etapas de consulta/ação** em uma única resposta (ex.: buscar tarefa → conferir detalhes → mover coluna).
* **Volume por consulta:** buscas unificadas no workspace retornam até **15 tarefas**, **8 documentos** e **8 projetos** por pesquisa.
* **Sem envio de anexos no chat:** o campo de mensagem aceita texto e Markdown, sem upload direto de arquivos ou imagens na conversa.
* **Sem cota fixa de mensagens:** não há limite mensal de mensagens no chat dentro do Synkrony (sujeito apenas a possuir assinatura paga ativa ou créditos na chave de API própria).

***

## ❓ FAQ

**Qual a diferença entre o Assistente IA e o Kanbino?**
O **Assistente IA** ajuda a gerenciar o trabalho dentro do Synkrony (buscar tarefas, mover cards, atualizar checklists, comentários, documentos e analisar capacidade de sprint). O **Kanbino** trabalha diretamente no repositório GitHub para planejar e escrever código em Pull Requests.

**Meus colegas de equipe conseguem ver minhas conversas no chat?**
Não. Cada conversa é privada entre você e o assistente.

**O Assistente IA pode apagar uma tarefa por acidente?**
Não. A exclusão de tarefas e o arquivamento de documentos sempre interrompem o fluxo e pedem confirmação manual no card antes de executar.

**Por que o chat aparece em "Modo somente leitura"?**
Isso acontece quando o workspace está no plano gratuito sem assinatura ativa e sem uma chave própria compatível (`Anthropic` ou `Z.ai`) configurada. Veja [Como Desbloquear o Envio de Mensagens](#como-desbloquear-o-envio-de-mensagens).

**O uso do Assistente IA consome execuções do Modo IA (Kanbino)?**
Não. Conversar e gerenciar tarefas pelo Assistente IA não consome créditos mensais de execução de código do Kanbino.

***

## Troubleshooting

### Não encontro o Assistente IA no Kanban ou em `/chat`

Verifique com um administrador se os recursos de IA estão habilitados no workspace. No **desktop**, o botão flutuante aparece nas telas do **Kanban**; no **mobile**, acesse diretamente pela rota **`/chat`** ou pelo item **Chat IA** no menu lateral.

### Minha mensagem apareceu como bloqueada pela validação

Isso ocorre quando a mensagem ultrapassa **4.000 caracteres**, foge do tema de gestão do workspace ou aciona alguma regra de proteção. Reformule o pedido focando em tarefas, projetos, sprints, documentos ou planejamento da sua empresa.

### Aparece "Serviço temporariamente indisponível"

Pode ocorrer por instabilidade momentânea no provedor de IA ou se a chave própria configurada em **Configurações → Kanbino IA** estiver inválida ou sem saldo. Aguarde alguns instantes e tente novamente, ou revise a chave ativa nas configurações.

### O assistente informa que não tenho permissão para alterar tarefas

Confira o papel da sua conta no workspace: contas com papel **`client`** podem fazer consultas e comentários nas tarefas permitidas, mas não possuem permissão para criar, editar, mover ou excluir tarefas e documentos via chat.

***

## Documentação Relacionada

* [Modo AI](https://docs.synkrony.ai/ai-mode.md) — Como delegar implementação de código ao Kanbino
* [Kanbino - Agente de IA](https://docs.synkrony.ai/kanbino.md) — Arquitetura e funcionamento do agente executor de código
* [Model Context Protocol (MCP)](https://docs.synkrony.ai/model-context-protocol.md) — Conecte assistentes externos (Claude Code, Cursor, Windsurf) ao Synkrony
* [Tarefas](https://docs.synkrony.ai/tarefas.md) — Estrutura de tarefas, épicos, etiquetas e estimativas
* [Sprints](https://docs.synkrony.ai/sprints.md) — Ciclos de trabalho e capacidade
* [Documentos](https://docs.synkrony.ai/documentos.md) — Gestão de textos, arquivos e versões


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.