Integre as APIs da Bright Data ao Agent.ai para obter agentes de IA mais inteligentes

Neste guia, você aprenderá:

• O que é o Agent.ai e o que o torna único em comparação com outras plataformas de criação de agentes de IA.
• Por que é importante ampliar os recursos dos agentes de IA por meio de serviços de terceiros e como a Bright Data oferece suporte a isso.
• Como adicionar recursos de recuperação de dados da Web por meio das APIs da Bright Data a um fluxo de trabalho do Agent.ai, sem uma única linha de código.

Vamos nos aprofundar no assunto!

O que é o Agent.ai?

Agent.ai é uma rede profissional e um mercado onde as pessoas podem descobrir, criar e usar agentes de IA para realizar tarefas e atingir metas de negócios.

Em sua essência, é uma plataforma de baixo código/sem código que permite criar agentes de IA sem nenhum conhecimento de programação. Em outras palavras, o Agent.ai é uma plataforma de criação e um mercado para agentes de IA.

Graças à sua interface fácil de usar, ela permite que você:

• Criar agentes de IA personalizados, adaptados às suas necessidades específicas.
• Configurar fluxos de trabalho de várias etapas para automatizar processos.
• Definir integrações para que os agentes possam interagir com outros sistemas.
• Definir regras de tomada de decisão para um comportamento mais inteligente do agente.
• Implante agentes para apoiar seus objetivos de negócios.

Ao contrário das ferramentas que exigem muita codificação, como LangChain, LlamaIndex ou Crew.ai, o Agent.ai não requer conhecimento de programação para a criação de agentes de IA.

O que você pode fazer no Agent.ai

Veja abaixo o que é possível fazer na plataforma:

• Descobrir agentes de IA: Navegar e pesquisar agentes prontos criados por outros.
• Criar agentes personalizados: Crie agentes de IA específicos para seus objetivos.
• Configurar fluxos de trabalho: Projete fluxos de trabalho de várias etapas para automação.
• Conecte-se com sistemas: Use APIs e ferramentas para vincular seu agente a plataformas como Slack, Gmail ou Google Sheets.
• Contrate agentes de IA: Traga agentes pré-construídos para realizar o trabalho imediatamente.

Como funciona

A Agent.ai fornece vários recursos principais que potencializam seus agentes:

• Entrada e saída: Você fornece a entrada (por exemplo, uma tarefa ou pergunta), e o agente gera a saída necessária (como redigir um e-mail ou analisar dados).
• Raciocínio: Os agentes usam o contexto e a lógica para tomar decisões informadas e planejar as próximas etapas.
• Ferramentas e APIs: Os agentes podem chamar serviços e ferramentas externas para ampliar sua funcionalidade.
• Memória: Os agentes lembram-se do contexto e das interações anteriores para raciocínio e planejamento mais avançados.

Por que e como conectar dados brilhantes a agentes no Agent.ai

Os LLMs podem lidar com uma ampla gama de tarefas por conta própria, mas os agentes criados exclusivamente com base neles são limitados. Em particular, os agentes só se tornam realmente eficazes quando combinados com recursos externos. Por exemplo, a capacidade de acessar dados da Web em tempo real, fazer o Scraping de dados de qualquer página da Web, rastrear sites inteiros para mapear seus URLs ou interagir com páginas da Web como um usuário humano faria.

Esses são exatamente os recursos fornecidos pela Bright Data graças ao seu kit de ferramentas de serviços prontos para IA que se integram sem esforço aos agentes. Esses serviços incluem:

• API Unlocker: Obtenha conteúdo de forma confiável de qualquer URL público, ignorando automaticamente os bloqueios e a Resolução de CAPTCHAs.
• API Crawl: Extraia dados de sites inteiros em formatos compatíveis com LLM para melhorar o raciocínio e a inferência.
• API SERP: Colete resultados de mecanismos de pesquisa em tempo real e com segmentação geográfica para descobrir as fontes de dados mais relevantes.
• API do navegador: Permitir que os agentes interajam com sites dinâmicos e executem fluxos de trabalho automatizados em escala usando navegadores furtivos remotos.

Todos esses produtos são acessíveis via API, o que significa que você pode conectá-los diretamente ao seu agente no fluxo de trabalho sem código do Agent.ai (ou em plataformas semelhantes, como a Dify).

Criar um agente de IA com integração de dados brilhantes no Agent.ai

Nesta seção, você aprenderá como integrar os recursos de recuperação de dados da Web da Bright Data em um agente Agent.ai via API. Especificamente, você criará um exemplo de agente Sumarizador de notícias que:

1. Aceita o URL de um artigo de notícias como entrada.
2. Scraping de seu conteúdo usando a API Web Unlocker, retornando a saída no formato Markdown.
3. Passa o Markdown para um LLM para resumo.
4. Apresenta o resumo ao usuário.

Observação: este é apenas um exemplo. Você pode aproveitar os serviços da Bright Data para muitas outras integrações e cenários.

Agora, siga as etapas abaixo para saber como criar esse agente em um fluxo de trabalho sem código. Como alternativa, se preferir, explore o resultado final diretamente conferindo a página do agente.

Pré-requisitos

Para seguir este tutorial, certifique-se de que você tenha:

• Uma conta do Agent.IA.
• Uma conta da Bright Data com uma chave de API e uma zona do Web Unlocker pronta.

Não se preocupe se ainda não tiver configurado sua conta da Bright Data. Você será guiado por esse processo mais adiante nas etapas abaixo.

Etapa 1: criar um novo agente

Comece criando uma conta Agent.IA ou fazendo login.

Uma vez conectado, clique no link “Agent Builder” (Criador de agentes) no canto superior direito. Ative o recurso “Agent Builder” e você será redirecionado para a seção “My Agents” (Meus agentes) da sua conta. Aqui, clique no botão “Create agent” (Criar agente) para começar a criar um novo agente:

Selecione a opção “Create new agent” (Criar novo agente) e pressione “Next” (Avançar) para inicializar um novo agente do zero:

Dê um nome ao seu agente (por exemplo, “News Summarizer”) e pressione “Save” (Salvar):

Agora você terá acesso à visualização do Agent Builder do Agent.ai:

Maravilhoso! Você criou com sucesso um novo agente de IA em branco.

É hora de começar a definir sua lógica!

Etapa 2: definir a lógica de entrada do usuário para capturar o URL da página de notícias

Primeiro, seu agente precisa receber como entrada o URL da página de notícias a ser resumida. Para fazer isso, adicione uma ação de entrada ao seu agente.

Clique no botão “Open Action Library” (Abrir biblioteca de ações) e selecione a ação “Get User Input” (Obter entrada do usuário) na lista suspensa “Inputs & Data Retrieval” (Entradas e recuperação de dados):

Configure a ação “Get User Input” da seguinte forma:

• Tipo: URL
• Use Prompt: “Enter the URL of the news page” (Digite o URL da página de notícias)
• Obrigatório: ✓
• Nome da variável de saída: news_page_url

Essa configuração define uma entrada de usuário que aceita apenas URLs, torna-a obrigatória e armazena a entrada na variável news_page_url, que estará acessível ao agente.

Quando terminar, pressione “Add”:

Agora você deve ver isso:

Observe a ação “Get User Input” (Obter entrada do usuário) na seção “Actions” (Ações) e como uma opção de entrada “Enter the URL of the news page” (Insira a URL da página de notícias) agora aparece na seção “Preview” (Visualização) da visualização do construtor de agentes. Muito bem!

Etapa nº 3: concluir o agente para evitar problemas

Se você tentar interagir com a entrada “Enter the URL of the news page” (Digite o URL da página de notícias), perceberá que ela está desativada. Esse é um comportamento comum que ocorre quando seu agente Agent.ai não tem nenhuma ação de saída definida.

Para tornar seu agente testável, adicione uma saída simples. Clique no botão “Add Action” (Adicionar ação) e selecione “Show User Option” (Mostrar opção do usuário) na lista suspensa “Outputs” (Saídas):

Configure-a com alguma lógica de espaço reservado, por exemplo, sempre retornando a cadeia de caracteres “test”:

Em seguida, clique no botão “Restart” (Reiniciar) na seção “Preview” (Visualização) para recarregar a visualização do agente:

Agora, a entrada “Enter the URL of the news page” (Insira a URL da página de notícias) poderá ser usada e o agente poderá ser testado:

Perfeito! Não se preocupe com a lógica de saída do espaço reservado na ação “Show User Option” (Mostrar opção do usuário), pois você a atualizará mais tarde no tutorial.

Etapa 4: configurar sua conta da Bright Data

A próxima etapa é passar o URL da notícia para a API do Web Unlocker da Bright Data para recuperar seu conteúdo em Markdown. Antes de fazer isso, vamos reservar um momento para configurar sua conta da Bright Data para que ela possa executar a solicitação necessária.

Observação: se você pretende usar outros produtos de recuperação de dados da Web da Bright Data disponíveis via APIs, siga uma abordagem semelhante à mostrada abaixo. Basta adaptar algumas ações de acordo. Para obter mais orientações, consulte sempre a documentação oficial.

Para chamar a API do Web Unlocker em seu agente Agent.ai, você precisa:

1. Ativar a solução Web Unlocker em seu painel de controle da Bright Data.
2. Recuperar seu token da API da Bright Data, que concede acesso ao Web Unlocker (juntamente com a API do Web Scraper e todos os outros serviços disponíveis na API).

Siga as etapas abaixo para concluir a configuração!

Primeiro, se você ainda não tiver uma conta da Bright Data, crie uma. Se já tiver uma conta, faça login e acesse seu painel de controle. Clique no botão “Proxies and Scraping” (Proxies e raspagem) no menu esquerdo para acessar a página “Proxies & Scraping Infrastructure” (Infraestrutura de proxies e raspagem):

Se já estiver vendo uma Zona ativa da API do Web Unlocker (como acima), você está pronto para a microetapa 1. O nome da zona (por exemplo, unlocker) é importante, pois você precisará dele mais tarde na Configuração do agente.

Se ainda não tiver uma zona, role para baixo até a seção “Web Unlocker API” e clique em “Create zone”:

Dê um nome à sua nova Zona, como unlocker, ative os recursos avançados para obter melhor desempenho e clique em “Add” (Adicionar):

Depois que a zona for criada, você será redirecionado para a página de Configuração da zona:

Certifique-se de que o botão de ativação esteja definido como “Active” (Ativo). Isso confirma que a zona está configurada corretamente e pronta para uso.

Para a microetapa 2, siga o guia oficial da Bright Data para gerar sua chave de API. Depois de obtê-la, guarde-a em um local seguro, pois você precisará dela em breve.

Ótimo! Agora você pode usar sua Zona do Web Unlocker da Bright Data em seu agente Agent.ai.

Etapa 5: Armazene suas credenciais da Bright Data no Agent.IA

Para chamar a API do Web Unlocker, você precisa especificar o nome da zona e a chave da API da Bright Data na solicitação. Para referência, veja como a solicitação da API funciona na documentação oficial da Bright Data.

Para evitar o armazenamento dessas credenciais confidenciais diretamente em seu agente, adicione-as aos segredos de seu perfil. No Agent.IA, os segredos permitem que você armazene com segurança dados confidenciais (como chaves ou tokens de API) e os use em seus agentes sem codificar valores em seus fluxos de trabalho.

Para definir segredos, vá para a página inicial do Agent.ai, clique na imagem de seu perfil e selecione a opção “Segredos”.

Na página “Secrets” (Segredos), clique no botão “Add Secret” (Adicionar segredo) para criar um novo segredo:

Adicione um segredo para sua chave da API Bright Data. Por exemplo:

• Nome: bright_data_api_key
• Valor: Cole sua chave da API da Bright Data recuperada na etapa anterior.

Da mesma forma, adicione outro segredo para o nome de sua Zona do Web Unlocker. Por exemplo:

• Nome: web_unlocker_zone_name
• Valor: O nome de sua zona do Web Unlocker (por exemplo, unlocker)

Agora você deve ver os dois segredos listados desta forma:

Fantástico! Esses segredos agora podem ser usados para a integração da Bright Data em qualquer agente que você criar no Agent.IA.

Etapa #6: invocar a API do Web Unlocker da Bright Data

Antes de chamar a API Web Unlocker em seu agente, familiarize-se com seu formato de solicitação. Veja a seguir como chamá-la usando cURL para obter a saída de um site de destino no formato Markdown:

curl -X POST "https://api.brightdata.com/request" 
-H "Authorization: Bearer <YOUR_BRIGHT_DATA_API_KEY>" 
-H "Content-Type: application/json" 
-d '{
  "Zona": "<WEB_UNLOCKER_ZONE_NAME>",
  "url": "<YOUR_TARGE_URL>",
  "format" (formato): "raw",
  "data_format": "markdown"
}' 

O comando cURL acima:

• Executa uma solicitação POST para https://api.brightdata.com/request.
• Use sua chave da API da Bright Data no cabeçalho Authorization para autenticar a solicitação.
• Especifique sua Zona do Web Unlocker no corpo da solicitação.
• Defina "data_format": "markdown" para obter a saída em Markdown.

Nos bastidores, a solicitação entra em contato com o serviço Web Unlocker. Ele ignora as proteções antibot, extrai o conteúdo da página de destino, converte-o em Markdown pronto para IA e o retorna como uma string (graças à opção "format": "raw" ).

Veja isso no exemplo de chamada a seguir:

Para executar programaticamente a solicitação da API do Web Unlocker em seu agente, clique em “Add Action” (Adicionar ação) e selecione “Invoke Web API” (Invocar API da Web) no menu suspenso “Workflow & Logic” (Fluxo de trabalho e lógica):

Preencha a ação conforme abaixo:

• URL: https://api.brightdata.com/request
• Method (Método): POST
• Formato: JSON
• Cabeçalhos: { "Authorization": "Bearer {{secrets.bright_data_api_key}}", "Content-Type": "application/json" }
• Corpo: { "Zona": "{{secrets.web_unlocker_zone_name}}", "url": "{{news_page_url}}", "format": "raw", "data_format": "markdown"}
• Nome da variável de saída: api_response

Observe que você pode acessar os segredos que definiu anteriormente usando a sintaxe:

{{secrets.YOUR_SECRET_NAME}}

A ação “Invoke Web API” resultante será:

Pressione “Add” (Adicionar) para adicionar a ação ao agente. Em seguida, reordene as ações de modo que “Invoke Web API” venha antes da ação “Show User Output”:

Legal! Seu agente agora pode se conectar aos recursos de Scraping de dados da Bright Data via API e recuperar o conteúdo da página de notícias em Markdown.

Etapa nº 7: adicionar a etapa de resumo do LLM

Agora que você tem o artigo de notícias em Markdown, passe-o para um LLM para fazer o resumo. Para fazer isso, configure uma ação “Generate Content” (Gerar conteúdo):

Selecione um LLM, como o Gemini 2.5 Flash, e escreva um prompt como este:

Resuma o seguinte artigo de notícias e retorne o resumo no formato Markdown.

NEWS CONTENT (CONTEÚDO DE NOTÍCIAS):
"{{api_response}}"

Aqui, {{api_response}} contém o conteúdo Markdown do artigo de notícias, que será automaticamente inserido no prompt. Isso é possível graças à sintaxe {{VARIABLE_NAME}} sintaxe do Agent.ai. Além disso, defina o “Output Variable Name” (Nome da variável de saída) como algo como saída para que você possa acessar o resumo mais tarde.

Sua ação “Generate Content” (Gerar conteúdo) deve ter a seguinte aparência:

Pressione “Add” para adicionar a nova ação. Em seguida, reordene as ações de modo que “Generate Content” venha depois de “Invoke Web API” e antes da ação “Show User Output”:

E pronto! Seu agente de resumo de notícias com IA está quase pronto.

Etapa nº 8: corrigir a ação de saída

Agora que seu agente produz um resumo real, é hora de mostrá-lo ao usuário. Edite a ação “Show User Output” (Mostrar saída do usuário) clicando no botão de edição em seu cartão de ação:

Configure o campo “Output Formatted” (Saída formatada) para usar a variável que contém o resumo produzido pela ação “Generate Content” (Gerar conteúdo):

{{summary}}

Missão concluída! Seu agente de IA de resumo de notícias está pronto.

Etapa 9: testar o agente

Esta é a aparência final de seu agente Sumarizador de notícias:

Importante: você pode testar esse agente na página do agente do News Summarizer. Clique no botão “View Agent Flow” (Exibir fluxo do agente) para explorar suas ações e personalizá-las.

Teste-o selecionando a opção “Run > Rung draft version”:

Cole o URL de um artigo de notícias (por exemplo, um artigo da ESPN) e pressione “Go” (Ir):

Nos bastidores, o agente executará suas quatro ações. Ele extrairá o conteúdo do artigo em Markdown por meio do Bright Data e, em seguida, o resumirá usando o Gemini. O resultado deve ser algo parecido com isto:

Um artigo da ESPN escrito por Kevin Pelton identifica as maiores lacunas no elenco de todas as 30 equipes da NBA que vão para a temporada 2025-26. A análise, divulgada com a conclusão da offseason da NBA e a aproximação dos campos de treinamento, destaca várias deficiências. Esses problemas vão desde a falta de habilidades específicas, como a criação de jogadas na segunda unidade (Atlanta Hawks) ou a criação eficiente de arremessos (Toronto Raptors), até pontos fracos posicionais, como o centro titular (Charlotte Hornets) ou o pivô (Philadelphia 76ers). Outras equipes enfrentam desafios como profundidade insuficiente no perímetro (Cleveland Cavaliers), necessidade de interrupção defensiva (Chicago Bulls) ou falta de experiência em criação de jogadas (Brooklyn Nets). Pelton observa que algumas equipes em reconstrução podem priorizar ganhos de curto prazo em detrimento de unidades coesas devido ao novo acordo coletivo de trabalho, enquanto outras, como o Golden State Warriors, estão aguardando a resolução da agência livre restrita. Para os candidatos ao título, como o atual campeão Oklahoma City Thunder, a ausência de problemas significativos no elenco indica uma equipe bem montada, o que sugere que qualquer falha individual dos aspirantes a candidatos pode ser resolvida por meio de crescimento interno ou acréscimos no meio da temporada.

Como você pode verificar na página original do artigo da ESPN, o resumo é bastante preciso:

Se estiver curioso para saber o que acontece nos bastidores, clique no botão “Dev Console”. Nessa exibição, você pode inspecionar cada ação executada pelo agente:

A expansão de “STEP 2: REST Call” revela que a saída da Web Unlocker API corresponde à versão Markdown do artigo de notícias fornecido como entrada:

Isso confirma que a Bright Data foi integrada corretamente e que a página foi raspada com sucesso.

E pronto! Agora você tem um agente Agent.ai integrado ao Bright Data via API. Ajustando o prompt do usuário ou experimentando outros produtos da Bright Data, você pode criar facilmente agentes que suportem muitos outros casos de uso.

Próximas etapas: Tornar-se público

Seu agente atual usa segredos para autenticação, o que funciona perfeitamente para uso privado. No entanto, se quiser habilitar os recursos da Bright Data em um agente público, será necessário permitir que os usuários configurem sua própria chave de API e nome da zona.

Para fazer isso, adicione campos de entrada extras para as credenciais necessárias, conforme mostrado no exemplo abaixo:

Depois de fazer isso, torne seu agente público e comece a coletar avaliações de outros usuários!

Extra: Depois que seu agente for publicado (seja público ou privado), você também poderá expô-lo a outras plataformas por meio do MCP. Isso permite que soluções como o Claude Desktop e ferramentas semelhantes usem seu agente para concluir as tarefas descritas em seus prompts.

Conclusão

Nesta postagem do blog, você viu como usar o Agent.IA para criar um agente de resumo de notícias em um fluxo de trabalho sem código. Isso foi possível com os serviços de recuperação de dados da Web da Bright Data, que estão disponíveis para integração de IA por meio de APIs.

O exemplo de fluxo de trabalho que criamos era simples, mas talvez você queira criar agentes de IA mais sofisticados. Para fazer isso, você precisará de ferramentas para recuperar, validar e transformar o conteúdo da Web. É exatamente isso que a infraestrutura de IA da Bright Data oferece.

Crie uma conta gratuita da Bright Data hoje mesmo e comece a fazer experiências com nossas ferramentas de dados da Web prontas para IA!