Comparando ADK e SDK
Saiba quando usar o OCI ADK e o OCI SDK para criar agentes no serviço OCI Generative AI Agents.
Observação: O OCI ADK é fornecido como um complemento ao OCI Python SDK e é liberado em alinhamento com o ciclo de release do OCI SDK.
Nesta página, "OCI SDK" refere-se ao uso das APIs SDK de baixo nível do OCI Generative AI Agents Service, em vez de usar as APIs do ADK.
Sobre o SDK
O OCI SDK fornece APIs de baixo nível para interagir com serviços do OCI, como o serviço Generative AI Agents.
O OCI ADK foi desenvolvido com base no OCI SDK. Para conseguir o que o ADK pode fazer por você usando o OCI SDK bruto, você precisa escrever muito mais código.
Quando utilizar o ADK
Dica: Recomendamos que você use o ADK para desenvolver agentes, exceto se o seu caso de uso for um dos cenários descritos na seção quando usar o OCI SDK.
O OCI ADK fornece APIs de alto nível para criar agentes, oferecendo uma experiência de desenvolvedor semelhante a outras estruturas de agentes.
Com o OCI ADK, você pode se concentrar em lógica ágil personalizada para os negócios, em vez de escrever código padronizado e gerenciar detalhes de integração.
Por exemplo, em vez de gastar horas desenvolvendo um agente de chamada de funções personalizado com o OCI SDK, você pode criar esse agente em minutos usando o ADK.
Quando usar o SDK
Há alguns cenários em que você deve usar o OCI SDK diretamente.
- Você gostaria de criar programaticamente um agente, um ponto final do agente ou uma base de conhecimento. Esses recursos exigem provisionamento de infraestrutura e estão fora do escopo do ADK.
- Você está usando uma linguagem de programação não suportada pelo ADK, como Go, .NET e Ruby. O ADK suporta Python.
- Seu caso de uso requer ferramentas não suportadas no ADK, como a Ferramenta SQL.
Dica: Você não pode criar um agente com o ADK. Primeiro, crie um agente e um ponto final de agente usando o OCI SDK ou a Console. Em seguida, use o ADK para configurar ferramentas para o agente e executar o agente. Recomendamos essa abordagem para criar agentes no serviço OCI Generative AI Agents.