Pour interroger un moteur de raisonnement, vous devez d'abord disposer d'une instance de moteur de raisonnement.
Vous pouvez créer une instance ou obtenir une instance existante d'un moteur de raisonnement. Le reste de cette section suppose que vous disposez d'une instance nommée remote_app.
La commande suivante fournit une liste de schémas au format JSON correspondant aux opérations de l'objet remote_app :
remote_app.operation_schemas()
Voici un exemple de liste de schémas :
[
{
'description': 'Retrieves the exchange rate between two currencies on a specified date.\n'
'\n'
'Uses the Frankfurter API (https://api.frankfurter.app/) to obtain exchange rate data.\n'
'\n'
'Args:\n'
' currency_from: The base currency (3-letter currency code).\n'
' Defaults to "USD" (US Dollar).\n'
' currency_to: The target currency (3-letter currency code).\n'
' Defaults to "EUR" (Euro).\n'
' currency_date: The date for which to retrieve the exchange rate.\n'
' Defaults to "latest" for the most recent exchange rate data.\n'
' Can be specified in YYYY-MM-DD format for historical rates.\n'
'\n'
'Returns:\n'
' dict: A dictionary containing the exchange rate information.\n'
' Example: {"amount": 1.0, "base": "USD", "date": "2023-11-24",\n'
' "rates": {"EUR": 0.95534}}',
'name': 'LangchainApp_query',
'parameters': {
'type': 'object',
'properties': {
'currency_from': {'type': 'string'},
'currency_to': {'type': 'string'},
'currency_date': {'type': 'string'},
},
'required': [],
},
}
]
Pour interroger le moteur de raisonnement, utilisez la méthode .query(). Pour éviter toute ambiguïté, spécifiez chaque argument par son nom.
SDK Vertex AI pour Python
La commande suivante est un exemple de requête du moteur de raisonnement :
remote_app = reasoning_engines.ReasoningEngine("projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID")
response = remote_app.query(input="What is the exchange rate from US dollars to Swedish currency?")
REST
La commande suivante est un exemple de requête du moteur de raisonnement :
curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://us-central1-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query -d '{
"input": {
"input": "What is the exchange rate from US dollars to Swedish currency?"
}
}'
La réponse à la requête est une chaîne semblable à la sortie d'un test d'application locale :
{"input": "What is the exchange rate from US dollars to Swedish currency?",
# ...
"output": "For 1 US dollar you will get 10.7345 Swedish Krona."}