Si vous débutez avec la recherche par agent, envisagez de suivre le tutoriel Premiers pas avec la recherche personnalisée pour créer un exemple d'application.
Configurez un projet Google Cloud , activez la recherche d'agents et configurez le contrôle des accès pour votre projet. Vous pouvez utiliser un projet Google Cloud existant si vous en avez déjà un.
Actions
- Consultez la section Avant de commencer et vérifiez que vous avez bien suivi la procédure.
Déterminez le type de données que vous rendrez disponibles dans votre application de recherche et préparez-les pour l'importation dans Agent Search.
Vous pouvez baser votre data store sur les types de données suivants :
- Données non structurées Documents (tels que des fichiers PDF, HTML et TXT) stockés dans Cloud Storage. Vous pouvez également fournir des métadonnées dans un fichier JSON ou dans une table BigQuery.
- Données structurées Données fournies avec un schéma spécifique. Par exemple, vous pouvez fournir des données dans une table BigQuery, sous forme de fichiers JSON dans Cloud Storage ou à partir de connecteurs tiers tels que Jira.
Actions
Consultez les informations sur les données acceptées et la relation entre les applications et les data stores dans À propos des applications et des data stores.
Préparez vos données conformément aux exigences décrites dans Préparer les données pour l'ingestion.
Si vous devez configurer le contrôle des accès pour limiter les données que les utilisateurs peuvent consulter dans les résultats de votre application de recherche, consultez les prérequis et suivez les instructions pour votre type de fournisseur d'identité et votre source de données dans Utiliser le contrôle des accès aux sources de données.
Créez un data store, puis importez-y vos données ou configurez un connecteur tiers comme source de données synchronisée.
La procédure d'importation de vos données dépend de leur emplacement. Par exemple, si vos données se trouvent dans Cloud Storage, vous pouvez les importer à l'aide de la console ou de l'API en fournissant l'emplacement du bucket de vos données.
Actions
- Suivez les instructions pour votre source de données dans Créer un data store de recherche.
Créez votre application de recherche personnalisée et associez-la à votre nouveau data store.
Actions
La recherche par agent pour la recherche personnalisée est compatible avec deux modèles de tarification :
- Général : modèle basé sur la consommation avec paiement à l'usage.
- Configurable : modèle de tarification mixte qui vous permet de dissocier les fonctionnalités et de créer un forfait d'abonnement plus adapté à vos cas d'utilisation spécifiques. Ce modèle de tarification vous permet de ne payer que les fonctionnalités dont vous avez besoin et de bénéficier de leurs puissantes capacités. Il propose deux abonnements et des modules complémentaires facultatifs. Une fois ce modèle de tarification activé au niveau du projet, vous pouvez sélectionner la tarification configurable pour vos applications et vos data stores.
Actions
Par défaut, un projet est défini sur le modèle de paiement à l'usage. Toutefois, pour passer à la tarification configurable, procédez comme suit :
- Suivez les instructions pour configurer une tarification configurable pour la recherche personnalisée.
La recherche par l'agent propose de nombreuses options de configuration. Certaines options dépendent de votre intention de déployer un widget de recherche.
Actions
Selon votre cas d'utilisation et que vous prévoyiez de déployer le widget de recherche prêt à l'emploi ou d'intégrer des appels d'API de recherche dans votre propre code, Agent Search propose plusieurs options de configuration.
Vous pouvez intégrer un widget de recherche à votre site Web. Le widget fournit automatiquement une barre de recherche et une interface de recherche pouvant être développée. Si vous prévoyez de déployer le widget de recherche, configurez les éléments suivants :
Résultats du widget Recherche : Pour en savoir plus, consultez Configurer les résultats du widget Recherche.
Facettes du widget Recherche (preview) Consultez Configurer les facettes du widget Recherche.
Si vous prévoyez d'intégrer des appels d'API de recherche à votre serveur ou application au lieu d'utiliser le widget, vous pouvez configurer vos paramètres de recherche à l'aide des options suivantes :
Paramètres de champ : Pour les données structurées ou les données non structurées avec métadonnées, mettez à jour les paramètres des champs afin de préciser comment la recherche par agent utilise les métadonnées pour la recherche. Consultez Configurer les champs pour la recherche.
Saisie semi-automatique En fonction de vos données, configurez des suggestions de saisie semi-automatique basées sur le contenu des documents, les champs, l'historique des recherches ou les événements utilisateur. Consultez Configurer la saisie semi-automatique.
Commandes de diffusion : Contrôlez quand les résultats de recherche sont mis en avant, enfouis, filtrés ou redirigés, ou si certaines requêtes sont associées à d'autres. Consultez Configurer les contrôles de diffusion.
Optimisation de la recherche (version Preview) Ajustez le modèle de recherche avec vos propres données d'entraînement. Consultez Améliorer les résultats de recherche grâce à l'optimisation de la recherche.
Représentations vectorielles continues personnalisées (aperçu) : Si vous avez créé vos propres embeddings, vous préférerez peut-être les utiliser au lieu de ceux générés par la recherche d'agents pour enrichir vos recherches avec du contexte supplémentaire. Cette fonctionnalité est disponible pour les data stores contenant des données structurées ou des données non structurées avec des métadonnées. Consultez Utiliser des embeddings personnalisés.
Si vous prévoyez de déployer votre application en intégrant des appels d'API de recherche dans votre propre code, Agent Search propose des options supplémentaires pour configurer la façon dont vos résultats de recherche sont renvoyés.
Actions
Configurez vos résultats de recherche à l'aide des options suivantes :
- Filtrez la recherche personnalisée pour les données structurées ou non structurées.
- Obtenez des extraits, des réponses extractives ou des segments extractifs. Consultez Obtenir des extraits et du contenu extrait.
Vous pouvez prévisualiser vos résultats de recherche pour vérifier si les configurations de votre application fonctionnent comme prévu.
Actions
Pour prévisualiser vos résultats de recherche, utilisez la console ou l'API.
Console Utilisez la page Prévisualiser de la console Agent Search pour prévisualiser l'impact des configurations du widget de recherche sur vos résultats. Consultez les instructions de la console dans Obtenir des résultats de recherche.
API : Si vous intégrez des appels d'API à votre application, effectuez des appels d'API pour prévisualiser vos configurations de recherche. Consultez les instructions REST dans Obtenir les résultats de recherche.
Lorsque vous êtes satisfait de la version d'aperçu de votre application de recherche, partagez-la avec vos utilisateurs en la déployant sur votre site Web.
Actions
Vous pouvez déployer votre application de recherche de l'une des manières suivantes :
Intégrez le widget de recherche à votre site Web. La recherche d'agent fournit du code que vous pouvez copier dans votre site Web ou votre application Web. Cela déploie le widget Recherche. Vous pouvez prévisualiser les résultats de recherche dans la console. Consultez Ajouter le widget de recherche à une page Web.
Intégrez les appels d'API de recherche à votre serveur ou application. Pour contrôler entièrement l'affichage de vos résultats de recherche, vous pouvez intégrer des appels d'API à votre serveur ou à vos applications. Pour en savoir plus sur l'envoi d'appels d'API, consultez Obtenir des résultats de recherche. Pour les ressources de la bibliothèque cliente, consultez Bibliothèques clientes Agent Search.
Pour obtenir des résultats de recherche et de navigation personnalisés, vous pouvez mettre à jour les événements utilisateur dans votre application de recherche. Pour en savoir plus, consultez À propos des événements utilisateur pour les applications personnalisées.
Actions
Vous pouvez gérer votre application pour vous assurer que les données les plus récentes et nécessaires sont disponibles dans votre data store.