Ottermind DocsOttermind

Capacidades principais

Agents

Papéis de trabalho configuráveis que combinam modelo, limites de comportamento e Skills.

O que é

Os Ottermind Agents são executores inteligentes de tarefas que recebem instruções do usuário e concluem o trabalho com base no modelo, no Role e nas Skills configurados. Pense em um Agent como um papel de trabalho configurável. Ao configurar Agents, você define modelos adequados, limites de comportamento e Skills disponíveis para diferentes tarefas, tornando a execução mais estável e mais próxima do esperado.

Com Agents, você pode

  • Dividir o trabalho criando diferentes Agents para diferentes tarefas.
  • Controlar o comportamento com Role.
  • Ampliar capacidades por meio de Skills.
  • Gerenciar modelos, descrições e Skills vinculadas, além de editar, duplicar ou excluir Agents.

Os Agents são adequados para reutilização de longo prazo e responsabilidades claramente definidas. Não são adequados para tarefas pontuais, muito simples, ou tarefas com permissões e escopo de dados pouco claros.

Gerencie seus agents

Na barra lateral esquerda do Ottermind, selecione Agents para ver os Agents do workspace atual. Cada cartão mostra o nome do Agent, a descrição, o modelo padrão, as Skills vinculadas e as ações disponíveis.

CampoSignificado
defaultO Agent padrão do sistema.
Default ModelO modelo usado por este Agent por padrão.
SkillsPacotes de capacidade disponíveis para este Agent.
Start TaskIniciar uma nova tarefa com este Agent.

Crie um agent

Clique em New Agent para criar um Agent. Preencha Name, Description, Default model e Role e, em seguida, adicione Skills conforme necessário.

CampoRequisito
NameObrigatório. Usado para identificar o Agent.
DescriptionUma breve descrição do cenário aplicável.
Default modelObrigatório. Afeta velocidade, custo e limites de capacidade.
RoleExplica quem é o Agent, como ele deve trabalhar e quais são seus limites.
SkillsOpcional. Determina quais capacidades o Agent pode usar.

Depois de salvar, o novo Agent aparecerá na lista de Agents.

Escolha um modelo padrão

Em Default model, escolha o modelo usado por padrão pelo Agent. O modelo afeta a velocidade, o custo e os limites de capacidade da tarefa. Os modelos disponíveis e suas descrições podem mudar — use a interface atual como fonte da verdade.

Adicione ou remova skills

Na seção Skills da página de edição do Agent, clique em + e, em seguida, pesquise e selecione as Skills a vincular. Depois de vinculadas, o Agent decidirá automaticamente se deve usar essas Skills durante as tarefas.

Depois de remover uma Skill, o Agent não poderá mais usar essa capacidade. Se a tarefa depender dessa Skill, o resultado pode ficar incompleto ou falhar.

Edite um agent

Clique no Agent ou abra o menu no canto inferior direito do cartão do Agent e escolha Edit. Você pode alterar o nome, a descrição, o modelo padrão, o Role e as Skills. Clique em Save para aplicar as alterações.

Notas de uso

O Role deve definir responsabilidades e limites

O Role explica as responsabilidades, o estilo de trabalho e os limites do Agent. Não escreva apenas uma persona genérica.

Bom

Você é um assistente de documentação de produto. Priorize instruções de uso concisas e verificáveis e não invente funcionalidades não confirmadas.

Ruim

Você é o assistente mais poderoso e pode fazer qualquer coisa.

As Skills definem as capacidades disponíveis

Um Agent só pode usar Skills que estejam ao mesmo tempo vinculadas e habilitadas. Vincular Skills demais pode aumentar o risco de uso indevido; vincular Skills de menos pode impedir que o Agent conclua tarefas específicas.

Permissões e segurança de dados

Um Agent pode acessar arquivos, chamar serviços externos ou executar ações por meio das Skills vinculadas. Não vincule Skills de alta permissão a Agents que não precisam delas. Antes de lidar com dados sensíveis, confirme a origem dos dados, o escopo de acesso e os requisitos de conformidade.

FAQ

Por que meu Agent não usou uma determinada Skill?

A Skill pode não estar vinculada, pode estar desabilitada, a descrição da tarefa pode não corresponder ao cenário aplicável ou a entrada pode não atender aos requisitos.

Posso excluir o Agent padrão?

O Agent padrão é um Agent base do sistema. Em geral, não é recomendável excluí-lo ou modificá-lo profundamente. Se você precisar de capacidades especializadas, crie um novo Agent.

O que devo fazer se o resultado não for o esperado?

Verifique a descrição da tarefa, o Role, o Default model e as Skills vinculadas. Ao dar feedback, explique o que está errado, qual é o padrão correto e se você quer uma revisão ou uma nova execução.