Criar Agentes

O que são Agentes?

Agentes são entidades personalizáveis que utilizam informações contextuais para fornecer respostas e ações mais precisas e relevantes. Eles são projetados para resolver problemas específicos e melhorar a eficiência no desenvolvimento de software. Ao criar um, você pode:

• Definir Instruções do Agente.
• Configurar a base de Knowledge Source (incluindo regras e parâmetros para seu uso).
• Designá-los como Agentes de Conversação ou Agentes Sistemáticos.
• Utilizá-los dentro de Quick Commands.

Na StackSpot AI, os Agentes são como especialistas virtuais que podem ser ajustados para atender às suas necessidades específicas, aumentando assim a eficiência e a qualidade do ciclo de desenvolvimento de software.

Quando configurar um Agente na StackSpot AI, você é responsável por personalizar suas interações com a plataforma. Isso inclui modificar prompts do sistema e Knowledge Sources para aumentar a eficiência e facilitar o desenvolvimento.

Você tem a flexibilidade de criar Agentes especializados para diferentes tarefas, como:

• Um agente que gera user stories
• Agentes para criar código e conduzir QA no código gerado
• Um agente para criar documentação

Criar Agentes

Passo 1. Acesse o Portal da StackSpot AI e navegue até a seção ‘Contents > Agentes‘;

Passo 2. Clique no botão ‘Criar Agentes’;

Passo 3. Preencha as seguintes informações:

• Nome do Agente: forneça um nome para o seu Agente.

• Prompt do Sistema (System prompt): é aqui que você pode definir as instruções para o comportamento e habilidades do seu Agente. Por exemplo, o CodeBuddy tem um prompt de sistema específico.

  • O prompt dos Agentes tem um limite de 8,000 caracteres.

Informação Adicional

Ao realizar buscas por similaridade, a StackSpot AI foca no prompt do usuário (seja nos Quick Commands, na caixa de prompt, ou no chat). No entanto, os prompts do sistema dos Agentes não são considerados nessas buscas. Durante o processo do Agente, Knowledge Sources (KS) e Knowledge Objects (KO) serão utilizados somente quando o limite de similaridade configurado no Agente for atingido entre um KS/KO e o prompt do usuário.

• Comandos Sugeridos: esses comandos são frases ou perguntas que ajudam a pessoa usuária a começar conversas com o Agente.

• Modo Conversacional: quando ativado, o sistema permite interações contínuas e complexas, tornando-o ideal para conversas que envolvem múltiplas trocas de informações. Quando desativado, o sistema responde a uma pergunta por vez, sendo mais adequado para respostas rápidas e diretas.

• Knowledge Sources (KSs): atribua KSs específicos ao Agente para melhorar as respostas. Ele usará apenas os que você selecionou e não pesquisa outros KSs da conta. 

Você pode configurar a função de busca por similaridade. Escolha o seguinte:

• Número máximo de KOs considerados na busca: Escolha o número de objetos de conhecimento que você considerará nas respostas. Por padrão, a StackSpot AI usa quatro (4) fragmentos de Objetos de Knowledge Sources para enriquecer as respostas, mas você pode escolher quantos quiser.
• Limite de relevância: Escolha quão relevante é o limite. Por padrão,a StackSpot AI considera 73%, indicando a similaridade do fragmento de resposta que você está procurando. Você pode escolher a porcentagem desejada.

Passo 4. Clique em 'Salvar';

Teste seu Agente na seção 'Tentar' para garantir que ele funcione conforme o esperado;

Passo 5. Se você quiser compartilhar seu Agente, clique no botão 'Compartilhar' e escolha compartilhá-lo com:

1. Compartilhar com usuários: adicione o endereço de e-mail do usuário.
2. Publicar na conta.

Você poderá usar seu Agente na StackSpot AI IDE. 

Você pode editar ou apagar o seu Agent na aba 'Configurações'.

Exemplos de criação de Agentes

Agente 1. Revisão de código

Uma equipe de desenvolvimento deseja automatizar o processo de revisão de código, criando um Agente especializado na StackSpot AI. O objetivo é identificar problemas como violações de padrões de codificação, vulnerabilidades de segurança e oportunidades de otimização nas submissões de código.

Confira os passos para criar esse Agente:

1. Acesse o Portal da StackSpot AI e navegue até a seção ‘Agentes’;
2. Clique em ‘Criar Agente’ e forneça um nome, como "Agente de Revisão de Código";
3. No ‘Prompt do Sistema‘, defina as instruções para o Agente revisar o código, como: "Revise o código em busca de violações de padrões, vulnerabilidades de segurança e oportunidades de otimização";
4. Selecione o ‘Modo Conversacional‘ para permitir interações contínuas com a equipe de desenvolvimento durante o processo de revisão;
5. Adicione ‘Knowledge Sources‘ relevantes sobre padrões de codificação e segurança;
6. Salve o agente e teste-o na seção ‘Tentar’ para garantir que ele funcione conforme o esperado.

• Resultado: O Agente revisa automaticamente os commits de código, fornecendo feedback imediato sobre possíveis problemas, melhorando a qualidade do código e acelerando o processo de revisão. Ele pode ser utilizado tanto em conversas diretas com a equipe quanto dentro de um Quick Command para revisar múltiplos commits de uma vez.

Agente 2. Assistente de Gestão de Produto para Criação de User Stories

Um gerente de produto quer criar um Agente na StackSpot AI para auxiliar na criação de user stories detalhadas e acionáveis. O Agente ajudará a traduzir requisitos de produto em user stories estruturadas, fáceis de entender pelas equipes de desenvolvimento.

Confira os passos para criar esse Agente:

1. Acesse o Portal da StackSpot AI e navegue até a seção ‘Agentes’;
2. Clique em ‘Criar Agente’ e forneça um nome, como "Assistente de User Stories";
3. No ‘Prompt do Sistema‘, defina as instruções para o Agente revisar o código, como: "Ajude a criar user stories detalhadas e alinhadas com metodologias ágeis, baseadas nos requisitos fornecidos";
4. Selecione o ‘Modo Conversacional‘ para permitir que o gerente de produto interaja com ele durante a criação das user stories;
5. Adicione ‘Knowledge Sources‘ que contenham exemplos de user stories e boas práticas de metodologias ágeis;
6. Salve o agente e teste-o na seção ‘Tentar’.

• Resultado: O gerente de produto pode gerar rapidamente user stories bem estruturadas e alinhadas com as metodologias ágeis, reduzindo o tempo gasto na redação e garantindo consistência nas user stories da equipe. O agente pode ser utilizado tanto em conversas diretas quanto dentro de um Quick Command para gerar múltiplas user stories de uma vez.

Integração com Quick Commands

Ambos os Agentes podem ser utilizados individualmente em conversas ou combinados em um Quick Command para realizar tarefas mais complexas. Por exemplo, um Quick Command pode ser configurado para que o Agente de Revisão de Código e o Assistente de User Stories trabalhem juntos. Nesse cenário, o Quick Command pode revisar o código e, em seguida, gerar automaticamente user stories baseadas nas mudanças detectadas, otimizando o fluxo de trabalho da equipe.

Essa flexibilidade permite que múltiplos agentes especializados colaborem em diferentes etapas do ciclo de desenvolvimento, garantindo maior eficiência e qualidade no processo.

Para mais informações de como Criar Quick Commands,siga os passos na seção da documentação.

Próximos Passos

• Siga os passos para usar o Agente