Primeiros passos
Conectar Aplicações Externas aos Seus Agentes
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
O Que É uma Ligação
Uma ligação é um elo autenticado entre um dos seus especialistas e uma aplicação externa. Depois de ligado, esse especialista pode usar as ferramentas da aplicação numa conversa: ler um documento, redigir uma mensagem, verificar um registo. Sem uma ligação, o especialista não tem acesso nenhum.
Há duas coisas que vale a pena ser preciso:
- Uma ligação concede acesso a essa aplicação, não à sua conta Kapsule. Os dois conjuntos de permissões nunca se misturam.
- Qualquer coisa que altere algo na aplicação ligada continua a passar pelo mesmo cartão de confirmação que uma alteração na sua conta Kapsule. A leitura é imediata; a escrita pede permissão primeiro.
As ligações encontram-se em Agents, depois Manage Connections, ou vá diretamente para /agents/connections. A página inicial do Agents também mostra um cartão de Ligações com algumas aplicações de exemplo.
Que Especialistas Podem Usar Que Aplicações
A lista é deliberadamente conservadora, e cada especialista apenas vê as aplicações que o seu trabalho necessita. Algumas limitam-se a ferramentas de leitura apenas, mesmo quando a própria aplicação pode fazer mais:
| Especialista | Aplicações externas que pode aceder |
|---|---|
| Mara, Business Advisor | Stripe (leitura apenas) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (leitura apenas) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (leitura apenas) |
| Pip, Policy and Docs | Nenhuma |
Ligar uma aplicação não a coloca ao dispor de toda a equipa. Fica disponível apenas para os especialistas na linha acima.
Ligar uma Aplicação
- Abra Agents, depois Manage Connections.
- Navegue pelo separador Popular, mude para All Apps, ou escreva na caixa de pesquisa. Cada cartão mostra o nome da aplicação e quantas ferramentas expõe.
- Clique em Connect na aplicação que deseja. O botão muda para Opening... enquanto a janela de início de sessão é preparada.
- Inicie sessão na própria aplicação e aprove o acesso que solicita.
- Regressará à página de Ligações com uma confirmação [app] Connected.
Depois de ligada, o cartão mostra um distintivo Connected, a etiqueta da conta com a qual iniciou sessão, e quando a ligação foi utilizada pela última vez, ou Not used yet.
Estados da Ligação
| Estado | O que significa | O que fazer |
|---|---|---|
| Connected | Funciona. Os seus especialistas podem utilizá-la. | Nada |
| Pending | O início de sessão foi iniciado mas nunca foi concluído. | Clique em Finish Connecting |
| Reconnect Needed | O acesso expirou ou foi revogado do lado da aplicação. | Clique em Reconnect |
O estado Reconnect Needed é normal ao longo do tempo: a maioria das aplicações expira o acesso que concede num calendário. Religar restaura-o sem perder nada.
Como Isto Se Mantém Seguro
A página de Ligações apresenta o modelo de segurança em três linhas, e vale a pena compreender em vez de apenas dar uma vista de olhos:
- Processado por um parceiro certificado. O início de sessão numa aplicação é processado pelo nosso parceiro de integração certificado, que detém a autorização. A sua palavra-passe da aplicação nunca toca em Kapsule.
- Confirmação antes de agir. Os Agents pedem permissão antes de agir. Qualquer coisa que altere algo necessita da sua aprovação primeiro.
- Revogação instantânea. Desligar corta o acesso imediatamente, tanto aqui como junto à aplicação.
Trate uma ligação como uma chave que cortou para alguém. Ligue as contas em que deseja que os seus especialistas trabalhem, não todas as contas que possui. Se não tiver a certeza se um especialista necessita de uma aplicação para fazer o trabalho que tem em mente, não a ligue: pergunte primeiro, depois ligue.
Desligar uma Aplicação
- Abra Agents, depois Manage Connections.
- Clique em Disconnect na aplicação ligada.
- Uma confirmação aparece: A sua equipa perde acesso a [app] imediatamente. Qualquer coisa que já tenha utilizado permanece no seu histórico de conversas.
- Clique em Disconnect para confirmar.
O acesso termina imediatamente. O que isto não faz é remover o conteúdo da aplicação das conversas que já teve: se um especialista citou um documento numa conversa na semana passada, esse texto ainda está na transcrição da conversa. Desligar diz respeito ao acesso futuro, não à eliminação retroativa.
Quando as Ligações Não Estão Disponíveis na Sua Conta
Se a página de Ligações mostrar um único cartão calmo dizendo Connections Are Not Available Yet, a ligação de aplicações externas não foi ativada para a sua conta. O cartão deixa claro que nada está ligado e nada tem acesso, o que é exatamente a verdade nesse estado. Os seus especialistas continuam a trabalhar; apenas não conseguem alcançar fora de Kapsule.
O resto do Agents não é afectado. As conversas, Skills e leituras de conta funcionam normalmente.
E Se Falhar
"Permission was not granted, so nothing was connected." Cancelou ou recusou no ecrã de aprovação da própria aplicação. Nada foi criado. Clique em Connect novamente e aprove o acesso.
"Connections are unavailable right now. Try again in a moment." O serviço de integração não pôde ser acedido. Isto é deliberadamente seguro por defeito: em vez de mostrar uma lista parcialmente construída, a página não mostra nada. Aguarde um minuto e recarregue.
"Connections could not be loaded." As suas definições estão seguras. Atualize a página. Se persistir, abra um pedido de suporte.
Um especialista diz que não consegue aceder a uma aplicação ligada. Verifique a tabela acima. Nem todos os especialistas têm permissão para todas as aplicações, e uma aplicação ligada para Cora não está automaticamente disponível para Mara.
Uma ligação fica em Pending. A janela de início de sessão foi fechada antes de terminar. Clique em Finish Connecting e complete-a.
O Que as Ligações Custam
Utilizar uma aplicação ligada numa conversa é medido como qualquer outro trabalho. Cada chamada que um especialista faz a uma aplicação externa é cobrada com o peso de ligação, que é uma fração do que uma longa peça de escrita custa. As leituras na sua conta Kapsule permanecem gratuitas. A ponderação completa encontra-se em How Agent Credits Work.