Documentação do Oracle Cloud Infrastructure

Gerenciando Ferramentas de Chamada de Ponto Final de API em Agentes de IA Generativa

Uma ferramenta de chamada de ponto final de API é uma ferramenta personalizada em Generative AI Agents que permite integrar e chamar com segurança APIs OCI e suas próprias APIs REST. Somente conexões HTTPS (protegidas) são permitidas pelos Generative AI Agents.

Usando ferramentas de chamada de ponto final de API, você pode tornar um agente uma extensão avançada de suas APIs existentes e lógica de negócios sem integrações personalizadas ou alterações em seus sistemas de backend. Por meio de um esquema OpenAPI submetido a upload que descreve a estrutura e o comportamento das operações de API, os Agentes de IA Generativa podem selecionar e chamar dinamicamente o ponto final e o método de API apropriados durante um chat em linguagem natural.

As APIs podem ser hospedadas em redes públicas ou privadas. Todo o tráfego HTTP público ou privado de saída é roteado por meio de uma sub-rede na sua rede virtual na nuvem (VCN) do OCI. As operações de API podem ser solicitadas com autenticação ou sem usar um método de autenticação e, em seguida, executadas dentro das regras de limite e segurança da sua rede.

Ao adicionar ferramentas de chamada de ponto final de API a um agente em Agentes de IA Generativa, o agente pode chamar APIs existentes para executar tarefas como recuperar dados do cliente, atualizar status de pedidos, acionar workflows ou verificar o inventário. Por exemplo, um agente de suporte pode resolver um ticket pesquisando uma conta de usuário e iniciando um reembolso, tudo por meio de chamadas de API.

Antes de Começar

Antes de criar uma ferramenta de chamada de ponto final de API, verifique as Diretrizes da Ferramenta de Chamada de Ponto Final de API e conclua as tarefas necessárias.

Gerenciar Ferramentas de Chamada de Ponto Final da API

Se você tiver permissões manage para genai-agent-family, poderá criar e gerenciar ferramentas de chamada de ponto final de API em Agentes de IA Generativa. Consulte os seguintes links:

Consulte o exemplo em API Endpoint Calling with SDKs in Generative AI Agents para saber como criar e chamar uma ferramenta de chamada de ponto final de API usando o OCI Java SDK.