Seleccionar IA para Python
select_ai, que permite utilizar las capacidades DBMS_CLOUD_AI en Autonomous AI Database desde Python. Select AI for Python admite flujos de trabajo de IA generativa mejorados, resúmenes, mecanismos de retroalimentación, gestión de metadatos coherente y capacidades de IA ágentes. También es compatible con Python 3.14 e incluye un sitio de documentación HTML actualizado (Nuevo)
Acciones que Puede Realizar
-
NL2SQL: utilice el lenguaje natural para consultar la base de datos mediante la generación de SQL basada en IA. Esto incluye la generación de consultas SQL, la ejecución de las consultas generadas, la explicación del SQL generado y la narración de los resultados de las consultas.
-
RAG: Crea y actualiza índices vectoriales para flujos de trabajo automatizados de generación aumentada de recuperación (RAG) que recuperan contenido relevante e lo incluyen en respuestas de IA generativa.
Puede supervisar los ciclos de refrescamiento mediante
vector_index.get_next_refresh_timestamp()para recuperar el registro de hora UTC del siguiente refrescamiento programado. -
Chat: Crea y gestiona conversaciones con un historial rápido para admitir interacciones de estilo chat con modelos de IA generativa.
-
Generación de datos sintéticos: genera datos sintéticos para pruebas y análisis mediante IA generativa
-
Resumir: Resumir texto o resultados de consulta
-
Comentarios: Registre y gestione los comentarios del modelo
-
Traducir: Traducir texto entre idiomas
-
Agentes de IA: crea agentes de IA autónomos e interactivos. Consulte Seleccionar agente de AI para Python para obtener más información.
-
Sincronización y conexiones asíncronas: conéctese a la base de datos mediante conexiones síncronas o asíncronas
Puede utilizar
select_ai.create_pool()yselect_ai.create_pool_async()para crear pools de conexiones compartidas a fin de mejorar la simultaneidad y el uso compartido de recursos. -
Perfiles de IA: crea y gestiona perfiles de IA para permitir el uso de modelos de IA de una amplia gama de proveedores de IA
Plataformas soportadas
Select AI for Python está certificado para Autonomous AI Database 26ai y 19c. Seleccionar AI para Python puede funcionar en otras plataformas, sin embargo, no está certificado.
Haga clic en https://github.com/oracle/python-select-ai/issues para informar los problemas.
Funciones admitidas para seleccionar perfil de AI (sincrónico y asíncrono)
Cuando envía peticiones de datos a través de un perfil, puede elegir entre varias funciones definidas para los objetos de perfil AI. Algunos son los siguientes:
-
create(): cree el perfil AI en la base de datos o reemplácelo si es necesario. Consulte la documentación de GitHub decreate(). -
delete(): elimine el perfil. Consulte la documentación delete() GitHub. -
generate(): utilice el perfil para procesar una petición de datos según la acción seleccionada. Consulte la documentación de Generete() GitHub -
generate_synthetic_data(): cree datos sintéticos basados en los atributos proporcionados. Consulte la documentación de GitHub de generate_synthetic_data(). -
get_attributes(): devuelve los atributos de perfil actuales. Consulte la documentación de GitHub deget_attributes(). -
run_sql(): genere y ejecute SQL (por defecto). Consulte la documentación de GitHub de run_sql(). -
show_sql(): genere SQL sin ejecutarlo. Consulte la documentación de GitHub de show_sql(). -
explain_sql(): proporcione una explicación del SQL generado. Consulte la documentación de GitHub de EXPLain_sql(). -
narrate(): describe los resultados de la consulta en lenguaje natural. Consulte narrate() en la documentación de GitHub. -
chat(): participe en una conversación de formato libre. Consulte la documentación de GitHub de chat(). -
show_prompt(): muestra la petición de datos creada enviada al modelo de IA generativa. Consulte la documentación de GitHub de show_prompt(). -
summarize(): genere un resumen del contenido proporcionado. Consulte la documentación de GitHub de resumen(). -
add_positive_feedback(),add_negative_feedback(),delete_feedback(): gestione los comentarios de usuario asociados a las consultas generadas. Consulte la documentación de GitHub de add_positive_feedback(), add_negative_feedback() y delete_feedback(). translate(): traduce texto de un idioma de origen especificado a un idioma de destino. Consulte la documentación de GitHub de transllate().
Para obtener una lista completa de funciones, consulte la guía Seleccionar AI para Python. Consulte también Uso de palabra clave AI para introducir peticiones de datos para obtener más información sobre las acciones Seleccionar AI.
Clases Soportadas
La biblioteca incluye clases para gestionar proveedores, perfiles, conversaciones, índices vectoriales, datos sintéticos y flujos de trabajo dinámicos. Tanto las versiones síncronas como las asíncronas están disponibles.
-
Clases de proveedor: defina el proveedor de AI:
OpenAIProvider,AzureProvider,OCIGenAIProvider,AWSProvider,GoogleProvider,AnthropicProvider,CohereProvider,HuggingFaceProvider. -
Profile: define el perfil de IA generativa para procesar peticiones de datos (proveedor, credenciales, metadatos, opciones) y admite la generación de datos sintéticos. -
ProfileAttributes: detalles de configuración de perfil, como proveedor, nombre de credencial, tokens máximos, temperatura, lista de objetos o índice de vector. -
ConversationAttributes: gestionar el contexto conversacional entre peticiones de datos. -
VectorIndexyVectorIndexAttributes: crear y gestionar índices vectoriales para RAG.La API
create()soporta un parámetrowait_for_completion. Utilice este parámetro para controlar si la llamada espera la finalización antes de volver. Para obtener más información, consulte Procedimiento CREATE_VECTOR_INDEX para obtener más información. -
SyntheticDataAttributes: crea conjuntos de datos sintéticos para pruebas y desarrollo. -
Métodos de supresión de nivel de clase: estos métodos de nivel de clase suprimen los objetos de base de datos directamente sin necesidad de inicializar un objeto proxy.
-
Profile.delete_profile(profile_name) -
VectorIndex.delete_index(index_name)
Para ver los métodos de supresión de nivel de clase relacionados con Seleccionar agente de AI, consulte Seleccionar agente de AI para Python.
-
Existen equivalentes asíncronos para las clases Profile, Conversation y VectorIndex.
Compatibilidad con selección de IA asíncrona
Select AI for Python proporciona API asíncronas que permiten la interacción con la base de datos de IA autónoma. Estas API utilizan las construcciones async y await de Python y soportan aplicaciones basadas en coroutine.
-
AsyncProfile -
AsyncConversation -
AsyncVectorIndex
Utilice select_ai.create_pool_async() para gestionar conexiones en flujos de trabajo asíncronos.
Estas clases proporcionan una funcionalidad equivalente a sus homólogos síncronos. Las API asíncronas son útiles en aplicaciones que requieren operaciones simultáneas o flujos de trabajo controlados por eventos.
Para obtener una referencia completa de la API, consulte la guía Select AI for Python.
Mejoras en la actualización de API y atributos
Están disponibles las siguientes mejoras:
-
Todos los objetos de proxy soportan
fetch()para recuperar objetos existentes. -
Todos los objetos de proxy proporcionan
set_attribute()yset_attributes()para actualizaciones consistentes -
Todas las API de creación de herramientas soportan un parámetro
instructionpara definir un comportamiento de ejecución preciso.
Privilegio y acceso HTTP
La gestión de privilegios es independiente de la configuración de acceso HTTP.
API de privilegios:
select_ai.grant_privilegesselect_ai.revoke_privileges
DBMS_CLOUDDBMS_CLOUD_AIDBMS_CLOUD_AI_AGENTDBMS_CLOUD_PIPELINE
API de acceso HTTP:
select_ai.grant_http_accessselect_ai.revoke_http_access
Otras mejoras
-
Compatibilidad con Python 3.14
-
Nuevo sitio de documentación HTML en GitHub con el tema de documentos de Python: GitHub Seleccionar AI para documentación de Python
-
Instalación para la versión 1.2.2:
pip install select_ai