Oracle AI Agents: Web Access with Bright Data

Neste artigo, você aprenderá:

O que é o Serviço de Agentes de IA Generativa da Oracle e o que ele oferece.
Por que os agentes de IA empresariais precisam de acesso a dados web em tempo real para insights de mercado contextuais, e como a Bright Data torna isso possível.
Como criar um Agente de IA Generativa da Oracle com acesso à web usando ferramentas personalizadas com a Bright Data.

Vamos começar!

O Que É o Serviço de Agentes de IA Generativa da Oracle?

O Oracle Generative AI Agents é um serviço OCI (Oracle Cloud Infrastructure) totalmente gerenciado para criação e implantação de agentes de IA. Esses agentes podem compreender linguagem natural, reter contexto de conversas, orquestrar ferramentas, acessar dados empresariais e automatizar fluxos de trabalho complexos.

Os casos de uso comuns incluem suporte ao cliente, solução de problemas técnicos, pesquisa jurídica e financeira, criação de conteúdo, tutoria educacional, análise de cadeia de suprimentos, insights imobiliários e assistência de viagens.

Principais Recursos

As principais capacidades oferecidas pelos Agentes de IA Generativa da Oracle são:

Configuração simples de agentes: Crie e implante agentes de IA por meio de um processo de configuração guiado e totalmente gerenciado, sem necessidade de gerenciar infraestrutura.
Conversas com múltiplos turnos: Suporte a conversas naturais e humanas com interações contextuais em várias mensagens.
Retenção de contexto: Lembra turnos anteriores da conversa para fornecer respostas personalizadas, consistentes e relevantes.
Instruções personalizadas: Defina o comportamento, tom, objetivos e lógica de roteamento do agente por meio de instruções configuráveis.
Proteções integradas: Ajudam a proteger contra ataques de injeção de prompt, moderar conteúdo e detectar dados PII sensíveis.
Suporte a humano no loop: Permite revisão e intervenção humana para ações sensíveis e operações críticas para os negócios.
Escalabilidade e segurança empresarial: Executado na infraestrutura segura e escalável da OCI com confiabilidade e governança de nível empresarial.
Ferramentas integradas e personalizadas: Estenda os agentes com SQL, RAG, orquestração agente a agente, chamada de funções e integrações de API personalizadas.

Saiba mais na documentação oficial.

Por Que os Agentes de IA Oracle Empresariais Precisam de Acesso à Web

Para tomar decisões prontas para os negócios, os agentes de IA empresariais precisam de acesso a dados de mercado externos. Isso inclui tendências atuais, atividade de concorrentes, sentimento do cliente, notícias recentes e atualizações regulatórias.

O desafio é que os LLMs não estão conectados à web em tempo real por padrão. Como resultado, eles enfrentam duas limitações principais:

Sem acesso a informações em tempo real: Os LLMs não conseguem recuperar nativamente conteúdo web atualizado.
Acesso limitado a sites: Muitos sites empregam tecnologias antibot que impedem sistemas automatizados de coletar dados.

Essas limitações podem ser superadas estendendo os agentes de IA com ferramentas e integrações externas.

É exatamente por isso que os Agentes de IA Generativa da Oracle suportam múltiplas opções de ferramentas. Em particular, a ferramenta de chamada de endpoint de API permite que eles se conectem com segurança a serviços externos baseados em API, como a Bright Data.

A Bright Data como Solução

Bright Data's web access infrastructure for AI

A Bright Data é a principal plataforma de dados web empresarial e pronta para IA. Ela permite coletar, estruturar e analisar dados web públicos de forma ética e em escala, graças a um conjunto abrangente de produtos.

Esses incluem:

Unlocker API: Contorna CAPTCHAs, sistemas antibot e bloqueios de sites para recuperar dados de qualquer página web.
API SERP: Fornece resultados estruturados e em tempo real de mecanismos de busca do Google, Bing, Yandex e outros principais buscadores.
Crawl API: Suporta rastreamento de sites em larga escala e extração automatizada de dados.
Scraper APIs: Fornecem extração estruturada de dados de mais de 120 sites e plataformas populares.

O que diferencia a Bright Data é sua rede de mais de 400 milhões de IPs residenciais abrangendo 195 países. Essa infraestrutura permite a coleta de dados web altamente escalável e geograficamente distribuída, alcançando uma taxa de sucesso de 98,50% e uptime de 99,99% garantido por SLA. Também está em conformidade com todos os principais frameworks de privacidade e segurança, incluindo GDPR e CCPA.

Ao integrar a Bright Data por meio de ferramentas de chamada de endpoint de API, os Agentes de IA Generativa da Oracle podem pesquisar na web, acessar informações online atualizadas, recuperar dados de sites e incorporar contexto do mundo real em suas respostas. Isso leva a resultados mais precisos, atualizados e acionáveis.

Integrando a Bright Data com um Agente de IA Generativa da Oracle

Nesta seção passo a passo, você aprenderá como criar um Agente de IA Generativa da Oracle integrado à Bright Data. Em detalhes, você verá como definir duas ferramentas personalizadas de chamada de endpoint de API para conectar à Web Unlocker API e à API SERP da Bright Data.

A API SERP permite que o agente descubra novas fontes, enquanto a Web Unlocker API permite acessar o conteúdo delas. Juntas, elas habilitam o poderoso padrão de busca e extração. Isso ajuda os agentes a fundamentarem autonomamente suas respostas em dados web em tempo real, verificáveis e contextuais, produzindo resultados mais factuais e de nível empresarial.

Siga as instruções abaixo!

Pré-requisitos

Para acompanhar esta seção, certifique-se de ter:

Uma conta Oracle Cloud (uma conta de nível gratuito é suficiente).
Uma conta Bright Data com uma chave de API configurada. Siga o guia oficial para configurar sua chave de API da Bright Data.

Passo #1: Configurar uma VCN

Faça login na sua conta Oracle, pesquise por “Virtual Cloud Networks” e selecione o serviço correspondente:

Na página “Virtual Cloud Networks”, abra o menu suspenso “Actions” e selecione “Start VCN Wizard“:

Em seguida, escolha a opção “Create VCN with Internet Connectivity” e siga o assistente de configuração:

Dê um nome à sua VCN (por exemplo, “ai”) e continue pelo assistente. As configurações padrão funcionam bem para esta configuração.

Nota: O recurso “DNS Resolution” deve estar habilitado para a sub-rede. Caso contrário, as ferramentas personalizadas não conseguirão chamar endpoints externos. No entanto, esse recurso é habilitado por padrão ao usar o assistente de rede OCI, portanto não há nada com que se preocupar.

Após a criação da VCN, você deverá ver algo assim:

Ótimo! Agora você tem uma Virtual Cloud Network (VCN) OCI com uma sub-rede que as ferramentas da Bright Data podem usar para rotear o tráfego HTTP.

Passo #2: Armazenar Sua Chave de API da Bright Data em um Oracle Vault

Comece seguindo o guia oficial da Oracle para configurar um Oracle Vault (com uma chave de criptografia). Em seguida, pesquise por “Secret Management” na sua conta Oracle e abra o serviço. Clique no botão “Create secret”:

No formulário “Create secret”, dê um nome ao seu segredo (por exemplo, “bright-data-api-key-bearer”), selecione seu Oracle Vault e chave de criptografia e, em seguida, escolha a opção “Manual secret generation”. Preencha o valor do segredo usando este formato:

Bearer <BRIGHT_DATA_API_KEY>

Substitua o marcador <BRIGHT_DATA_API_KEY> pela sua chave de API real da Bright Data.

Nota: O prefixo “Bearer” antes da chave de API é obrigatório. Esse é o formato padrão baseado em token a ser definido no cabeçalho Authorization para autenticação nas APIs da Bright Data.

Creating the secret for Bright Data API authentication

Pressione “Create secret” para finalizar a criação do segredo. Agora você deverá ver seu segredo listado na página “Secrets”:

Ótimo! Este segredo será usado para autenticar as requisições feitas pelas ferramentas personalizadas do agente para as APIs da Bright Data.

Passo #3: Adicionar as Políticas IAM Necessárias

Por padrão, o serviço Oracle Generative AI não tem acesso aos segredos armazenados em seu Vault. Para habilitar isso, você deve adicionar a política IAM correta.

Pesquise por “Policies” no Console OCI e abra a página correspondente. Em seguida, clique em “Create Policy”:

No formulário “Create Policy”, dê um nome à sua política (por exemplo, “genaiagent”). Em seguida, clique em “Show manual editor” e cole a seguinte política IAM:

allow any-user to read secret-family in tenancy where any {request.principal.type='genaiagent'}

Esta política permite que qualquer Agente de IA Generativa leia segredos armazenados em instâncias do OCI Vault em todo o tenant, incluindo o segredo “bright-data-api-key-bearer” criado anteriormente.

Clique em “Create” para confirmar a criação da política:

Após a criação, a política aparecerá na página “Policies”:

Como alternativa, você pode seguir o guia oficial para configurar um grupo dinâmico e alcançar o mesmo objetivo.

Muito bem! Agora você tem todos os elementos necessários para criar Agentes de IA Generativa da Oracle que podem se conectar à Bright Data por meio de ferramentas personalizadas.

Passo #4: Inicializar Seu Agente de Acesso à Web

Pesquise por “Agents” e abra a página correspondente no serviço “Generative AI Agents”:

Continue pressionando o botão “Create agent“:

Isso iniciará o assistente de criação do agente. Preencha o formulário da seguinte forma:

Name: Web Access AI Agent
Description: You are a web agent with web access powered by the Bright Data integration
Routing instructions: When asked to search the web, retrieve online data, or scrape web pages, use the Bright Data tools

Em seguida, selecione seu LLM preferido como o cérebro do agente. Neste caso, o modelo padrão Llama 3.3 70B é suficiente.

Perfeito! Clique em “Next” para prosseguir para a seção “Tools” do assistente. Antes de definir as ferramentas de integração com a Bright Data, vamos começar.

Passo #5: Começar com a Unlocker API e a API SERP da Bright Data

É hora de criar a Unlocker API e a API SERP na sua conta Bright Data. Para uma configuração rápida, consulte as páginas de documentação oficiais:

Caso contrário, siga as instruções abaixo.

Se ainda não o fez, crie uma conta Bright Data. Se já tiver uma, faça login e abra o painel de controle:

Em seguida, navegue até “Web Access > Web Access API” no menu à esquerda:

Se você já vir as entradas “Web Unlocker API” e “SERP API” na tabela “My APIs”, você está pronto para continuar:

Se não, clique no menu suspenso do botão Create API e selecione “Unlocker API” (ou “SERP API” se quiser criar essa em vez disso):

Isso iniciará o assistente de configuração da Unlocker/SERP API. Dê um nome à sua API (por exemplo, unlocker_api/serp_api) e configure a API de acordo com suas necessidades:

Quando terminar, clique em “Add API”. A partir de agora, assumiremos que você definiu os seguintes nomes de API:

unlocker_api para a Unlocker API da Bright Data.
serp_api para a API SERP da Bright Data.

Agora você está pronto para definir ferramentas personalizadas de chamada de endpoint de API que se conectam a essas APIs. Excelente!

Passo #6: Criar uma Ferramenta Personalizada para Integração com a Web Unlocker API

Volte ao assistente de criação do Agente de IA Generativa. Na seção Tools, clique em “Add tool”.

Para criar uma ferramenta para integração com a Unlocker API, selecione a opção “Custom tool”. Em seguida, preencha o formulário assim:

Name: Web Unlocker API
Description: An automated web scraping tool that extracts content from web pages and bypasses anti-bot protections

Na seção “Tool configuration”, selecione a opção “API endpoint calling (agent execution)“:

Na seção “Examples”, escolha “None” para começar com uma tela em branco e, em seguida, cole a seguinte especificação OpenAPI:

{
  "openapi": "3.0.4",
  "info": {
    "title": "Bright Data Web Unlocker API",
    "version": "1.0.0",
    "description": "Bright Data Unlocker API enables you to bypass anti-bot measures. It manages proxies and solves CAPTCHAs automatically for easier web data collection.\n\n\[Web Unlocker API documentation\](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)\n"
  },
  "servers": [
    {
      "url": "https://api.brightdata.com"
    }
  ],
  "paths": {
    "/request": {
      "post": {
        "operationId": "sendWebUnlockerRequest",
        "summary": "Send a Web Unlocker API request",
        "description": "Submit a Web Unlocker API request using your Bright Data Web Unlocker API zone.\n\n\[Web Unlocker API `/request` documentation\](https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website)\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["zone", "url", "format"],
                "properties": {
                  "zone": {
                    "type": "string",
                    "description": "Your Web Unlocker zone name.",
                    "default": "unlocker_api"
                  },
                  "url": {
                    "type": "string",
                    "description": "The target website URL to unlock and fetch.",
                    "example": "https://example.com/products"
                  },
                  "format": {
                    "type": "string",
                    "description": "Response format.\nAllowed values:\n- raw: Returns the response immediately in the body.\n- json: Returns the response as a structured JSON object.",
                    "default": "raw"
                  },
                  "method": {
                    "type": "string",
                    "description": "HTTP method used when fetching the target URL.",
                    "example": "GET"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country code for proxy location (ISO 3166-1 alpha-2 format).",
                    "example": "us"
                  }
                }
              }
            }
          }
        },
                "responses": {
          "200": {
            "description": "Successful response containing search results."
          },
          "400": {
            "description": "Invalid request (missing required fields or invalid parameters)."
          },
          "401": {
            "description": "Unauthorized (invalid or missing Bright Data API key)."
          }
        }
      }
    }
  }
}

Isso corresponde à especificação OpenAPI do Web Unlocker da Bright Data. Para mais referências, leia o guia “OpenAPI Specs: AI Integration with SERP & Unlocker APIs“.

Importante: Observe o campo "default": "unlocker_api" sob a propriedade zone. Isso é essencial porque instrui o agente de IA sobre como deve chamar sua Unlocker API da Bright Data. Substitua "unlocker_api" pelo nome real da sua Unlocker API.

Para configurar o método de autenticação, preencha o formulário da seguinte forma:

Authentication type: API key
Key location: Header
Key name: Authorization
Secret value: bright-data-api-key-bearer (ou o nome do seu segredo de chave de API da Bright Data armazenado)
VCN: ai (ou o nome da sua VCN Oracle)
Subnet: private-subnet-ai (Crítico: Selecione uma sub-rede privada, ou todas as chamadas de ferramentas falharão com erros 500)

Isso configura a ferramenta personalizada com o método de autenticação exigido pela Bright Data. Além disso, garante que as chamadas de API para a Unlocker API sejam executadas por meio da sub-rede privada da VCN OCI.

Por fim, clique em “Add tool” para concluir a configuração. A ferramenta de Scraping de dados com a Bright Data estará agora disponível para seu agente. Fantástico!

Passo #7: Criar a Ferramenta de API SERP

Um agente com apenas capacidades de scraping é limitado sem a capacidade de descobrir conteúdo web de forma autônoma. É aqui que a API SERP da Bright Data entra em cena!

Clique em “Add tool” novamente e repita o processo como fez antes. Desta vez, preencha o formulário com:

Name: SERP API
Description: An endpoint that provides real users' search results at high volume across major search engines, including Google

Em seguida, cole a seguinte especificação:

{
  "openapi": "3.0.4",
  "info": {
    "title": "Bright Data SERP API",
    "version": "1.0.0",
    "description": "Extract search engine results using Bright Data SERP API. Extract structured data from major search engines, including Google, Bing, Yandex, DuckDuckGo, and more.  \nGet organic results, paid ads, local listings, shopping results, and other SERP features.\n\[SERP API documentation\](https://docs.brightdata.com/scraping-automation/serp-api/introduction)\n"
  },
  "servers": [
    {
      "url": "https://api.brightdata.com"
    }
  ],
  "paths": {
    "/request": {
      "post": {
        "operationId": "sendSerpRequest",
        "summary": "Send a SERP API request",
        "description": "Submit a SERP API request using your Bright Data SERP API zone.  \n\n\[SERP API `/request` documentation\](https://docs.brightdata.com/api-reference/rest-api/serp/scrape-serp)\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "zone",
                  "url",
                  "format"
                ],
                "properties": {
                  "zone": {
                    "type": "string",
                    "description": "The name of your SERP API zone.",
                    "default": "serp_api"
                  },
                  "url": {
                    "type": "string",
                    "description": "The search engine URL to query (e.g., `https://www.google.com/search?q=<search_query>`).",
                    "example": "https://www.google.com/search?q=pizza&hl=en&gl=us"
                  },
                  "format": {
                    "type": "string",
                    "description": "Response format.  \nAllowed values:  \n- `raw`: Returns the response immediately in the body.  \n- `json`: Returns the response as a structured JSON object.  \n",
                    "default": "raw",
                    "enum": [
                      "raw",
                      "json"
                    ]
                  },
                  "country": {
                    "type": "string",
                    "description": "Country code for proxy location (ISO 3166-1 alpha-2 format). \n",
                    "example": "us"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing search results."
          },
          "400": {
            "description": "Invalid request (missing required fields or invalid parameters)."
          },
          "401": {
            "description": "Unauthorized (invalid or missing Bright Data API key)."
          }
        }
      }
    }
  }
}

Importante: Como enfatizado antes, certifique-se de que o campo default sob a propriedade zone corresponda ao nome da sua API SERP.

Após adicionar esta ferramenta, é isso que você deverá ver:

Nota: De forma similar, você pode conectar todas as outras soluções da Bright Data baseadas em API.

Ótimo! Só falta fazer os ajustes finais.

Passo #8: Finalizar a Criação do Agente

Clique em “Next” para prosseguir para a configuração do endpoint do agente. Isso é necessário para testar o agente. Em seguida, revise todas as informações do agente, clique em “Create agent” e aceite o contrato de licença do Llama 3.

Você será redirecionado de volta à página “Agents”, onde verá uma entrada “Web Access AI Agent” com o status “Creating”. O processo de provisionamento pode levar alguns minutos, então seja paciente.

Após um breve período, o status mudará para “Active”, o que significa que seu Agente de IA Generativa da Oracle com integração Bright Data está pronto!

Passo #8: Testar o Agente

Clique no nome do agente e você será redirecionado para a seguinte página:

Aqui, você pode testar o agente pressionando “Launch chat”.

Certifique-se de que seu agente de IA e o endpoint relevante estejam selecionados e, em seguida, cole um prompt como este:

Search Google for the latest news about SpaceX stock, review the content from the 2,3 most relevant sources, and provide a report summarizing the most important information

Este é um teste ideal porque verifica se a integração com a Bright Data consegue lidar tanto com tarefas de busca na web quanto de scraping.

Na página “Chat”, execute o prompt. Você deverá ver algo assim:

Como você pode perceber, o agente de IA retornou informações contextuais sobre as ações da SpaceX. Como a SpaceX abriu seu capital apenas algumas horas atrás (no momento da escrita), esta é uma informação muito recente.

Um LLM padrão não seria capaz de fornecê-la, pois é treinado em conjuntos de dados estáticos. Para confirmar que as ferramentas da Bright Data foram chamadas (e o resultado não é uma alucinação), expanda o menu suspenso “Traces” e clique no botão “View” à direita.

Aqui, você pode inspecionar o plano e as etapas de execução do agente. Você verá que ele invocou a ferramenta API SERP para uma pesquisa no Google sobre notícias de ações da SpaceX:

Por baixo dos panos, a ferramenta do agente chama a API SERP da Bright Data, que retorna uma versão JSON deste SERP do Google:

A partir das URLs descobertas, o agente seleciona as fontes mais relevantes, faz o scraping delas e agrega todas as informações recuperadas no resultado contextual final.

Et voilà! Este exemplo simples demonstra o quão fundamentado e preciso é o seu agente de IA Generativa da Oracle, graças às capacidades de busca na web e scraping fornecidas pela Bright Data. Agora, experimente diferentes prompts para explorar todos os outros casos de uso empresariais suportados.

Conclusão

Neste tutorial, você aprendeu o que é o serviço de Agentes de IA Generativa da Oracle e os recursos que ele oferece. Você também explorou as limitações dos agentes de IA e como abordá-las em cenários empresariais por meio das APIs da Bright Data.

Você foi guiado pela definição de um Agente de IA Generativa da Oracle com ferramentas personalizadas para chamar os endpoints da Bright Data. O resultado é um agente de IA que pode explorar a web e recuperar informações dela, assim como um humano faria.

Este é apenas um exemplo dos muitos casos de uso habilitados pelas integrações da Bright Data. Se precisar de ajuda com a implementação ou quiser explorar outros cenários possíveis, entre em contato com nossa equipe de suporte disponível 24/7.

Crie uma conta Bright Data gratuitamente hoje e comece a explorar nossas soluções de dados web!

Contate-nos Teste grátis