Neste artigo, você aprenderá:
- O que é o Serviço de Agentes de IA Generativa da Oracle e o que ele oferece.
- Por que agentes de IA empresariais precisam de acesso a dados da 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 tecnologia 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 entendem linguagem natural, retêm contexto de conversas, orquestram ferramentas, acessam dados empresariais e automatizam 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 viagem.
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 humanizadas com interações contextuais em múltiplas mensagens.
- Retenção de contexto: Lembra turnos anteriores da conversa para fornecer respostas personalizadas, consistentes e relevantes.
- Instruções personalizadas: Define 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 sensíveis de PII.
- Suporte a humano no loop: Permite revisão e intervenção humana para ações sensíveis e operações críticas para o negócio.
- 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: Estende 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 o negócio, 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 da web atualizado.
- Acesso limitado a sites: Muitos sites empregam tecnologias anti-bot que impedem sistemas automatizados de coletar dados.
Essas restriçõ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.
Bright Data como a Solução
Bright Data é a principal plataforma de dados da web de nível empresarial, pronta para IA. Ela permite coletar, estruturar e analisar dados públicos da web em escala de forma ética, graças a um conjunto abrangente de produtos.
Esses incluem:
- Unlocker API: Contorna CAPTCHAs, sistemas anti-bot e bloqueios de sites para recuperar dados de qualquer página da web.
- API SERP: Fornece resultados estruturados e em tempo real de mecanismos de busca como Google, Bing, Yandex e outros principais buscadores.
- Discover API: Retorna uma lista classificada por IA de URLs relevantes da web em tempo real, prontos para processamento adicional.
- Crawl API: Suporta rastreamento de sites em grande escala e extração automatizada de dados.
- Scraper APIs: Fornecem extração de dados estruturados 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 em 195 países. Essa infraestrutura permite coleta de dados da web altamente escalável e geograficamente distribuída, com uma taxa de sucesso de 98,50% e uptime de 99,99% garantido por SLA. Também é compatível 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 resulta em 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 se 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 fundamentar suas respostas de forma autônoma em dados da 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.
Etapa #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.
Depois que a VCN for criada, 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 seu tráfego HTTP.
Etapa #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 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 das APIs da Bright Data.
Pressione “Create secret” para finalizar a criação do segredo. Agora você deverá ver seu segredo listado na página “Secrets”:
Ótimo! Esse segredo será usado para autenticar as solicitações feitas pelas ferramentas personalizadas do agente às APIs da Bright Data.
Etapa #3: Adicionar as Políticas IAM Necessárias
Por padrão, o serviço Oracle Generative AI não tem acesso a segredos armazenados no 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'}Essa política permite que qualquer Agente de IA Generativa leia segredos armazenados em instâncias do OCI Vault em toda a tenancy, 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 para atingir 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.
Etapa #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 de 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 da Bright Data, vamos dar início ao processo.
Etapa #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 oficial:
Caso contrário, siga as instruções abaixo.
Se ainda não tiver feito isso, 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 entradas de “Web Unlocker API” e “SERP API” na tabela “My APIs”, você está pronto para continuar:
Caso contrário, 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, vamos assumir que você definiu os seguintes nomes de API:
unlocker_apipara a Bright Data Unlocker API.serp_apipara a Bright Data API SERP.
Agora você está pronto para definir ferramentas personalizadas de chamada de endpoint de API que se conectam a essas APIs. Excelente!
Etapa #6: Criar uma Ferramenta Personalizada para Integração com a Web Unlocker API
Volte ao assistente de criação de 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 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 “Especificações OpenAPI: Integração de IA com APIs SERP e Unlocker“.
Importante: Observe o campo "default": "unlocker_api" sob a propriedade zone. Isso é essencial porque instrui o agente de IA sobre como chamar sua Bright Data Unlocker API. 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 ferramenta falharão com erros500)
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 tecnologia Bright Data agora estará disponível para o seu agente. Fantástico!
Etapa #7: Criar a Ferramenta de API SERP
Um agente apenas com capacidades de scraping é limitado sem a habilidade de descobrir conteúdo da 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 anteriormente, 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 semelhante, você pode conectar todas as outras soluções Bright Data baseadas em API.
Ótimo! Resta apenas fazer os ajustes finais.
Etapa #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, portanto, seja paciente.
Após um curto 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!
Etapa #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 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 informationEste é um teste ideal porque verifica que a integração Bright Data pode lidar com tarefas de busca na web e 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 capital apenas algumas horas atrás (no momento da redação), essa é 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:
Nos bastidores, 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 prompts diferentes para explorar todos os outros casos de uso empresariais suportados.
Conclusão
Neste tutorial, você aprendeu o que é o serviço Oracle Generative AI Agents 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 endpoints da Bright Data. O resultado é um agente de IA que pode explorar a web e recuperar informações dela, muito 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 24/7.
Crie uma conta Bright Data gratuitamente hoje e comece a explorar nossas soluções de dados da web!
