Inicio rápido: SDK de Bing Entity Search con PythonQuickstart: Bing Entity Search SDK with Python

Use este inicio rápido para empezar a buscar entidades con el SDK de Bing Entity Search para Python.Use this quickstart to begin searching for entities with the Bing Entity Search SDK for Python. Aunque Bing Entity Search tiene una API REST compatible con la mayoría de los lenguajes de programación, el SDK proporciona una forma sencilla de integrar el servicio en sus aplicaciones.While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. El código fuente de este ejemplo está disponible en GitHub.The source code for this sample can be found on GitHub.

Requisitos previosPrerequisites

Se recomienda utilizar un entorno virtual de Python.It is recommended that you use a python virtual environment. Puede instalar e inicializar un entorno virtual con el módulo venv.You can install and initialize a virtual environment with the venv module. Puede instalar virtualenv con:You can install virtualenv with:

python -m venv mytestenv

Instale el SDK de Bing Entity Search con:Install the Bing Entity Search SDK with:

cd mytestenv
python -m pip install azure-cognitiveservices-search-entitysearch

Debe tener una cuenta de Cognitive Services API con acceso a Bing Search APIs.You must have a Cognitive Services API account with access to the Bing Search APIs. Si no tiene una suscripción de Azure, puede crear una cuenta gratuita.If you don't have an Azure subscription, you can create an account for free. Antes de continuar, necesitará la clave de acceso que se le proporcionó al activar la versión de evaluación gratuita o puede usar una clave de suscripción de pago desde el panel de Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Creación e inicialización de la aplicaciónCreate and initialize the application

  1. Cree un archivo de Python en el IDE o editor que prefiera y agregue las siguientes instrucciones de importación.Create a new Python file in your favorite IDE or editor, and add the following import statements.

    from azure.cognitiveservices.search.entitysearch import EntitySearchAPI
    from azure.cognitiveservices.search.entitysearch.models import Place, ErrorResponseException
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Cree una variable para su clave de suscripción y cree una instancia del cliente, para lo que debe crear un nuevo objeto CognitiveServicesCredentials con ella.Create a variable for your subscription key, and instantiate the client by creating a new CognitiveServicesCredentials object with it.

    subscription_key = "YOUR-SUBSCRIPTION-KEY"
    client = EntitySearchAPI(CognitiveServicesCredentials(subscription_key))
    

Envío de una solicitud de búsqueda y recepción de la respuestaSend a search request and receive a response

  1. Envíe una solicitud de búsqueda a Bing Entity Search con client.entities.search() y una consulta de búsqueda.Send a search request to Bing Entity Search with client.entities.search() and a search query.

    entity_data = client.entities.search(query="Gibralter")
    
  2. Si se devuelven entidades, convierta entity_data.entities.value en una lista e imprima el primer resultado.If entities were returned, convert entity_data.entities.value to a list, and print the first result.

    if entity_data.entities.value:
    
        main_entities = [entity for entity in entity_data.entities.value
                         if entity.entity_presentation_info.entity_scenario == "DominantEntity"]
    
        if main_entities:
            print(main_entities[0].description)
    

Pasos siguientesNext steps