AI Design Engineering

Repositório da Disciplina [IF1006] Transformação Digital com IA: Utilizando Modelos de Linguagem no Ambiente de Negócios do curso de Sistemas de Informação do CIn @ UFPE. Nosso foco é explorar diferentes formas de aplicar técnicas, ferramentas e serviços de Inteligência artificial aliadas a práticas, metodologias e ferramentas da Engenharia de Software ne construção de produtos digitais.

Índice

1. Metodologia AI Design
   • Fases da Metodologia
2. Templates
   • README do repositório do projeto
   • Artefatos para a Fase de Imersão
   • Artefatos para a Fase de Ideação
   • Artefatos para a Fase de Produção
   • Artefatos para a Fase de Validação

Metodologia AI Design

Objetivo: A AI Design é uma metodologia para a implementação estratégica de projetos de IA generativa nos negócios. Ela é dividida em quatro fases principais, guiadas por princípios de design, para garantir que os assistentes inteligentes sejam desenvolvidos de forma alinhada com os objetivos de negócios, tecnicamente viáveis, eticamente justificáveis e desejáveis para as pessoas impactadas.

Fases da Metodologia

1. Imersão:

   • Identificação do Domínio: Escolher um domínio específico onde a IA generativa possa agregar valor significativo.
   • Seleção de Persona: Determinar o perfil de usuário que se beneficiará diretamente da solução de IA.
   • Mapeamento de Fontes de Dados: Identificar e garantir a relevância e qualidade das fontes de dados que alimentarão o modelo de IA.

   Exemplo: Uma clínica médica identifica a possibilidade de otimizar o sistema de agendamento de consultas e selecionar as pessoas do atendimento como a persona principal.

2. Ideação:

   • Definição de Objetivos: Estabelecer metas claras e mensuráveis para o projeto.
   • Design de Prompt: Criar prompts que guiarão as interações do assistente inteligente para satisfazer as necessidades identificadas.

   Exemplo: Melhorar a eficiência no agendamento de consultas e esclarecer dúvidas frequentes.

3. Produção:

   • Definição do Assistente Inteligente: Projetar um assistente detalhando sua identidade, propósito, perfil comportamental e estilo narrativo.
   • Teste e Expansão de Usuários: Iniciar testes com um grupo pequeno de usuários e fazer ajustes com base no feedback antes de expandir.

   Exemplo: "Dr. Help" é projetado com uma identidade amigável e um perfil comportamental empático, testado inicialmente com um grupo reduzido de atendentes.

4. Validação:

   • Implementação e Monitoramento: Desenvolver um plano detalhado para a implantação e monitoramento do assistente em produção.
   • Escala e Diversificação: Após o sucesso inicial, expandir a solução para outros casos de uso ou domínios.

   Exemplo: "Dr. Help" é implementado em escala e monitorado continuamente, com planos para expandir seu uso para apoiar médicos durante consultas.

Conclusão

A metodologia AI Design proporciona um roteiro detalhado para integrar IA generativa de maneira estratégica em ambientes corporativos, maximizando o potencial das equipes e melhorando a eficiência, a experiência e a tomada de decisões.

(Voltar ao topo)

Templates

Aqui vamos listar alguns templates de artefatos para serem utilizados no apoio à execução dos projetos da disciplina.

README do repositório do projeto

Um bom arquivo README é essencial para qualquer projeto no GitHub, pois serve como a primeira impressão e um guia para quem visita seu repositório. Aqui estão algumas boas práticas para criar um README eficaz:

1. Título e Descrição: Inicie com um título claro e uma descrição concisa do projeto. Isso deve dar aos visitantes uma boa ideia do que o projeto faz e por que é útil.

2. Badges: Inclua badges no topo do README para mostrar o status do build, cobertura de testes, licença, e outras informações úteis de forma rápida e visual.

3. Instalação e Configuração: Forneça instruções detalhadas sobre como instalar e configurar o projeto. Isso pode incluir comandos para clonar o repositório, instalar dependências e configurar o ambiente necessário.

4. Uso: Explique como usar o projeto, incluindo exemplos de código ou comandos. Se o projeto for uma biblioteca, mostre exemplos de como ele pode ser integrado e usado em outros projetos.

5. Funcionalidades: Liste as principais funcionalidades do projeto. Isso pode ajudar os usuários a entenderem o escopo do projeto e o que ele pode fazer.

6. Documentação Adicional: Forneça links para documentação mais detalhada, se disponível. Isso pode incluir links para a documentação da API, wikis do projeto, ou outros recursos relevantes.

7. Contribuição: Inclua uma seção sobre como contribuir para o projeto. Isso pode envolver instruções sobre como enviar pull requests, diretrizes de estilo de código, e como relatar bugs.

8. Licença: Especifique a licença sob a qual o projeto é disponibilizado. Isso informa aos usuários como eles podem usar o código do projeto legalmente.

9. Créditos: Dê crédito a colaboradores, patrocinadores ou quaisquer outras partes relevantes que ajudaram ou financiaram o projeto.

10. Screenshots e Vídeos: Se aplicável, inclua screenshots do projeto em ação ou vídeos demostrativos. Isso pode ajudar os visitantes a entender rapidamente o que seu projeto faz e como ele parece em uso.

11. FAQ ou Problemas Comuns: Se houver questões ou problemas frequentes, considere adicionar uma seção FAQ para ajudar os usuários a resolver problemas comuns sem precisar abrir um novo issue.

12. Estado do Projeto: Se o projeto estiver em uma fase inicial, em desenvolvimento ativo, ou se for um projeto maduro, informe isso aos usuários. Isso pode definir expectativas quanto à estabilidade e completude do projeto.

Essas práticas ajudam a garantir que seu projeto seja acolhedor e acessível para novos usuários e contribuidores, além de proporcionar uma visão clara de como o projeto funciona e é mantido.

(Voltar ao topo)

Artefatos para a Fase de Imersão

Canvas de Identificação do Domínio: O Canvas de Identificação do Domínio é um artefato essencial para a fase de Imersão da metodologia AI Design. Ele ajuda a equipe a selecionar e definir um domínio específico onde a IA generativa pode agregar valor significativo. Com este template, você pode organizar e documentar informações como a justificativa da escolha do domínio, os problemas atuais, as oportunidades de IA e os benefícios esperados.

Baixar Canvas de Identificação do Domínio

Baixar exemplo de preenchimento do Canvas de Identificação do Domínio

Persona Model Canvas: O Persona Canvas é utilizado para identificar e detalhar as personas que se beneficiarão diretamente da solução de IA. Este artefato auxilia na compreensão das necessidades, expectativas, problemas atuais e objetivos das personas, proporcionando uma base sólida para o desenvolvimento de soluções personalizadas e eficazes.

Baixar Persona Model Canvas

Baixar exemplo de preenchimento do Persona Model Canvas

Canvas de Mapeamento de Fontes de Dados: O Canvas de Mapeamento de Fontes de Dados é um template crucial para identificar e organizar as fontes de dados que alimentarão o modelo de IA. Ele permite documentar informações importantes sobre a origem, tipo, qualidade e métodos de coleta dos dados, garantindo que as fontes de dados sejam relevantes e de alta qualidade.

Baixar Canvas de Mapeamento de Fontes de Dados

Baixar exemplo de preenchimento do Canvas de Mapeamento de Fontes de Dados

Canvas de Objetivos de Projeto: O Canvas de Objetivos de Projeto é um artefato estratégico utilizado na fase de Imersão da metodologia AIdesign. Ele ajuda a identificar e alinhar os objetivos gerais e específicos do projeto de IA com os objetivos organizacionais e expectativas dos stakeholders. Este canvas serve como um ponto de partida para a definição inicial de metas amplas e indicadores de sucesso, que serão refinados posteriormente na fase de Ideação com o Canvas de Definição de Objetivos. A abordagem centrada na estratégia permite priorizar as necessidades do negócio e garantir que o projeto de IA esteja alinhado com os valores e resultados esperados pela organização.

Baixar Canvas de Objetivos de Projeto

Baixar exemplo de preenchimento do Canvas de Objetivos de Projeto

(Voltar ao topo)

Artefatos para a Fase de Ideação

Canvas de Definição de Objetivos: O Canvas de Definição de Objetivos é um artefato operacional utilizado na fase de Ideação da metodologia AIdesign. Ele se baseia no trabalho estratégico realizado na fase de Imersão com o Canvas de Objetivos de Projeto, detalhando e refinando metas gerais e específicas, bem como seus indicadores de sucesso. Além disso, este canvas introduz elementos como priorização detalhada e identificação de ações práticas para atingir cada objetivo. Este refinamento transforma metas estratégicas em objetivos claros e acionáveis, prontos para orientar o desenvolvimento técnico e a implementação da solução de IA.

Baixar Canvas de Definição de Objetivos

Baixar exemplo de preenchimento do Canvas de Definição de Objetivos

Canvas de Design de Prompts: O Canvas de Design de Prompts é utilizado para criar e detalhar os prompts que guiarão as interações com o assistente inteligente. Este artefato auxilia na definição do prompt inicial, respostas esperadas, ações esperadas e na coleta de feedback para ajustes. Utilize este template para garantir que as interações sejam eficazes e melhorem a experiência do usuário.

Baixar Canvas de Design de Prompts

Baixar exemplo de preenchimento do Canvas de Design de Prompts

Canvas de Ideação de Soluções: O Canvas de Ideação de Soluções é fundamental para gerar ideias de soluções inovadoras que utilizem IA generativa para resolver os problemas identificados e atingir os objetivos definidos. Este template ajuda a equipe a organizar e documentar problemas a serem resolvidos, ideias de solução, benefícios esperados, viabilidade técnica e priorização de soluções.

Baixar Canvas de Ideação de Soluções

Baixar exemplo de preenchimento do Canvas de Ideação de Soluções

Canvas de Prototipagem Rápida: O Canvas de Prototipagem Rápida é utilizado para planejar e documentar a criação de protótipos rápidos para testar as ideias de soluções de IA generativa. Este artefato auxilia na definição da ideia de solução, objetivo do protótipo, recursos necessários, cronograma de desenvolvimento e métricas de sucesso. Utilize este template para sistematizar a fase de Prototipagem e validar suas soluções de forma eficiente.

[Baixar C