Voltar para a documentaçãoConceitos principais

Agentes

Trabalhadores de IA em forma de colega — nome, papel, fluxos de trabalho, conectores e personalidade.

Última atualização em 21 de agosto de 2026 · 6 min read

Um agente é uma IA em forma de colega que vive no seu espaço de trabalho. Tem um nome, um papel, uma personalidade, um conjunto de fluxos de trabalho em que é bom e um conjunto de conectores que consegue alcançar. Você fala com ele do mesmo jeito que falaria com um colega.

O Okou é o agente padrão que vem com a Okou — o generalista que dá conta de pedidos avulsos, rascunhos, briefings e da maior parte do trabalho do dia a dia. A maioria dos espaços começa só com o Okou. Conforme o uso cresce, você molda outros agentes em torno de tarefas específicas.

Por que agentes e não um assistente gigante

Um único assistente que "faz tudo" é difícil de raciocinar. Você não sabe o que ele sabe, no que consegue mexer, nem como vai se comportar no próximo pedido. Os agentes resolvem isso sendo especialistas com formato estável:

  • Uma tarefa clara. Cada agente tem um nome e uma descrição de uma linha do que ele serve. "A Lisa rascunha e envia respostas a clientes." "O Tim cuida das varreduras semanais de concorrentes."
  • Um conjunto focado de fluxos de trabalho. Os agentes carregam apenas os fluxos relevantes para a sua tarefa, então o comportamento é previsível. Eles não vão de repente começar a escrever código se a função deles é contabilidade.
  • Seus próprios conectores. Cada agente tem as próprias permissões. O seu agente de finanças pode mexer no Stripe; o de marketing, não.
  • Uma personalidade. Tom, voz e padrões são definidos uma vez no agente e valem para tudo o que ele faz.

Como você interage com os agentes

O formato de "falar com um agente" depende do canal:

  • Web chat — escolha o agente na barra lateral. Cada agente tem o próprio histórico.
  • Slack@mencione o Okou. O Slack só roteia para o Okou; para passar o trabalho a outro agente, troque de agente pelos controles na resposta do Okou e siga na mesma thread.
  • Automações — toda automação indica o agente que a executa, então o certo está de plantão na hora certa.

Se você não escolher um agente, o Okou cuida do pedido.

Os agentes são isolados

Cada agente corre sozinho. Os agentes no mesmo espaço de trabalho conseguem ver-se uns aos outros na lista — nomes, tarefas, quem está de serviço — mas não têm memória partilhada e não conseguem chamar-se uns aos outros no meio de uma execução. Cada chat pertence a exatamente um agente, e esse agente faz o trabalho de ponta a ponta.

Duas coisas atravessam essa fronteira, e é você quem as inicia:

  • Referenciar outro thread. Digite @ no composer para trazer um thread de chat anterior — de qualquer um dos seus agentes — para a conversa atual como contexto. O agente atual lê o que você entregou. Ele não herda os conectores nem as permissões do outro agente.
  • Encadear após uma execução concluída. Uma automação do tipo execução de chat concluída pode vigiar um dos seus threads e iniciar um fluxo de trabalho quando uma execução termina ali, opcionalmente filtrando por status ou pelo que a resposta final dizia. É um gatilho que você configura, não um agente decidindo chamar outro agente.

Isso é de propósito:

  • Comportamento previsível. Um chat com a Lisa continua sendo um chat com a Lisa. Você sempre sabe de quem são a voz, os fluxos de trabalho e as permissões em jogo.
  • Permissões previsíveis. Um conector concedido ao seu agente de finanças não vaza para o de marketing. Não existe cadeia de "a Lisa pede ao Tim que pede ao Okou" que amplie o raio de ação em silêncio.
  • Custo previsível. Cada crédito é atribuído ao agente que executou o chat. Sem tráfego escondido entre agentes.

Quando um fluxo de trabalho abrange vários tipos de trabalho, você o compõe com pessoas, automações ou o mesmo agente carregando fluxos diferentes — não com agentes chamando uns aos outros.

Criar um agente

Abra a página Agentes no seu espaço de trabalho e clique em Criar em Público (visível para todo o time) ou Privado (só para você). Você começa com um nome e um avatar.

Todos os planos, Free incluído, permitem até 7 agentes compartilhados com a organização e um número ilimitado de privados — então o limite só vale para o que você publica para o espaço inteiro.

Modal de criação de um novo agente

Assim que o agente existir, abra o perfil dele e preencha o resto — descrição, voz, instruções e os conectores em que pode mexer:

Aba de perfil do agente com nome, descrição e ajustes de voz

  • Descrição. Uma frase sobre no que este agente ajuda. Quanto mais clara, melhor o agente se comporta e mais fácil fica para o time escolher o certo.
  • Como ele soa. Escolha um preset de tom (Profissional, Amigável, Direto, Acolhedor) ou sobrescreva na aba Instruções.
  • Instruções. Idioma padrão, tamanho padrão de resposta e quaisquer traços de persona ficam na aba Instruções.
  • Conectores. Conceda acesso às ferramentas de que este agente precisa pela aba Autorização. O padrão é somente leitura.

A maioria dos times ajusta essas configurações nas primeiras semanas. O comportamento do agente vai apertando conforme você observa o que ele faz e refina a descrição.

Agentes e fluxos de trabalho

Fluxos de trabalho são reutilizáveis; agentes são quem os executa. O mesmo fluxo — digamos, weekly-metrics — pode ser atribuído a dois agentes diferentes e produzir resultados diferentes, porque cada agente traz o próprio tom, os próprios padrões e as próprias permissões de conector.

Um padrão comum:

  • Agentes generalistas (Okou) carregam um catálogo amplo de fluxos e escolhem conforme a situação.
  • Agentes especialistas (Lisa, Tim) carregam um conjunto estreito e o aplicam de forma consistente.

Veja Fluxos de trabalho para saber como escrever e compartilhar procedimentos entre agentes.

Agentes e permissões

Cada agente tem as próprias permissões. Um conector ligado no nível do espaço de trabalho não fica automaticamente disponível para todos os agentes — você escolhe quais agentes podem usá-lo pela aba Autorização do agente. Isso significa:

  • Um agente júnior não consegue mexer sem querer em sistemas de produção.
  • Um agente voltado ao cliente pode publicar no #cs-replies do Slack, mas não no #exec-strategy.
  • Um agente de finanças pode ler o Stripe, mas só o diretor financeiro pode lhe dar permissão de escrita.

Quando um agente tenta algo fora das suas permissões, a ação é negada e registrada.

O que vem a seguir

  • Levante um agente especialista para trabalho recorrente — veja Fluxos de trabalho para os blocos de construção.
  • Coloque um agente atrás de uma automação para que ele rode sem ninguém pedir.
  • Veja Permissões para o controle fino do que cada agente pode tocar.