Selecionar Agente de IA para Python

Use o submódulo select_ai.agent para criar e gerenciar ferramentas, tarefas, agentes e equipes do agente de IA no banco de dados em Python.

Selecione AI Agent for Python builds na biblioteca cliente select_ai e no pacote DBMS_CLOUD_AI_AGENT. Ele suporta workflows de agente síncronos e assíncronos no Autonomous AI Database.

Plataformas com Suporte

Para plataformas Select AI para Python suportadas, consulte Plataformas Suportadas.

Relate problemas de produtos no repositório Select AI for Python GitHub.

Instalar Selecionar Agente AI para Python

Instale o pacote Select AI for Python com pip:

python3 -m pip install select_ai

As classes do Agente AI selecionadas são incluídas no submódulo select_ai.agent.

Gerenciar Privilégios do Banco de Dados

A opção Selecionar AI Agent para Python requer acesso ao pacote de banco de dados DBMS_CLOUD_AI_AGENT. Use as seguintes APIs para conceder ou revogar privilégios de pacote de banco de dados:

select_ai.grant_privileges(...)
select_ai.revoke_privileges(...)

Para obter informações sobre privilégio, acesso HTTP e gerenciamento de acesso à rede de host externo, consulte Gerenciar Privilégios de Banco de Dados e Acesso à Rede.

O Que Você Pode Fazer

A tabela a seguir resume os principais recursos Select AI Agent for Python:

Classes Suportadas

A tabela a seguir resume as classes Select AI Agent para Python principais:

Trabalhar com Ferramentas

Use ferramentas para fornecer recursos que um agente pode chamar ao processar uma tarefa. Você pode criar SQL, pesquisa na Web, Geração Aumentada de Recuperação, PL/SQL, notificação do Slack e ferramentas de notificação por e-mail.

As APIs de criação de ferramentas suportam o parâmetro instruction. Use este parâmetro para definir o comportamento preciso de execução da ferramenta.

As ferramentas de pesquisa e notificação da Web exigem credenciais e acesso de rede para o serviço externo. As ferramentas SQL e RAG exigem perfis Select AI existentes.

Trabalhando com Tarefas

Use tarefas para definir o trabalho que um agente executa e as ferramentas que o agente pode usar. Configure os atributos instruction e tools para controlar como o agente processa as solicitações.

Você pode usar o atributo input opcional para fazer com que uma tarefa dependa da saída de uma tarefa anterior.

Trabalhe com agentes

Use agentes para associar uma função e um perfil de IA. O perfil fornece o modelo que o agente usa para planejamento e raciocínio, enquanto a função define o comportamento pretendido do agente.

Trabalhar com Equipes de Agentes

Use equipes para montar e executar vários agentes de forma programática. Uma equipe combina agentes com tarefas e suporta fluxos de trabalho agênticos nos quais agentes especializados se coordenam para concluir uma solicitação.

Defina o atributo process da equipe como sequential para executar atribuições de tarefa na ordem. Reutilize um agente em várias entradas de equipe quando esse agente precisar executar várias tarefas.

Use Team.run(...) para iniciar um workflow de equipe. O argumento prompt é passado para a tarefa e pode ser referenciado nas instruções da tarefa com {query}.

Exportar e Importar Equipes do Agente

O Select AI for Python 1.4 adiciona APIs síncronas e assíncronas para exportar e importar equipes de agentes de IA. Uma especificação de equipe inclui a composição da equipe e as definições de agente, tarefa e ferramenta relacionadas.

APIs síncronas:

Team.export_team(...)
Team.import_team(...)

APIs Assíncronas:

AsyncTeam.export_team(...)
AsyncTeam.import_team(...)

Team.export_team() retorna uma especificação JSON por padrão. Team.import_team() aceita essa especificação JSON ou um mapeamento Python contendo a definição da equipe. Especifique team_name para importar uma equipe com um novo nome.

Para gravar uma especificação no armazenamento de objetos ou importar uma do armazenamento de objetos, forneça object_storage_credential_name e location. Defina force=True para substituir ferramentas, tarefas, agentes ou equipes conflitantes ao importar.

Para obter os detalhes completos da versão, consulte python-select-ai v1.4.0.

Recuperar e Atualizar Objetos Existentes

O Select AI Agent for Python fornece métodos consistentes para recuperar e atualizar objetos de proxy suportados pelo banco de dados:

Esses métodos fornecem uma maneira consistente de trabalhar com ferramentas, tarefas, agentes, equipes e outros objetos de proxy suportados.

Excluir Objetos com Métodos de Classe

Use métodos de exclusão em nível de classe quando um aplicativo precisar excluir um objeto sem primeiro criar ou extrair um objeto de proxy.

Agent.delete_agent(agent_name)
Task.delete_task(task_name)
Tool.delete_tool(tool_name)
Team.delete_team(team_name)

Usar APIs Síncronas e Assíncronas

O Select AI Agent for Python fornece APIs síncronas e assíncronas para suas operações principais.

A tabela a seguir mapeia classes síncronas para seus equivalentes assíncronos:

Use APIs assíncronas em aplicativos que:

• Processe vários workflows do agente simultaneamente.
• Use um loop de eventos.
• Integre com frameworks Python assíncronos.
• Deve evitar o bloqueio enquanto aguarda as operações do banco de dados.

Para obter a referência de API assíncrona completa, consulte a Referência de API Select AI for Python.

Recursos Relacionados

• Selecionar IA para Python
• Selecionar AI para Referência de API Python
• Selecionar Repositório AI Python GitHub
• Relatar um Problema