Um conector é apenas uma ferramenta que o Okou pode pegar e usar em seu nome. Slack, Notion, Gmail, GitHub, Linear, Stripe — depois que você conecta um deles, o Okou para de falar sobre o seu trabalho e começa a fazê-lo.
Digamos que você peça ao Okou: "Rascunhe o anúncio de lançamento no Notion e coloque o link em #marketing." Com Notion e Slack conectados, isso deixa de ser hipotético. O Okou abre o Notion, cria a página, escreve o rascunho e então o publica no Slack — do mesmo jeito que você faria, só que mais rápido.
Como a conexão funciona
O Okou pode solicitar um conector enquanto está trabalhando, ou você pode abrir Conectores a partir do espaço de trabalho e configurá-lo antes. Há duas decisões separadas envolvidas:
- Conectar vincula ou habilita a conta do membro atual para esse serviço. OAuth e credenciais inseridas manualmente pertencem a esse membro, a menos que o conector diga explicitamente o contrário.
- Autorizar e conceder permissões controla se o Okou pode usar a conexão e quais ações nomeadas são permitidas. Em My Okou, siga o fluxo de conta e permissões mostrado; não é necessária a seleção de nenhum agente especializado. Em Agentes legados, autorize o agente que precisa da conexão. Uma conexão não concede todas as ações.
Um card inline pode orientá-lo pelas duas etapas. Depois que a conexão for concluída, revise as ações solicitadas e escolha uma duração de acesso. O Okou pode então continuar a tarefa dentro desse acesso.
Não presuma que a conexão de um colega lhe dê acesso à conta dele. Cada membro conecta a própria conta quando o serviço usa credenciais por membro.
Lista de verificação da primeira conexão
- Abra Conectores, use Descobrir e pesquise o serviço (interfaces mais antigas podem usar Integrado).
- Selecione Conectar e conclua o fluxo de login ou de credenciais do provedor.
- My Okou: revise a conta pretendida. Agentes legados: escolha o agente que precisa do conector.
- Revise as permissões solicitadas e escolha Permitir por 1h, Permitir por 24h, Permitir por 7d ou Permitir sempre, conforme apropriado.
- Volte ao chat original e tente novamente somente se a execução não tiver sido retomada.
Se a conta estiver conectada, mas uma tarefa ainda estiver bloqueada, verifique o acesso à conta aplicável, a autorização e a permissão específica negada. O status da conexão sozinho não prova que a ação solicitada é permitida.
Uma amostra do que o Okou pode fazer
Alguns exemplos de como os conectores se traduzem em trabalho real:
- Notion — criar páginas, atualizar bancos de dados, arquivar notas de reunião, redigir propostas, pesquisar em todo o seu espaço de trabalho.
- Slack — enviar DMs, publicar em canais, resumir threads longas, acompanhar conversas paradas.
- Gmail — ler sua caixa de entrada, destacar o que realmente precisa da sua atenção hoje e preparar respostas como rascunhos na sua conta. O Okou escreve o rascunho; você aperta enviar.
- GitHub — abrir issues, comentar em PRs, triagem do backlog, redigir notas de release.
- Linear — abrir tickets, mover tarefas entre status, gerar resumos de sprint.
- Stripe, HubSpot, Calendar, Drive, Sheets, Docs… — a mesma ideia, na ferramenta onde quer que o trabalho esteja.
Você nunca precisa explicar como uma ferramenta funciona. O Okou já sabe. Você descreve o resultado; ele cuida dos cliques.
Você escolhe o que o Okou pode fazer
Autorizar uma ferramenta não é tudo ou nada. Para cada conector, você escolhe quais ações o Okou tem permissão para executar — e pode ajustar essas escolhas para mais ou para menos a qualquer momento em Conectores; em Agentes legados, use também as configurações de Autorização do agente.
Exemplo em Agentes legados:
Alguns exemplos de como as equipes definem o escopo:
- Gmail — permita que o Okou leia sua caixa de entrada e redija respostas, mas nunca envie nada em seu nome.
- Slack — permita que o Okou leia canais e resuma threads, mas bloqueie publicações em seu nome.
- GitHub — permita que o Okou abra issues e comente em PRs, mas negue qualquer coisa destrutiva, como force-push ou exclusão de branches.
- Linear — permita que o Okou crie e atualize tickets, mas não os conclua nem exclua.
- Notion — permita que o Okou leia páginas e adicione comentários, mas bloqueie atualizações destrutivas em bancos de dados.
O acesso é aplicado por meio de permissões nomeadas do conector. Se o Okou precisar de uma permissão que não esteja permitida no momento, ele a solicita separadamente. Revise a ação nomeada, o escopo e a duração da solicitação; use a atividade do Chat para verificar o que foi executado. Controles adicionais de conta do Chat podem estar disponíveis independentemente de My Okou. Não presuma que uma permissão aprovada em um Chat se aplica apenas ali; veja Permissões.
Integrados e personalizados
Os conectores integrados são mantidos pelo Okou e aparecem na aba Integrado. O seletor de conectores ativo no seu espaço de trabalho é o catálogo autoritativo, porque a disponibilidade pode mudar à medida que conectores são adicionados ou configurados.
Se o serviço não estiver listado, um administrador da organização pode registrar um conector personalizado. Um conector personalizado define o destino HTTPS permitido e como as credenciais são injetadas. Os membros então conectam a própria credencial e concedem o acesso de que a tarefa precisa. Agentes legados também exigem a autorização do agente relevante.
Uma observação sobre acesso
As credenciais são armazenadas na plataforma e injetadas em solicitações de saída correspondentes na borda da rede; elas não são expostas ao código do agente como variáveis de ambiente. As permissões do conector são separadas da credencial e podem ser negadas ou limitadas por tempo.
Desconectar a conexão de um membro remove essa credencial de execuções futuras. Em Agentes legados, remover uma autorização de um agente não altera os outros agentes autorizados. Onde os controles de conta do Chat estiverem disponíveis, remover uma permissão do Chat é diferente de desconectar a conta salva.
Veja Permissões para o modelo completo de acesso.
Próximos passos
- Catálogo — todas as ferramentas que o Okou oferece nativamente.
- Conectores personalizados — adicione qualquer outra coisa.
