Conectores
Conectores permitem ligar serviços externos ao Giorgio quando uma tarefa precisa desse contexto.
Conectar um serviço
- Escolha o conector disponível.
- Revise a finalidade e permissões apresentadas.
- Conclua a autorização exigida pelo serviço.
- Confirme o estado conectado antes de depender dele.
Desconectar
Quando uma integração não for mais necessária, use o controle de desconexão correspondente. A disponibilidade e o fluxo exato dependem do conector mostrado no catálogo.
Permissão antes de conveniência
Conectores dão acesso a serviços externos e por isso devem tornar escopo e autorização explícitos antes de agir.
- O fluxo certo mostra o que será lido ou alterado e não confunde conexão disponível com permissão para executar qualquer ação.
Leitura operacional
Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Conectores, onde o contexto pode atravessar mais de uma etapa.
Comece por “Conectar um serviço”, confirme o estado visível e avance para “Desconectar” apenas quando a etapa anterior estiver estável. Em Conectores, pular contexto costuma gerar mais retrabalho do que velocidade.
No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
- revise a saída no mesmo ambiente em que ela será usada
- confirme o estado antes de iniciar a próxima ação
Do primeiro clique à entrega
Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Conectores realmente exigir mais contexto, controle ou verificação.
Imagine uma tarefa real em que Conectores deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.
Limites e exceções
Use Conectores como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Conectores permitem ligar serviços externos ao Giorgio quando uma tarefa precisa desse contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
- confirme o estado antes de iniciar a próxima ação
- mantenha arquivos, sessão e contexto ligados ao mesmo objetivo
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
Checklist de uso
Comece por “Conectar um serviço”, confirme o estado visível e avance para “Desconectar” apenas quando a etapa anterior estiver estável. Em Conectores, pular contexto costuma gerar mais retrabalho do que velocidade.
Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Conectores, onde o contexto pode atravessar mais de uma etapa.
Guia de verificação: Conectores
Nesta página, a referência completa cobre OAuth, escopos, leitura, escrita e fronteiras de autorização. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.
- confirme o estado inicial antes de executar a ação
- identifique quais dados ou arquivos a superfície realmente possui
- trate loading, vazio, erro, retry e reentrada como comportamento principal
- verifique o resultado no mesmo contrato que o usuário consegue observar
Casos de borda de Conectores
A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.
