/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

MIT LicenseMIT

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

Índice

  1. Metodologia AI Design
  2. Templates

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 é utilizado para definir e organizar os objetivos do projeto de IA. Este template ajuda a estabelecer metas claras e mensuráveis, identificar indicadores de sucesso e determinar prazos realistas para o alcance das metas. É uma ferramenta essencial para garantir que o projeto esteja alinhado com os objetivos estratégicos e expectativas dos stakeholders.

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 essencial para a fase de Ideação da metodologia AI Design. Ele ajuda a equipe a refinar e detalhar os objetivos específicos do projeto de IA, garantindo que as metas sejam claras, mensuráveis e alinhadas com os indicadores de sucesso. Use este template para organizar e documentar os objetivos gerais, específicos, indicadores de sucesso, metas quantitativas e a priorização de objetivos.

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 Canvas de Prototipagem Rápida

Baixar exemplo de preenchimento do Canvas de Prototipagem Rápida

(Voltar ao topo)