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
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.
-
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.
-
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.
-
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.
-
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.
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.
Aqui vamos listar alguns templates de artefatos para serem utilizados no apoio à execução dos projetos da disciplina.
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:
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
Créditos: Dê crédito a colaboradores, patrocinadores ou quaisquer outras partes relevantes que ajudaram ou financiaram o projeto.
-
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.
-
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.
-
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.
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 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
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 Canvas de Prototipagem Rápida
Baixar exemplo de preenchimento do Canvas de Prototipagem Rápida
C4 Model (Contexto, Contêiner e Componente): O C4 Model é uma ferramenta essencial para a fase de Produção da metodologia AIdesign, fornecendo uma abordagem visual e hierárquica para documentar a arquitetura do assistente inteligente. Dividido em três níveis – Contexto, Contêiner e Componente – o modelo descreve desde as interações externas até os detalhes técnicos internos, promovendo clareza e alinhamento entre equipes técnicas e de negócios. Este modelo facilita a comunicação, assegura a escalabilidade e serve como referência para a implementação e manutenção do sistema. Mais informações sobre como usar o C4 Model na Produção podem ser encontradas aqui.
Baixar Canvas do C4 Model - Contexto
Baixar Canvas do C4 Model - Contêiner
Baixar Canvas do C4 Model - Componente
Canvas de Treinamento e Ajuste do Modelo: O Canvas de Treinamento e Ajuste do Modelo é um artefato operacional da fase de Produção que organiza e detalha o processo de preparação do modelo de IA. Ele abrange etapas como a seleção e o processamento de dados, o ajuste de hiperparâmetros e a definição de métricas de desempenho. Este artefato garante que o treinamento do modelo seja conduzido de forma eficiente e alinhada aos objetivos do projeto, proporcionando resultados consistentes e de alta qualidade.
Baixar Canvas de Treinamento e Ajuste do Modelo
Canvas de Testes e Validação: O Canvas de Testes e Validação é um artefato crítico da fase de Produção, voltado para assegurar a robustez e a confiabilidade do assistente inteligente. Ele estrutura os testes funcionais, de desempenho e de segurança, definindo critérios claros para avaliar a qualidade da solução. Além disso, este canvas permite documentar os resultados e identificar áreas de melhoria antes da implementação em ambiente de produção.
Baixar Canvas de Testes e Validação
Canvas de Entrega e Lançamento: O Canvas de Entrega e Lançamento é um artefato estratégico da fase de Produção, projetado para planejar a introdução do assistente inteligente no ambiente de produção. Ele organiza cronogramas, estratégias de comunicação e planos de contingência, assegurando uma transição suave e eficaz. Este artefato também considera ações pós-lançamento, como monitoramento inicial e suporte aos usuários, para maximizar o impacto e o sucesso da solução.
Baixar Canvas de Entrega e Lançamento
Canvas de Planejamento de Escalabilidade: O Canvas de Planejamento de Escalabilidade é um artefato essencial da fase de Validação na metodologia AIdesign. Ele organiza as estratégias para adaptar a infraestrutura e os recursos do assistente inteligente a um aumento de usuários ou interações. Com este artefato, equipes podem identificar os requisitos técnicos, avaliar os custos associados e definir mecanismos como balanceamento de carga e escalabilidade elástica, garantindo que o sistema funcione de forma eficiente em diferentes escalas.
Baixar Canvas de Planejamento de Escalabilidade
Canvas de Planejamento de Diversificação: O Canvas de Planejamento de Diversificação é utilizado na fase de Validação para orientar a expansão funcional do assistente inteligente. Ele detalha as novas capacidades a serem adicionadas, considerando seu impacto, viabilidade técnica e alinhamento com as necessidades dos usuários. Este artefato ajuda a priorizar funcionalidades que aumentem o valor do sistema, promovendo inovações que atendam a demandas emergentes de forma estruturada.
Baixar Canvas de Planejamento de Diversificação
Canvas de Feedback e Iteração: O Canvas de Feedback e Iteração é um artefato operacional da fase de Validação que organiza o processo de coleta, análise e implementação de feedback dos usuários. Ele permite categorizar os retornos recebidos, identificar áreas de melhoria e planejar ajustes no assistente inteligente. Este artefato é fundamental para promover um ciclo contínuo de evolução e refinamento, alinhando o sistema às expectativas dos usuários e às metas organizacionais.
Baixar Canvas de Feedback e Iteração
Canvas de Métricas de Escala e Impacto: O Canvas de Métricas de Escala e Impacto é uma ferramenta estratégica para monitorar o desempenho do assistente em escala e avaliar seu impacto organizacional. Este artefato auxilia na definição e no acompanhamento de indicadores-chave, como adoção de usuários, satisfação e eficiência operacional. Ele fornece insights valiosos para ajustar o sistema e sustentar seu crescimento de forma consistente e orientada por dados.
Baixar Canvas de Métricas de Escala e Impacto
Canvas de Planejamento de Expansão Geográfica ou de Domínio: O Canvas de Planejamento de Expansão Geográfica ou de Domínio é utilizado na fase de Validação para estruturar a entrada do assistente em novos mercados ou áreas de aplicação. Ele considera aspectos culturais, técnicos e regulatórios, organizando etapas como tradução, adaptação de fluxos de interação e conformidade com legislações locais. Este artefato assegura que a expansão seja planejada e executada de forma eficiente, minimizando riscos e maximizando oportunidades.
Baixar Canvas de Planejamento de Expansão Geográfica ou de Domínio