Integre a API SERP da Bright Data a um agente de IA no IBM watsonx

Neste tutorial, você descobrirá:

• Como o IBM watsonx oferece suporte ao desenvolvimento de agentes de IA.
• Por que a integração da API SERP da Bright Data aprimora os agentes IBM watsonx Orchestrate.
• As etapas exatas para criar um agente de IA com a API SERP da Bright Data no IBM Watsonx Orchestrate.

Vamos começar!

O que é o recurso de criação de agentes IA no IBM Watsonx?

O IBM Watsonx Orchestrate, um sistema de IA generativa e automação pronto para uso corporativo, oferece recursos de criação de agentes de IA. Essa solução fornece o que você precisa para projetar, implantar e gerenciar agentes de IA autônomos que executam tarefas, tomam decisões e interagem com sistemas críticos para os negócios.

A criação de agentes no IBM watsonx está disponível por meio de uma interface web de baixo código e uma abordagem baseada em código por meio da biblioteca Python Agent Development Kit (ADK). Neste artigo, vamos nos concentrar na integração do fluxo de trabalho de baixo código usando o aplicativo web.

Os agentes no serviço Orchestrate podem colaborar por meio da orquestração de múltiplos agentes, conectar-se a várias ferramentas externas, aproveitar o RAG (Retrieval-Augmented Generation) para respostas baseadas em conhecimento e muito mais.

A plataforma também inclui recursos de governança e observabilidade para garantir conformidade, transparência e monitoramento de desempenho. Depois de criados, os agentes podem ser implantados em vários canais, como chat na web, Slack, Microsoft Teams e outros.

Por que os agentes IBM watsonx precisam acessar a API SERP da Bright Data

Modelos de linguagem grandes, incluindo aqueles disponíveis no IBM watsonx, são limitados pelos dados com os quais foram treinados. Em termos mais simples, seu conhecimento se limita a um determinado momento no tempo.

É por isso que os LLM tendem a produzir respostas desatualizadas ou imprecisas. Esse problema se torna ainda mais sério para agentes de IA encarregados de tomar decisões ou produzir relatórios para apoiar a tomada de decisões…

A solução é equipar seu agente com ferramentas que permitam buscar e processar dados confiáveis. Por exemplo, o agente poderia consultar mecanismos de pesquisa para reunir informações verificadas e atualizadas e, então, aprender com esses dados para reduzir alucinações. O resultado seria decisões mais precisas e maior confiança de que as respostas do agente são baseadas em conhecimento do mundo real.

A maneira mais fácil de conseguir isso é por meio de uma API SERP ou ferramenta de pesquisa na web, como a API SERP da Bright Data. Essa API de nível empresarial para recuperação de dados de mecanismos de pesquisa lida com proxies, desbloqueio e formatação de dados para você. Em outras palavras, você não precisa se preocupar com os desafios típicos da coleta de dados de mecanismos de pesquisa ao trabalhar com agentes de IA.

A API SERP da Bright Data se integra diretamente ao IBM watsonx Orchestrate (assim como a muitas outras plataformas de criação de agentes de IA), permitindo que seus agentes de IA acessem resultados de pesquisa e produzam resultados mais contextuais, confiáveis e verificáveis.

Desenvolvendo um agente de IA com integração da API SERP no IBM watsonx.ai: um guia passo a passo

Nesta seção, você aprenderá como integrar a API SERP da Bright Data como uma ferramenta dentro de um agente de IA no IBM watsonx Orchestrate.

Entre os muitos casos de uso possíveis, este passo a passo se concentra na criação de um agente de recomendação de conteúdo. Seu objetivo é sugerir ideias de conteúdo com base nas tendências recentes relacionadas a um determinado tópico (por exemplo, descobrir as últimas notícias importantes que valham a pena escrever ou fazer vídeos no YouTube para marketing).

Observação: este é apenas um exemplo, e você pode adaptar a mesma integração da API SERP para alimentar muitos outros casos de uso impulsionados por IA.

Siga as etapas abaixo!

Pré-requisitos

Para acompanhar este tutorial, certifique-se de ter:

• Um IBMid para fazer login no seu IBM watsonx Orchestrate (uma avaliação gratuita é suficiente).
• Uma conta Bright Data com uma chave API ativa.

Não se preocupe em configurar sua conta Bright Data ainda, pois você será orientado nesse processo mais tarde.

Também é útil ter alguma familiaridade com o funcionamento da API SERP da Bright Data, como os agentes de IA usam ferramentas e os fundamentos das especificações OpenAPI para definir ferramentas.

Etapa 1: crie um novo agente de IA IBM watsonx

Faça login no IBM Watsonx Orchestrate usando sua conta IBM. Você chegará a esta página:

Aqui, pressione o botão “Criar novo agente” à esquerda para abrir o formulário para criar um novo agente. Preencha o formulário “Criar um agente” da seguinte forma:

• Selecione a opção “Criar do zero”.
• Dê um nome ao seu agente, como “Agente de recomendação de conteúdo”.
• Forneça uma descrição como: “Este agente pode recuperar informações atualizadas de mecanismos de pesquisa por meio da integração da API SERP da Bright Data para recomendar conteúdo relevante e interessante com base em uma determinada entrada”.
  
  Quando terminar, pressione o botão “Criar” no canto inferior esquerdo para continuar. Você acessará a página de gerenciamento de agentes:
  
  Ótimo! Você acabou de inicializar seu agente de IA de recomendação de conteúdo no IBM watsonx Orchestrate. Em breve, ele será integrado à API SERP da Bright Data para recuperar resultados de pesquisa atualizados.

Etapa 2: personalize seu agente

Na página de gerenciamento do agente, você pode personalizar várias opções, como a voz do agente, o modelo de IA, os prompts de inicialização, a mensagem de saudação e muito mais.

Para alterar o modelo, abra o menu suspenso à direita da seção “Modelo de IA”:

Na versão de avaliação do IBM Watsonx, você tem acesso aos dois modelos a seguir:

1. llama-3-2-90b-vision-instruct: otimizado para reconhecimento visual, raciocínio de imagens, legendas e respostas a perguntas sobre imagens. Este é o modelo padrão.
2. llama-3-405b-instruct: LLM avançado para geração de dados sintéticos, destilação e inferência para chatbots, codificação e tarefas específicas de domínio. Desenvolvido pela Meta.

Selecione o modelo que melhor se adapta ao objetivo do seu agente.

Em seguida, considere atualizar a mensagem de boas-vindas para torná-la mais contextual à função do seu agente. Por exemplo, escreva algo como “Que dicas de recomendação de conteúdo você deseja?”

Além disso, atualize os prompts de início rápido para fornecer exemplos de interações para os usuários:

• “Recomende alguns filmes recentes que eu definitivamente deveria assistir.”
• “Mostre-me as notícias mais recentes sobre o IBM watsonx.”
• “Encontre tópicos de blog em alta sobre IA em 2025 e sugira cinco ideias de conteúdo sobre as quais eu poderia escrever.”

Agora, como esse agente dependerá principalmente de ferramentas (especificamente a API SERP da Bright Data), também faz sentido defini-lo como um agente ReAct. Se você não está familiarizado com essa arquitetura, um agente ReAct segue este fluxo:

• Pensamento: o LLM planeja a próxima etapa.
• Ação: executa ações usando ferramentas.
• Observação: observa os resultados e refina a abordagem.

Esse loop contínuo permite que o agente lide com consultas complexas, cruze informações e valide resultados intermediários antes de fornecer uma resposta final.

Depois que todas as configurações estiverem concluídas, vá para a seção “Visualizar” à direita e pressione o botão “Redefinir chat” para recarregar a visualização do seu agente:

Agora você verá o agente atualizado com todas as suas personalizações aplicadas:

Etapa 3: Comece a usar a API SERP da Bright Data

Antes de continuar com a definição do agente de IA, você precisa preparar sua conta Bright Data e configurar o serviço API SERP. Para isso, siga a documentação oficial da Bright Data ou as instruções abaixo.

Se você ainda não tem uma conta, crie uma conta Bright Data. Caso contrário, basta fazer login. Depois de fazer login, navegue até a página “Proxy e Scraping”. Na seção “Minhas zonas”, procure uma linha chamada “API SERP” na tabela:

Se você não vir uma linha chamada “API SERP”, isso significa que ainda não foi configurada uma zona. Role para baixo até a seção “API SERP” e clique em “Create zone” (Criar zona) para adicionar uma:

Crie uma zona API SERP e atribua-lhe um nome, como serp_api (ou qualquer nome que preferir). Anote o nome da zona, pois você precisará dele para acessar o serviço no IBM watsonx.

Na página do produto API SERP, alterne o botão “Ativar” para habilitar a zona:

Por último, siga o tutorial oficial para gerar sua chave API Bright Data. Guarde-a em um local seguro, pois você precisará dela em breve.

Também recomendamos verificar a documentação da API SERP da Bright Data para se familiarizar com como chamar a API, suas opções disponíveis e outros detalhes.

Perfeito! Agora você tem tudo configurado para usar a API SERP da Bright Data em seu agente de IA IBM Watsonx.

Etapa 4: Adicione a ferramenta API SERP

Como parte das opções de personalização, você também tem a possibilidade de adicionar ferramentas ao seu agente. É assim que você pode conectar um agente de IA à API SERP da Bright Data. Vamos examinar a definição e a integração dessa ferramenta personalizada (o que levará as próximas três etapas).

Para adicionar uma nova ferramenta ao seu agente, vá para a seção “Ferramentas” e clique no botão “Adicionar ferramenta”:

Normalmente, você poderia considerar selecionar a opção“Criar um fluxo de trabalho do agente”e escrever o código Python para se conectar à API SERP da Bright Data. No entanto, no momento da redação deste artigo, os módulos Python disponíveis — que vocêpode importar e usar em nós de código Python personalizados — são fixos e não podem ser estendidos. Como os clientes HTTP Python não estão incluídos, a abordagem de código personalizado não funcionará. Em vez disso, você pode integrar a API SERP em uma ferramenta por meio de uma especificação OpenAPI.

Em detalhes, o que você deseja fazer é adicionar a ferramenta Bright Data API usando uma definição OpenAPI. Para fazer isso, crie um arquivo chamado bright-data-serp-api.yml em sua máquina local com a seguinte especificação:

openapi: 3.0.3
info:
  title: Bright Data API SERP
  version: 1.0.0
  description: >
    A Bright Data API SERP fornece resultados reais de usuários em grandes volumes para todos os
    principais mecanismos de pesquisa. Suporta formatos de saída brutos e Markdown.
servers:
  - url: https://api.brightdata.com
paths:
  /request:
    post:
      summary: Enviar uma solicitação SERP
      description: >
        Envie uma solicitação de scraping SERP usando sua zona Bright Data API SERP.
      tags:
        - SERP
      requestBody:
        required: true
        content:
          application/json:
            esquema:
              tipo: objeto
              obrigatório:
                - zona
                - url
              propriedades:
                zona:
                  tipo: string
                  descrição: O nome da sua zona API SERP.
                  padrão: <YOUR_BRIGHT_DATA_API_SERP_ZONE_NAME>
                url:
                  tipo: string
                  descrição: A URL do mecanismo de pesquisa a ser consultada (por exemplo, https://www.google.com/search?q=<search_query>)
exemplo: https://www.google.com/search?q=pizza&hl=en&gl=us
formato:
tipo: string
descrição: Formato da resposta
padrão: raw
formato dos dados:
tipo: string
descrição: Formato dos dados de saída
padrão: markdown
respostas:
“200”:
descrição: Resposta bem-sucedida com resultados da pesquisa
conteúdo:
texto/simples:
esquema:
tipo: string
“400”:
descrição: Solicitação inválida
“401”:
descrição: Não autorizado - chave API inválida
"500":
descrição: Erro interno do servidor
segurança:
- bearerAuth: []
componentes:
esquemas de segurança:
bearerAuth:
tipo: http
esquema: bearer
formato do portador: API_KEY

Importante: Substitua <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME> pelo nome real da sua zona API SERP criada anteriormente (por exemplo, serp_api).

O código YAML acima define uma especificação OpenAPI v3.0.3 para integrar a API SERP da Bright Data. Os pontos principais a serem observados são:

• O corpo da API define os seguintes parâmetros:
  • zone: O nome da sua zona API SERP.
  • url: A URL da página do mecanismo de pesquisa a ser consultada.
  • format: Especifica como a API deve produzir os dados de saída. "``raw" significa que a API retornará os dados recuperados diretamente no corpo da resposta, sem aninhá-los em um objeto estruturado.
  • data_format: determina o formato da resposta, como HTML, JSON analisado ou Markdown. Neste caso, ele é definido como “markdown” por padrão, pois esse é o formato de dados ideal para ingestão de IA.
• A seção bearerAuth em securitySchemes indica que a conexão da API é autenticada usando uma chave de API fornecida pelo usuário no cabeçalho Authorization por meio do mecanismo Bearer (que é como você autentica solicitações para a API SERP usando sua chave de API Bright Data).

O importante aqui é entender que a especificação OpenAPI acima define uma chamada da API SERP da Bright Data que retorna dados no formato Markdown. Para todos os detalhes acima, incluindo o significado de cada parâmetro e opção, consulte a documentação oficial.

Para passar esse arquivo YAML para o IBM watsonx, no modal “Adicionar uma nova ferramenta”, selecione “Adicionar do arquivo ou servidor MCP”:

Em seguida, escolha “Importar do arquivo”:

Dica: para simplificar o acesso aos produtos Bright Data prontos para IA, você também pode selecionar a opção “Importar do servidor MCP” e configurar o Web MCP da Bright Data por meio de sua instância remota.

No modal “Importar ferramenta”, arraste e solte seu arquivo bright-data-api-serp.yml ou clique para carregá-lo:

Após a conclusão da validação, você deverá ver a seguinte mensagem de confirmação:

Sucesso! Sua especificação OpenAPI para integração com a API SERP da Bright Data foi aceita. Clique em “Avançar” e continue com a integração da ferramenta em seu agente.

Etapa 5: Conclua a autenticação da ferramenta API SERP

Após clicar no botão “Avançar”, você verá a linha “Enviar uma solicitação SERP” na tabela “Operações”:

Marque-a e pressione o botão “Próximo”. Você chegará à seção “Conexões”, onde precisará definir a conexão necessária para autenticar as solicitações da API SERP usando sua chave API da Bright Data. Comece pressionando o botão “Adicionar novo item”:

Na seção “Adicionar nova conexão”, atribua um ID à conexão, como bright-data-api-key:

Pressione “Salvar e continuar” e configure sua conexão selecionando:

• Tipo de autenticação: “Bearer Token”
• Tipo de credenciais: “Credenciais da equipe”

No campo de entrada “Bearer token” que aparece após selecionar a opção “Credenciais da equipe”, cole sua chave API da Bright Data. Em seguida, pressione “Conectar”:

Depois que a conexão for verificada, você verá uma confirmação como esta:

Em seguida, clique em “Concluir” e selecione bright-data-api-key na tabela “Conexões”:

Por fim, conclua a configuração de autenticação pressionando “Concluído”.

Parabéns! Você autenticou com sucesso sua ferramenta personalizada “Enviar uma solicitação SERP” para integração com a API SERP da Bright Data.

Etapa 6: Finalize a configuração da ferramenta API SERP

Na página de gerenciamento do agente, você verá agora a ferramenta “Enviar uma solicitação SERP” disponível na seção “Conjunto de ferramentas”:

Para personalizar ainda mais a ferramenta, pressione o botão “⋮” e selecione a opção “Editar detalhes”. Na página de configuração, revise todas as configurações para verificar se tudo está correto e configurado conforme necessário:

Você verá a descrição da API e os parâmetros do corpo da solicitação, juntamente com seus valores padrão, conforme definido na especificação YAML carregada anteriormente.

Pronto! Você finalmente concluiu a integração da API SERP da Bright Data ao seu agente IBM watsonx usando uma ferramenta personalizada definida por meio de uma especificação OpenAPI.

Etapa 7: Teste o agente

Seu agente IBM watsonx IA agora está configurado com acesso a uma ferramenta para recuperação SERP. Teste-o com um prompt que exija dados do mecanismo de pesquisa ao vivo, como:

Encontre as notícias mais recentes sobre robôs humanóides com IA e sugira cinco ideias de conteúdo que eu poderia escrever para explorar esse tópico.

(Observação: este é apenas um exemplo, e você pode testar qualquer prompt que exija resultados de pesquisa na web).

Esse é um prompt ideal porque solicita informações atuais que o modelo básico por si só pode não conhecer, já que “robôs humanóides com IA” é um tópico em alta com notícias constantemente atualizadas.

Execute este prompt na seção “Visualizar” do seu agente e você deverá ver um resultado semelhante a este:

O agente baseado em ReAct chamará a ferramenta “Enviar uma solicitação SERP”, recuperará os resultados e processará as informações SERP para gerar uma resposta coerente.

Se você já tentou extrair resultados de pesquisa do Google, sabe como isso é desafiador devido à detecção de bots, bloqueios de IP, renderização de JavaScript (que até levou a uma crise de dados SERP) e outros problemas. A API SERP da Bright Data lida com tudo isso para você, retornando SERPs extraídos no formato Markdown (ou HTML, JSON, etc.) otimizado para IA.

Para garantir que a API SERP foi chamada pelo agente, expanda a seção “Raciocínio” da resposta. Concentre-se na “Etapa 1”:

Observe como a primeira etapa corresponde à chamada da ferramenta API SERP da Bright Data para a consulta “últimas notícias sobre robôs humanóides com IA” (que foi inferida a partir do prompt). Em seguida, a resposta da ferramenta é a versão Markdown da página SERP para essa consulta de pesquisa.

Nesse caso, abaixo está a resposta produzida pelo agente de IA:

Com base nos resultados da pesquisa, aqui estão cinco ideias de conteúdo para explorar o tópico de robôs humanóides com IA:
1. “O futuro do trabalho: como os robôs humanóides com IA estão revolucionando as indústrias” - Este artigo poderia explorar as várias maneiras pelas quais os robôs humanóides com IA estão sendo usados em diferentes indústrias, como manufatura, saúde e atendimento ao cliente.
2. “A ética dos robôs humanóides com IA: eles deveriam ter direitos humanos?” - Este artigo poderia aprofundar as implicações éticas da criação de robôs cada vez mais semelhantes aos humanos e se eles deveriam receber direitos humanos.
3. “Os últimos avanços em robôs humanóides com IA: o que você precisa saber” - Este artigo poderia fornecer uma visão geral dos últimos desenvolvimentos em robôs humanóides com IA, incluindo novas tecnologias e inovações que estão sendo usadas para criar robôs mais avançados.
4. “Os riscos e benefícios potenciais dos robôs humanóides com IA em casa” - Este artigo poderia explorar os riscos e benefícios potenciais de ter robôs humanóides com IA em casa, incluindo seu potencial para ajudar nas tarefas domésticas e proporcionar companhia.
5. “O impacto dos robôs humanóides com IA na sociedade: uma visão do futuro” – Este artigo poderia examinar o impacto potencial dos robôs humanóides com IA na sociedade, incluindo seu potencial para mudar a maneira como vivemos e trabalhamos, e as consequências potenciais da criação de robôs cada vez mais semelhantes aos humanos.

Esta é uma ótima resposta com insights valiosos para a geração de conteúdo!

Agora é hora de levar seu agente ainda mais longe. Tente testar prompts relacionados à verificação de fatos, monitoramento de marcas, análise de tendências de mercado ou outros cenários para avaliar seu desempenho em diferentes casos de uso de RAG e agentes.

Et voilà! Você acabou de criar um agente de IA no IBM Watsonx integrado à API SERP da Bright Data. Agora, seu agente pode recuperar dados de pesquisa na web atualizados, confiáveis e contextuais sob demanda para alimentar recomendações de conteúdo inteligentes.

Conclusão

Nesta postagem do blog, você entendeu como integrar a API SERP da Bright Data a um agente de IA IBM Watsonx usando um fluxo de trabalho de baixo código.

Essa abordagem é ideal para usuários empresariais que desejam criar agentes de IA sensíveis ao contexto na IBM, aproveitando os recursos escaláveis e prontos para uso corporativo da API SERP da Bright Data. Para levar seus fluxos de trabalho de IA ainda mais longe, explore a infraestrutura da Bright Data para IA.

Inscreva-se hoje mesmo na Bright Data e comece a testar nossas soluções de dados da web prontas para IA gratuitamente!