Agentes

Um agente é uma IA em formato de colega de equipe que vive no seu espaço de trabalho. Ele tem nome, papel, personalidade, um conjunto de workflows 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 o Okou — o generalista que cuida de pedidos avulsos, rascunhos, briefings e da maior parte do trabalho do dia a dia. A maioria dos espaços de trabalho começa só com o Okou. Conforme o uso cresce, você pode moldar agentes adicionais em torno de funções específicas.

Por que agentes, e não um assistente gigante

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

• Uma função clara. Cada agente tem um nome e uma descrição de uma linha sobre para que serve. "A Lisa escreve e envia respostas a clientes." "O Tim cuida das varreduras semanais de concorrentes."
• Um conjunto enxuto de workflows. Agentes carregam apenas os workflows relevantes à sua função, então o comportamento deles é previsível. Eles não começam de repente a escrever código se a função é contabilidade.
• Conectores próprios. Cada agente tem as próprias concessões de permissão. Seu agente de finanças pode tocar o 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:

• Chat web — escolha o agente na barra lateral. Cada agente tem o próprio histórico de chat.
• Slack — mencione o Okou com @. O Slack só roteia para o Okou; para passar o trabalho a outro agente, troque de agente pelos controles da resposta do Okou e continue na mesma thread.
• Automações — toda automação nomeia 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.

Agentes são isolados

Cada agente roda sozinho. Agentes do mesmo espaço de trabalho se veem na lista — nomes, funções, quem está de plantão — mas não têm memória compartilhada nem conseguem chamar uns aos outros no meio de uma execução. Cada chat pertence a exatamente um agente, e é ele que faz o trabalho de ponta a ponta.

Duas coisas atravessam essa fronteira, e as duas partem de você:

• Referenciar outra thread. Digite @ no campo de chat para puxar uma thread 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 a partir de uma execução concluída. Uma automação chat run finished pode observar uma das suas threads e iniciar um workflow quando uma execução termina ali, opcionalmente filtrada por status ou pelo que a resposta final disse. Isso é um gatilho que você configura, não um agente decidindo chamar outro.

Isso é de propósito:

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

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

Criando um agente

Abra a página Agents no seu espaço de trabalho e clique em New agent. Dê um nome e defina a Visibility: Public (qualquer pessoa deste espaço pode usar) ou Private (só você vê e usa). O avatar pode ser personalizado no mesmo diálogo.

Todos os planos, incluindo o Free, permitem até 7 agentes compartilhados na organização e um número ilimitado de privados — ou seja, o limite só vale para o que você publica para todo o espaço de trabalho.

Com o agente criado, abra o perfil dele e preencha o resto — descrição, voz, instruções e os conectores que ele pode tocar:

• Descrição. Uma frase sobre no que este agente ajuda. Quanto mais clara, melhor o agente se comporta e mais fácil fica para os colegas escolherem o certo.
• Como ele soa. Escolha um preset de tom (Professional, Friendly, Direct, Supportive) ou sobrescreva na aba Instructions.
• Instruções. Idioma padrão, tamanho padrão da resposta e manias da persona ficam na aba Instructions.
• Conectores. Conceda acesso às ferramentas de que este agente precisa pela aba Authorization. O padrão é somente leitura.

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

Agentes e workflows

Workflows são reutilizáveis; agentes são quem os executa. O mesmo workflow — 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 concessões de conector.

Um padrão comum:

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

Veja Workflows para escrever e compartilhar procedimentos entre agentes.

Agentes e permissões

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

• Um agente júnior não consegue tocar sistemas de produção por acidente.
• Um agente voltado ao cliente pode postar no Slack #cs-replies mas não em #exec-strategy.
• Um agente de finanças pode ler o Stripe, mas só o CFO pode dar acesso de escrita a ele.

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

O que vem a seguir

• Monte um agente especialista para trabalho recorrente — veja Workflows para as peças básicas.
• Coloque um agente atrás de uma automação para que ele rode sem ninguém pedir.
• Veja Permissions para o controle fino do que cada agente pode tocar.