Propósito

✔ Programação GLOBAL® - Quaisquer soluções e/ou desenvolvimento de aplicações pessoais, ou da empresa, que não constem neste Blog devem ser tratados como consultoria freelance. Queiram contatar-nos: brazilsalesforceeffectiveness@gmail.com | ESTE BLOG NÃO SE RESPONSABILIZA POR QUAISQUER DANOS PROVENIENTES DO USO DOS CÓDIGOS AQUI POSTADOS EM APLICAÇÕES PESSOAIS OU DE TERCEIROS.

.: Vitrine

Carregando artigos...

Views

Mostrando postagens com marcador Prompt. Mostrar todas as postagens
Mostrando postagens com marcador Prompt. Mostrar todas as postagens

Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA

Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA
#ProgramaçãoGlobal #Prompt #Claude #Secrets #tricks #Tips #Dicas #ClaudeAI #PromptEngineering #AtalhosDeIA #IndústriaFarmacêutica #Produtividade #GestãoFarmacêutica #InteligênciaArtificial #PromptsSecretos #Eficiência #AnáliseDeRisco #TomadaDeDecisão


DOE UM CAFÉ


Poucos Gestores Farmacêuticos Conhecem.


A primeira coisa que precisa ficar clara antes de qualquer outra coisa neste artigo: os atalhos que você vai ler a seguir não são comandos secretos escondidos no código da IA, nem funcionalidades exclusivas que a Anthropic libera para usuários selecionados. São frases de prompt, instruções escritas em linguagem natural que, quando bem construídas, mudam radicalmente a qualidade da resposta que você recebe. A diferença entre chamar isso de "código secreto" e chamar de "técnica de prompt bem desenhada" pode parecer semântica, mas para um gestor farmacêutico que precisa confiar no que está usando em processos sérios, essa diferença importa.


Nada do que será apresentado aqui depende de hackear o sistema ou de explorar uma vulnerabilidade. Depende de algo muito mais simples e muito mais replicável: formular o pedido certo, com o contexto certo, para obter o tipo de resposta que realmente resolve o seu problema. E no setor farmacêutico, onde decisões envolvem risco regulatório, investimento de capital e responsabilidade sobre a saúde pública, ter um repertório de boas formulações de prompt é uma vantagem competitiva real, silenciosa e praticamente gratuita.


Desbloquear esse repertório é o que este artigo se propõe a fazer. Vamos analisar os atalhos que mais circularam recentemente nas redes profissionais, e acrescentar mais 15 técnicas adicionais que merecem o mesmo destaque, todas com aplicação prática e direta para quem trabalha com força de vendas, regulatório, market access, farmacovigilância ou gestão estratégica em farmacêutica.


a técnica do ponto cego | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Começando pelo atalho que abre a lista original: a técnica do ponto cego, que pode ser ativada com uma instrução do tipo "aja como um crítico experiente e me mostre o que estou deixando passar nesta decisão ou neste plano". Essa formulação transforma a IA de assistente complacente em parceiro de checagem cética, forçando o modelo a procurar ativamente por lacunas em vez de simplesmente validar o que foi apresentado. Na Indústria Farmacêutica, isso tem aplicação imediata na revisão de planos de lançamento de produto: antes de submeter o plano de pré-lançamento ao comitê executivo, o gestor de marca pode pedir ao Claude que identifique pressupostos não testados sobre o cenário competitivo, lacunas na estratégia de acesso ao mercado ou riscos regulatórios que a equipe pode ter normalizado por estar próxima demais do projeto.


Explique como se eu tivesse três anos | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Empata em utilidade prática a técnica do "explique como se eu tivesse três anos", que não é um comando oculto, mas uma instrução de simplificação radical que força o modelo a eliminar jargão e construir a explicação a partir de analogias básicas. Para uma empresa farmacêutica, essa técnica tem valor em pelo menos dois cenários concretos: na preparação de materiais de comunicação para pacientes sobre mecanismos de ação de medicamentos complexos, e no treinamento de novos representantes que ainda não dominam a linguagem técnica da área terapêutica em que vão atuar. Pedir a IA que explique o mecanismo de um inibidor de PCSK9 "como se fosse para uma criança de três anos" frequentemente revela a melhor forma de simplificar essa mesma explicação para um paciente leigo, sem perder a precisão científica essencial.


Aprenda o padrão de escrita do usuário a partir de exemplos fornecidos | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Reaproveitando o terceiro atalho da lista original, temos a técnica de clonagem de estilo, que pede ao modelo que aprenda o padrão de escrita do usuário a partir de exemplos fornecidos e replique esse estilo em textos futuros. A instrução típica é algo como "aqui estão três e-mails que escrevi recentemente, aprenda meu tom e meu vocabulário e use esse mesmo estilo para redigir o próximo texto". Para diretores médicos e gerentes regionais que precisam manter consistência de comunicação em grande volume de e-mails, relatórios e comunicados internos, essa técnica reduz drasticamente o tempo de revisão e edição, porque o output já nasce parecido com a voz autêntica de quem está escrevendo, em vez de soar genericamente como "texto de IA".


Simular cenários adversos antes de comprometer recursos | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Direto ao ponto da quarta técnica, o atalho do pesadelo serve para simular cenários adversos antes de comprometer recursos. A instrução é pedir ao modelo que assuma o papel de um cético implacável e construa o pior cenário plausível para um plano, projeto ou investimento. Aplicado a um caso de uso farmacêutico, esse atalho é especialmente valioso na avaliação de risco de lançamento de novos produtos: antes de comprometer o orçamento anual de marketing em uma campanha, pedir a IA para simular os cenários em que a estratégia de precificação enfrenta resistência da ANS, em que um concorrente lança um produto similar antes do previsto, ou em que o reembolso público é negado, expõe vulnerabilidades que a euforia do lançamento tende a obscurecer nas reuniões internas.


Dissecar as premissas ocultas por trás de qualquer proposta ou argumento, revelando o que precisa ser verdade para que a conclusão se sustente | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


A última das cinco técnicas originais é o raio-x de argumentos, uma instrução que pede ao modelo para dissecar as premissas ocultas por trás de qualquer proposta ou argumento, revelando o que precisa ser verdade para que a conclusão se sustente. Em ambientes farmacêuticos onde decisões estratégicas frequentemente são apresentadas com confiança excessiva, essa técnica funciona como um filtro de qualidade antes da aprovação de qualquer investimento relevante. Um diretor de market access pode usar essa técnica para examinar a proposta de um consultor externo sobre estratégia de precificação, identificando quais premissas sobre elasticidade de demanda, comportamento de pagadores ou cenário competitivo precisam se confirmar para que a recomendação faça sentido.


Modo advogado do diabo persistente | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Reservada para gestores que lidam com volumes grandes de literatura científica, a sexta técnica desta lista expandida é o que chamamos de modo "advogado do diabo persistente": uma instrução para que a IA não aceite a primeira resposta como definitiva e continue questionando cada afirmação em rodadas sucessivas até que a justificativa seja realmente sólida. A formulação típica pede ao modelo para "questionar cada conclusão que você apresentar, mesmo que pareça óbvia, até que eu confirme que está satisfeito com a evidência". Os MSLs e times de Medical Affairs podem usar essa técnica para estressar a robustez de uma argumentação científica antes de levá-la a uma discussão com um KOL exigente, garantindo que cada ponto resista a um questionamento rigoroso.


Comprime sem perder essência | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Equilibrando a lista entre análise crítica e produtividade, a sétima técnica é o modo "comprime sem perder essência", uma instrução que pede ao modelo para reduzir drasticamente o tamanho de um documento mantendo apenas os pontos com impacto real na decisão. Diferente de um simples resumo, essa técnica exige explicitamente que o modelo elimine redundância e priorize por relevância estratégica, não por ordem cronológica do texto original. Para gestores farmacêuticos que recebem dezenas de relatórios de visitação e análises de mercado por semana, pedir a IA que "comprima este relatório de 12 páginas em meia página mantendo apenas os pontos que mudariam minha decisão" é uma das aplicações de maior retorno imediato de tempo identificadas em ambientes corporativos de alta densidade de informação.


Simulação de múltiplas perspectivas | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Sustentando uma das aplicações mais delicadas desta lista, a oitava técnica é o modo "simulação de múltiplas perspectivas", que pede a IA para responder à mesma pergunta assumindo diferentes papéis e prioridades em sequência. A instrução pede explicitamente que o modelo represente, por exemplo, a visão de um CFO, depois a de um diretor médico, depois a de um regulador, sobre a mesma proposta de projeto. Para decisões farmacêuticas com múltiplos stakeholders internos e externos, antecipar essas perspectivas divergentes antes de uma reunião de comitê reduz surpresas e prepara argumentação mais robusta para cada audiência específica.


Tradutor de complexidade regulatória | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Nascida da necessidade de melhorar a comunicação técnico-científica para públicos leigos, a nona técnica é o modo "tradutor de complexidade regulatória", uma instrução que pede ao modelo para traduzir linguagem técnica de resoluções da ANVISA, da EMA ou do FDA para a linguagem prática que um gestor comercial sem formação jurídica ou regulatória consegue aplicar no dia a dia. Em vez de pedir simplesmente "resuma esta resolução", a formulação mais eficaz pede "explique o que esta resolução muda na prática para a minha equipe comercial, com exemplos concretos do que pode e não pode ser feito a partir de agora". Esse atalho economiza horas de interpretação jurídica em situações de mudança regulatória frequente.


Simulação de objeção difícil | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Direcionada especificamente para a área de treinamento, a décima técnica é o modo "simulação de objeção difícil", que pede ao modelo para representar o papel de um médico cético ou resistente durante um treinamento de role-play para representantes. A instrução típica é "simule um cardiologista experiente, cético em relação a novos lançamentos, e me faça as objeções mais difíceis que ele poderia levantar sobre este produto". Times de treinamento de força de vendas estão usando essa técnica para preparar representantes júnior para interações reais antes de colocá-los em campo, criando um ambiente de prática seguro e infinitamente repetível.


Advogado da concorrência | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Voltada para a área de inteligência competitiva, a décima primeira técnica é o modo "advogado da concorrência", que pede a IA para construir o melhor argumento possível em favor de um produto concorrente, simulando como um representante daquela empresa apresentaria seu diferencial. Essa técnica é valiosa precisamente porque obriga as equipes internas a confrontar os pontos fortes reais da concorrência, em vez de subestimá-los por viés interno otimista, o que historicamente é uma das principais causas de planos de defesa de mercado mal calibrados.


Advogado da concorrência | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Útil em processos de revisão de materiais promocionais, a décima segunda técnica é o modo "C", uma instrução que pede ao modelo para revisar um texto promocional como se fosse um auditor rigoroso de compliance regulatório, identificando qualquer afirmação que possa violar normas de promoção de medicamentos. Embora a IA não substitua a revisão formal de compliance de uma equipe jurídica qualificada, usar essa técnica como uma primeira triagem antes da submissão formal reduz significativamente o número de idas e voltas no processo de aprovação de materiais.


Cenários de futuro alternativo | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Reservada para momentos de planejamento estratégico, a décima terceira técnica é o modo "cenários de futuro alternativo", que pede a IA para construir três versões distintas e plausíveis de como o mercado farmacêutico de uma área terapêutica específica pode evoluir nos próximos três anos, com diferentes premissas sobre regulação, concorrência e tecnologia. Diretores de unidade de negócio estão usando essa técnica para estresse-testar planos estratégicos de longo prazo contra múltiplos futuros possíveis, em vez de planejar com base em um único cenário linear de continuidade do presente.


Detector de padrões silenciosos | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Especialmente valiosa para times de farmacovigilância, a décima quarta técnica é o modo "detector de padrões silenciosos", uma instrução que pede ao modelo para examinar uma série de relatórios ou registros e identificar padrões recorrentes que não são óbvios à primeira leitura individual de cada documento. Aplicada com cautela e sempre como apoio à análise humana qualificada, não como substituto dela, essa técnica pode ajudar analistas a identificar tendências em relatos de eventos adversos que mereçam investigação mais aprofundada antes que se tornem estatisticamente evidentes em dashboards tradicionais.


Antecipador de perguntas difíceis | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Pensada para acelerar a preparação de reuniões executivas, a décima quinta técnica é o modo "antecipador de perguntas difíceis", que pede a IA para se colocar no lugar de um board cético e listar as dez perguntas mais difíceis que poderiam ser feitas sobre uma apresentação específica antes de ela acontecer. Gestores que aplicaram essa técnica antes de apresentações de investimento relataram chegar à reunião real significativamente menos surpreendidos, porque já haviam preparado respostas para os questionamentos mais prováveis.


Verificador de consistência terminológica | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Voltada para times de medical writing, a décima sexta técnica é o modo "verificador de consistência terminológica", uma instrução que pede ao modelo para revisar um documento longo e identificar inconsistências no uso de termos técnicos, nomenclatura de produtos ou terminologia regulatória ao longo do texto. Em dossiês regulatórios extensos, onde a inconsistência terminológica pode gerar questionamentos desnecessários de reguladores, essa técnica funciona como uma camada adicional de controle de qualidade antes da submissão final.


Simulador de resposta a crise | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Aplicável diretamente à gestão de crise, a décima sétima técnica é o modo "simulador de resposta a crise", que pede a IA para gerar rapidamente um rascunho de comunicado de resposta a uma situação hipotética de crise, como o recall de um lote de produto ou a divulgação negativa de um efeito adverso na mídia. Times de comunicação corporativa estão usando essa técnica em exercícios de simulação trimestrais, testando a velocidade e a qualidade da resposta institucional antes que uma crise real exija essa capacidade sob pressão real.


Extrator de decisão única | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Direcionada à eficiência analítica, a décima oitava técnica é o modo "extrator de decisão única", uma instrução que pede ao modelo para ler um documento longo e responder a uma única pergunta muito específica, ignorando todo o resto do conteúdo irrelevante para aquela decisão pontual. Em vez de pedir um resumo geral de um relatório de 40 páginas, a formulação mais eficaz é "leia este documento e me diga apenas se existe alguma menção a risco de desabastecimento no terceiro trimestre, ignore o resto". Essa técnica economiza tempo de leitura e reduz a chance de informação irrelevante distrair da decisão real que precisa ser tomada.


Tradutor de dado bruto em narrativa estratégica | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Pensada para qualificar melhor o trabalho de inteligência de mercado, a décima nona técnica é o modo "tradutor de dado bruto em narrativa estratégica", que pede a IA para transformar uma planilha de dados de vendas, sem qualquer interpretação prévia, em uma narrativa de três parágrafos que explique o que está acontecendo e por quê. Analistas de inteligência comercial estão usando essa técnica para acelerar a produção de relatórios executivos, mantendo o controle final sobre a interpretação mas delegando ao modelo a primeira passagem de estruturação narrativa dos números.


Checklist reverso de risco | Top 20 Importantes instruções Pouco Comentadas que precisam ser consideradas em seus Prompts de IA


Fechando a lista, a vigésima técnica é o modo "checklist reverso de risco", uma instrução que pede a IA para, a partir de uma decisão já tomada, construir a lista de tudo que precisaria ter sido verificado antes de tomá-la, funcionando como uma auditoria retrospectiva de processo de decisão. Embora não substitua a prevenção, essa técnica é extremamente útil em sessões de aprendizado organizacional após o encerramento de projetos, ajudando equipes farmacêuticas a identificar lacunas sistemáticas no processo de aprovação que podem ser corrigidas em decisões futuras.


A organização farmacêutica que constrói deliberadamente um repertório dessas técnicas, documentado e compartilhado entre as equipes, transforma o uso de IA de uma experiência individual e aleatória em uma capacidade institucional consistente. Vale registrar, mais uma vez, que nenhuma dessas técnicas é mágica nem infalível. Elas são formulações de prompt que melhoram a qualidade e a relevância das respostas porque dão ao modelo contexto, papel e critério mais claros do que uma pergunta genérica forneceria. O resultado ainda precisa passar pelo julgamento humano qualificado, especialmente em decisões regulatórias, científicas ou de compliance.


A diferença entre uma empresa farmacêutica que usa IA de forma superficial e uma que extrai valor estratégico real está exatamente nesse tipo de prática: não no acesso à ferramenta, que é igual para todos, mas no refinamento de como ela é usada no dia a dia. Construir e documentar uma biblioteca interna dessas vinte técnicas, adaptadas ao vocabulário e aos processos específicos da sua operação, é um dos investimentos de menor custo e maior retorno disponíveis para qualquer time farmacêutico que já tem acesso a IA e quer ir além do uso básico de perguntas e respostas.


👉 Siga André Bernardes no Linkedin. Clique aqui e contate-me via What's App.

Comente e compartilhe este artigo!

brazilsalesforceeffectiveness@gmail.com

Claude Prompt | PROMPT Bom não é PROMPT Grande

Prompt bom não é prompt grande#ProgramaçãoGlobal #Prompt #Claude


DOE UM CAFÉ


Prompt bom é prompt claro, estruturado e intencional.


CRIO DASHBOARDS NO POWER BI


Use estas 10 regras no Claude:


✅ 1. Nomeie o resultado final  

Diga qual saída você quer: tabela, checklist, resumo executivo ou plano de ação.


✅ 2. Defina tamanho e profundidade  

Especifique extensão, nível de detalhe e estrutura.  

Exemplo: 150 palavras, 5 bullets, sem introdução.


✅ 3. Use instruções positivas  

Troque “não complique” por “escreva de forma simples, direta e objetiva”.


✅ 4. Comece com verbos de ação  

Use: analisar, comparar, sintetizar, priorizar, reescrever, estruturar.


✅ 5. Dê contexto cognitivo  

Informe papel, público, objetivo, cenário, limites e restrições.  

Quanto melhor o contexto, melhor o raciocínio.


✅ 6. Defina tom e voz  

Diga se a resposta deve ser técnica, executiva, didática, persuasiva ou simples.


✅ 7. Ative raciocínio mais profundo  

Peça análise passo a passo, critérios de decisão, premissas e trade-offs.


✅ 8. Peça perguntas antes da resposta  

Se o tema estiver incompleto, instrua o modelo a perguntar primeiro.


✅ 9. Transforme prompts em habilidades  

Salve estruturas recorrentes como templates reutilizáveis.  

O que funciona uma vez pode virar sistema.


✅ 10. Seja literal e verificável  

Diga exatamente o que incluir, excluir e como validar o resultado.


Prompts melhores não são mais longos.


São mais claros, estruturados e intencionais.


A ferramenta não é o gargalo.


A forma como você a usa é.


👉 Siga André Bernardes no Linkedin. Clique aqui e contate-me via What's App.

Comente e compartilhe este artigo!

brazilsalesforceeffectiveness@gmail.com

Compreendendo o Google Search Grounding

Compreendendo o Google Search Grounding
#ProgramaçãoGlobal #Google #GoogleSearchGrounding #ADK #IA


O Google Search Grounding transforma agentes de IA de repositórios estáticos de conhecimento em assistentes dinâmicos e conectados à web, capazes de fornecer informações precisas e em tempo real. Ao integrar esse recurso aos seus agentes do ADK, você permite que eles:


  • Acesse informações atuais além dos dados de treinamento
  • Forneça atribuição de fonte para transparência e confiança
  • Forneça respostas abrangentes com fatos verificáveis


Melhore a experiência do usuário com sugestões de pesquisa relevantes


O processo de aterramento conecta perfeitamente as consultas dos usuários ao vasto índice de busca do Google, enriquecendo as respostas com contexto atualizado e mantendo o fluxo da conversa. Com a implementação e exibição adequadas de respostas aterradas, seus agentes se tornam ferramentas poderosas para descoberta de informações e tomada de decisões.


A ferramenta Google Search Grounding é um recurso poderoso do Kit de Desenvolvimento de Agentes (ADK - Agent Development Kit) que permite que agentes de IA acessem informações confiáveis ​​e em tempo real da web. Ao conectar seus agentes à Pesquisa Google, você pode fornecer aos usuários respostas atualizadas e respaldadas por fontes confiáveis.


Esse recurso é particularmente útil para consultas que exigem informações atuais, como atualizações meteorológicas, notícias sobre eventos, preços de ações ou quaisquer fatos que possam ter mudado desde o corte dos dados de treinamento do modelo. Quando o seu agente determina que informações externas são necessárias, ele realiza automaticamente pesquisas na web e incorpora os resultados em sua resposta com a devida atribuição.


Início rápido do Google Search Grounding


Este guia de início rápido orienta você na criação de um agente ADK com o recurso de Google Search Grounding. Este guia de início rápido pressupõe um IDE local (VS Code ou PyCharm, etc.) com Python 3.9+ e acesso ao terminal.


1. Configurar ambiente e instalar o ADK

 

Criar e ativar ambiente virtual:

# Create

python -m venv .venv


# Activate (each new terminal)

# macOS/Linux: source .venv/bin/activate

# Windows CMD: .venv\Scripts\activate.bat

# Windows PowerShell: .venv\Scripts\Activate.ps1


Instalar o ADK:


pip install google-adk==1.4.2


2. Criar projeto de agente


Em um diretório de projeto, execute os seguintes comandos:


OS X e Linux

 

# Step 1: Create a new directory for your agent

mkdir google_search_agent


# Step 2: Create __init__.py for the agent

echo "from . import agent" > google_search_agent/__init__.py


# Step 3: Create an agent.py (the agent definition) and .env (Gemini authentication config)

touch google_search_agent/agent.py .env


Windows

 

# Step 1: Create a new directory for your agent

mkdir google_search_agent


# Step 2: Create __init__.py for the agent

echo "from . import agent" > google_search_agent/__init__.py


# Step 3: Create an agent.py (the agent definition) and .env (Gemini authentication config)

type nul > google_search_agent\agent.py 

type nul > google_search_agent\.env


Editar agent.py

Copie e cole o seguinte código em agent.py:


google_search_agent/agent.py


from google.adk.agents import Agent

from google.adk.tools import google_search


root_agent = Agent(

    name="google_search_agent",

    model="gemini-2.5-flash",

    instruction="Answer questions using Google Search when needed. Always cite sources.",

    description="Professional search assistant with Google Search capabilities",

    tools=[google_search]

)


Agora você teria a seguinte estrutura de diretório:


my_project/

    google_search_agent/

        __init__.py

        agent.py

    .env


3. Escolha uma plataforma

Para executar o agente, você precisa selecionar uma plataforma que o agente usará para chamar o modelo Gemini. Escolha entre Google AI Studio ou Vertex AI:


Gemini - Estúdio de IA do Google

Obtenha uma chave de API do Google AI Studio.


Ao usar Python, abra o arquivo .env, copie e cole o código a seguir.


.env


GOOGLE_GENAI_USE_VERTEXAI=FALSE

GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE

Substitua PASTE_YOUR_ACTUAL_API_KEY_HEREpelo seu API KEY.


Gemini - Google Cloud Vertex IA

Você precisa de uma conta existente do Google Cloud e de um projeto.


Configurar um projeto do Google Cloud

Configurar a CLI do gcloud

Autentique-se no Google Cloud a partir do terminal executando gcloud auth login.

Habilite a API do Vertex AI.

Ao usar Python, abra o .env arquivo, copie e cole o código a seguir e atualize o ID e o local do projeto.


.env


GOOGLE_GENAI_USE_VERTEXAI=TRUE

GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID

GOOGLE_CLOUD_LOCATION=LOCATION


4. Execute seu agente

Existem várias maneiras de interagir com seu agente:


Interface de usuário de desenvolvimento (adk web)


Execute o seguinte comando para iniciar a interface de desenvolvimento .


adk web

Nota para usuários do Windows: Ao clicar em _make_subprocess_transport NotImplementedError, considere usar adk web --no-reload em vez disso.


Etapa 1: Abra a URL fornecida (geralmente http://localhost:8000ou http://127.0.0.1:8000) diretamente no seu navegador.


Etapa 2:  No canto superior esquerdo da interface, você pode selecionar seu agente no menu suspenso. Selecione "google_search_agent".


Solução de problemas: Se você não vir "google_search_agent" no menu suspenso, certifique-se de que está executando adk web na pasta pai da pasta do seu agente (ou seja, a pasta pai do google_search_agent).


Etapa 3:  Agora você pode conversar com seu agente usando a caixa de texto.


Terminal (execução adk)


Execute o seguinte comando para conversar com seu agente do Weather.


adk run google_search_agent

 

Para sair, use Cmd/Ctrl+C.


📝 Exemplos de prompts para tentar

Com essas perguntas, você pode confirmar se o agente está realmente acessando o Google Search para obter as últimas informações sobre o clima e a hora.


  • Como é o clima em Nova York?
  • Que horas são em Nova York?
  • Como é o clima em Paris?
  • Que horas são em Paris?


Você criou e interagiu com sucesso com seu agente de Pesquisa do Google usando o ADK!

Como funciona o Google Search Grounding

Google Search Grounding é o processo que conecta seu agente a informações em tempo real da web, permitindo que ele gere respostas mais precisas e atualizadas. Quando o prompt de um usuário solicita informações com as quais o modelo não foi treinado, ou que são sensíveis ao tempo, o Large Language Model subjacente do agente decide, de forma inteligente, invocar a ferramenta google_search para encontrar os fatos relevantes.


Diagrama de fluxo de dados

O diagrama abaixo ilustra o processo passo a passo de como uma consulta do usuário resulta em uma resposta fundamentada.


Diagrama de fluxo de dados do Google Search Grounding


Descrição detalhada

O agente de Grounding usa o fluxo de dados descrito no diagrama para recuperar, processar e incorporar informações externas na resposta final apresentada ao usuário.


Consulta do usuário: um usuário final interage com seu agente fazendo uma pergunta ou dando um comando.


Orquestração do ADK: O Agent Development Kit orquestra o comportamento do agente e passa a mensagem do usuário para o núcleo do seu agente.


Análise de LLM e Chamada de Ferramentas: O LLM do agente (por exemplo, um modelo Gemini) analisa o prompt. Se determinar que informações externas atualizadas são necessárias, ele aciona o mecanismo de aterramento chamando a ferramenta google_search. Isso é ideal para responder a consultas sobre notícias recentes, previsão do tempo ou fatos não presentes nos dados de treinamento do modelo.


Interação do serviço de aterramento: a ferramenta google_search interage com um serviço de aterramento interno que formula e envia uma ou mais consultas ao Índice de Pesquisa do Google.


Injeção de Contexto: O serviço de Grounding recupera as páginas da web e os snippets relevantes. Em seguida, ele integra esses resultados de pesquisa ao contexto do modelo antes que a resposta final seja gerada. Essa etapa crucial permite que o modelo "raciocine" sobre dados factuais e em tempo real.


Geração de Resposta Fundamentada: O LLM, agora informado pelos novos resultados da pesquisa, gera uma resposta que incorpora as informações recuperadas.


Apresentação da Resposta com Fontes: O ADK recebe a resposta final fundamentada, que inclui os URLs de origem e os groundingMetadata necessários, e a apresenta ao usuário com atribuição. Isso permite que os usuários finais verifiquem as informações e gera confiança nas respostas do agente.


Compreendendo o aterramento com a resposta da Pesquisa Google


Quando o agente usa a Pesquisa Google para fundamentar uma resposta, ele retorna um conjunto detalhado de informações que inclui não apenas a resposta final em texto, mas também as fontes utilizadas para gerá-la. Esses metadados são cruciais para verificar a resposta e atribuir a atribuição às fontes originais.


Exemplo de uma resposta fundamentada

A seguir está um exemplo do objeto de conteúdo retornado pelo modelo após uma consulta fundamentada.


Texto da resposta final:

"Yes, Inter Miami won their last game in the FIFA Club World Cup. They defeated FC Porto 2-1 in their second group stage match. Their first game in the tournament was a 0-0 draw against Al Ahly FC. Inter Miami is scheduled to play their third group stage match against Palmeiras on Monday, June 23, 2025."


Trecho de metadados de aterramento:


"groundingMetadata": {

  "groundingChunks": [

    { "web": { "title": "mlssoccer.com", "uri": "..." } },

    { "web": { "title": "intermiamicf.com", "uri": "..." } },

    { "web": { "title": "mlssoccer.com", "uri": "..." } }

  ],

  "groundingSupports": [

    {

      "groundingChunkIndices": [0, 1],

      "segment": {

        "startIndex": 65,

        "endIndex": 126,

        "text": "They defeated FC Porto 2-1 in their second group stage match."

      }

    },

    {

      "groundingChunkIndices": [1],

      "segment": {

        "startIndex": 127,

        "endIndex": 196,

        "text": "Their first game in the tournament was a 0-0 draw against Al Ahly FC."

      }

    },

    {

      "groundingChunkIndices": [0, 2],

      "segment": {

        "startIndex": 197,

        "endIndex": 303,

        "text": "Inter Miami is scheduled to play their third group stage match against Palmeiras on Monday, June 23, 2025."

      }

    }

  ],

  "searchEntryPoint": { ... }

}


Como interpretar a resposta

Os metadados fornecem um link entre o texto gerado pelo modelo e as fontes que o suportam. Aqui está uma análise passo a passo:


groundingChunks: Esta é uma lista das páginas da web consultadas pelo modelo. Cada pedaço contém o título da página e um URI que leva à fonte.


groundingSupports: Esta lista conecta frases específicas na resposta final de volta aos groundingChunks.


segmento: Este objeto identifica uma parte específica da resposta do texto final, definida por seu startIndex, endIndex e o próprio texto.


groundingChunkIndices: Esta matriz contém os números de índice que correspondem às fontes listadas em groundingChunks. Por exemplo, a frase "Eles derrotaram o FC Porto por 2 a 1..." é corroborada por informações de groundingChunks nos índices 0 e 1 (ambos de mlssoccer.com e intermiamicf.com).


Como exibir respostas de aterramento com a Pesquisa Google


Uma parte essencial do uso do grounding é exibir corretamente as informações, incluindo citações e sugestões de pesquisa, ao usuário final. Isso gera confiança e permite que os usuários verifiquem as informações.




Exibindo sugestões de pesquisa


O searchEntryPointobjeto em groundingMetadata contém HTML pré-formatado para exibir sugestões de consultas de pesquisa. Como visto na imagem de exemplo, elas geralmente são renderizadas como ícones clicáveis ​​que permitem ao usuário explorar tópicos relacionados.


HTML renderizado de searchEntryPoint: Os metadados fornecem o HTML e o CSS necessários para renderizar a barra de sugestões de pesquisa, que inclui o logotipo do Google e ícones para consultas relacionadas, como "Quando será a próxima Copa do Mundo de Clubes da FIFA" e "Histórico da Copa do Mundo de Clubes da FIFA do Inter Miami". Integrar esse HTML diretamente no front-end do seu aplicativo exibirá as sugestões conforme o esperado.



👉 Siga André Bernardes no LinkedinClique aqui e contate-me via What's App.

Comente e compartilhe este artigo!

brazilsalesforceeffectiveness@gmail.com


 

 Compre OS LIVROS DESTA SÉRIE 



 Série Donut Project 

DONUT PROJECT: VBA - Projetos e Códigos de Visual Basic for Applications (Visual Basic For Apllication)eBook - DONUT PROJECT 2024 - Volume 03 - Funções Financeiras - André Luiz Bernardes eBook - DONUT PROJECT 2024 - Volume 02 - Conectando Banco de Dados - André Luiz Bernardes eBook - DONUT PROJECT 2024 - Volume 01 - André Luiz Bernardes


eBook - PT - Série DONUT PROJECT - Volume 07 - VBA TOP 50 Códigos Mais Importantes - Access — André Luiz BernardeseBook - PT - Série DONUT PROJECT - Volume 07 - VBA TOP 50 Códigos Mais Importantes - Excel — André Luiz Bernardes eBook - PT - Série DONUT PROJECT - Volume 07 - VBA TOP 50 Códigos Mais Importantes - Outlook — André Luiz Bernardes eBook - PT - Série DONUT PROJECT - Volume 08 - VBA TOP 50 Códigos Mais Importantes - Project — André Luiz Bernardes  eBook - PT - Série DONUT PROJECT - Volume 08 - VBA TOP 50 Códigos Mais Importantes - Project — André Luiz Bernardes  eBook - PT - Série DONUT PROJECT - Volume 08 - VBA TOP 50 Códigos Mais Importantes - Word — André Luiz Bernardes
diHITT - Notícias