Buscar na documentação

Companheiros

Adicione agentes de IA que trabalham nas tarefas dos seus quadros: escolha uma função, coleções e apps, atribua uma tarefa e revise a entrega.

O que é um companheiro

Um companheiro é um agente de IA que trabalha nas tarefas atribuídas a ele nos seus quadros. Cada tarefa ganha sua própria execução em um computador temporário. Quando a execução termina, o companheiro anexa o resultado ao cartão e o move para Revisão, nunca para Concluído: você decide se o trabalho é aceito.

Companheiros estão disponíveis nos planos pagos e durante o teste. Para começar o teste, escolha um plano: é preciso um cartão no checkout, e nada é cobrado até o teste terminar. Quem se cadastra a partir de um plano na página de preços vai direto para o checkout. Seus companheiros e a Emi ficam prontos logo depois do checkout, em cerca de um minuto.

O Ember inclui 3 companheiros e o Campfire 10; veja Preços. Companheiros não ocupam uma das suas vagas de Perfil. Quando o limite é atingido, exclua um companheiro ou desligue o perfil dele, ou faça upgrade em Configurações → Uso e faturamento.

Adicione um companheiro

  1. Abra Perfis e fique na aba Companheiros.
  2. Escolha uma função pronta e clique em Adicionar ao time. Cada função vem com conhecimento do trabalho, um modelo padrão, limites de execução e apps sugeridos. Veja todas as funções prontas.
  3. Ou escolha Novo companheiro para começar sem uma função pronta. Uma função personalizada aparece abaixo do nome do companheiro e começa com o modelo e os limites padrão.
  4. Dê um nome, escolha as coleções em que ele trabalha e clique em Criar e ativar.

Para parar um companheiro por um tempo, escolha Pausar na aba Companheiro dele. Execuções em andamento param, as da fila são canceladas, e as tarefas atribuídas esperam até você escolher Retomar.

Escolha as coleções em que ele trabalha

Em Trabalha em, escolha uma ou mais coleções. O companheiro pega tarefas nos quadros delas e pode ler tudo o que há nelas, inclusive arquivos adicionados depois.

Na aba Companheiro, O que ele pode ler enquanto trabalha restringe cada execução. Só a coleção da própria tarefa é o recomendado: uma execução nunca vê arquivos de outro cliente. Escolha Todas as coleções em que ele trabalha só quando o trabalho precisar de mais.

Dê apps a ele

Apps permitem que um companheiro trabalhe em ferramentas como Google Docs, Planilhas, Drive ou DataForSEO com as suas próprias contas. Uma função pronta lista os apps com que trabalha; são sugestões, e o companheiro pode começar sem eles, a menos que a função precise de um.

  1. Abra Apps na barra lateral, escolha o app e clique em Conectar conta. Dê à conta um nome que você reconheça, como o nome do cliente, e faça login. As contas pertencem ao workspace, e você pode conectar várias para o mesmo app. Docs, Planilhas e Drive precisam cada um do seu próprio login, mesmo com a mesma conta Google.
  2. Escolha qual conta cada coleção usa. Um app que lê dados públicos, como o DataForSEO, pode usar uma conta em todas as coleções.
  3. Ative o app para o companheiro em Apps na aba Companheiro.

Em apps com arquivos de clientes, uma coleção pode limitar o que os companheiros abrem: cole as pastas do Drive, documentos, planilhas ou sites que ela pode usar. Uma pasta do Drive cobre os arquivos que estão direto nela, não as subpastas. Quando uma dessas contas é usada por mais de uma coleção, todas elas precisam de um limite. Com uma única coleção e nada adicionado, os companheiros podem abrir tudo o que a conta vê.

Busca na web e leitura de páginas são ferramentas do Takibi e não precisam de conexão. Se uma execução precisa de um app para o qual a coleção não tem conta, ela pausa antes de começar e diz qual é o app. Escolha uma conta na página Apps e mova o cartão de volta para A fazer.

Atribua uma tarefa

Crie um cartão em um quadro de uma das coleções do companheiro e atribua-o ao companheiro. Descreva o resultado que você quer e como vai conferir; o cartão é a base do trabalho. Você também pode pedir à Emi que proponha as tarefas e quem deve fazê-las; nada muda até você aprovar.

Cada tarefa atribuída inicia uma execução. Um companheiro pausado guarda as tarefas até você retomá-lo.

Acompanhe uma execução

Uma execução lê o cartão, os documentos da coleção e os apps que você deu ao companheiro, e então faz o trabalho. Abra a aba Companheiro para ver Execuções recentes com estado, duração, passos e custo. Abra uma execução para ver a linha do tempo, por que ela parou e o que escreveu no cartão.

Se o companheiro precisa da sua resposta ou do seu OK, ele pergunta no cartão. A tarefa mostra Precisa de você e aparece na sua caixa de entrada e no Chat. Responda ali para reiniciar a tarefa. Se o computador que roda a execução se perder, ela é repetida uma vez automaticamente.

Revise o resultado

Uma execução concluída anexa o resultado ao cartão e o move para Revisão com uma nota de entrega que resume o que foi feito. Abra o cartão, confira o resultado e então:

  • Aceitar para registrar que o trabalho foi aprovado.
  • Rejeitar no quadro, ou Devolver no Chat, com uma nota sobre o que deve mudar. O cartão volta para A fazer com a sua nota, e o companheiro começa uma nova execução.

Veja Revise e aceite o resultado para saber como os cartões aceitos seguem.

Quando uma execução para ou falha

O cartão mostra a última execução do companheiro, e os detalhes da execução dizem por que ela parou e o que fazer. Escolha Tentar de novo no cartão, ou mova-o de volta para A fazer, e o companheiro começa de novo. Resolva a causa antes:

  • A execução falhou. A nota do cartão diz o que deu errado.
  • Uma conta de app foi desconectada ou precisa de login de novo. Reconecte-a na página Apps; as coleções continuam usando a conta com os mesmos limites. Reconectar pelo Chat reinicia a tarefa para você.
  • Sua chave da OpenRouter foi recusada. Troque-a em Configurações → Uso e faturamento.

Você também pode pedir à Emi que reinicie uma tarefa parada.

Limites por execução e por dia

Toda execução tem um limite de passos e um limite de gasto, definidos pela função ou pelos padrões. Uma execução que atinge qualquer um deles para, anexa suas últimas notas ao cartão como trabalho inacabado, e a tarefa mostra Precisa de você. Divida o trabalho em tarefas menores ou devolva com um pedido mais específico.

Seu plano também define quantas execuções podem começar por dia, mostrado em Execuções por dia em Configurações → Companheiros. As que passam disso esperam até 00:00 UTC. Execuções na sua própria chave da OpenRouter têm um limite mensal, mostrado em Configurações → Uso e faturamento.

Escolha um modelo e quem paga

Escolha o modelo na aba Companheiro. O modelo decide quem paga:

  • Modelos incluídos usam o uso de IA incluído do seu plano, mesmo que você tenha adicionado uma chave.
  • Qualquer outro modelo do catálogo da OpenRouter que usa ferramentas precisa da sua própria chave da OpenRouter e é cobrado na sua conta da OpenRouter.

Adicione a chave em Configurações → Uso e faturamento. Use uma chave dedicada com limite de crédito. Uma execução mantém quem paga desde o início, inclusive quando é repetida. Se você remover a chave, companheiros em outros modelos passam para um modelo incluído.

Quando o uso incluído acaba, novas execuções pausam até ele renovar. Para continuar, ative Quando meu uso incluído acabar, iniciar novas execuções na minha chave em Configurações → Uso e faturamento.

Modelos incluídos vão só para endpoints que a OpenRouter lista como de retenção zero de dados. Com sua própria chave, as configurações da sua conta OpenRouter decidem o roteamento; veja Privacidade.