Rainbird (préversion)
Rainbird est une plateforme d’automatisation intelligente sans code qui vous permet d’automatiser des décisions complexes. Ce connecteur vous permet d’interagir avec les cartes de connaissances que vous avez créées dans Rainbird.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Rainbird Technologies Ltd |
| URL | https://rainbird.ai/contact-us/ |
| Messagerie électronique | support@rainbird.zohodesk.eu |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Rainbird Technologies ltd |
| Site web | https://rainbird.ai/ |
| Politique de confidentialité | https://rainbird.ai/privacy-policy/ |
| Catégories | IA; Informatique décisionnelle |
Rainbird permet à votre organisation d’automatiser la prise de décision complexe à grande échelle. Tirez parti de votre propre expertise des PME pour encoder leur logique de prise de décision dans notre studio sans code, puis connectez-vous à votre flux de travail pour fournir des décisions de haute qualité, performantes et auditables qui vous permettent de créer des solutions de bout en bout entièrement automatisées.
Pour plus d’informations, visitez le site web de Rainbird .
Prerequisites
Pour utiliser ce connecteur, vous devez accéder à un compte Rainbird.
Vous pouvez vous inscrire maintenant pour accéder à un compte de communauté gratuit : inscription. Pour les comptes Premium, contactez-nous : Contactez-nous.
Comment obtenir des informations d’identification
Pour utiliser ce connecteur, vous aurez besoin des éléments suivants : clé -API (ApiKey) -Knowledge ID de carte (KmID)
Le ApiKey et le KmID se trouve dans le Rainbird Studio.
- Connectez-vous à votre compte
- Ouvrez votre carte de connaissances (ou créez-en une si nécessaire)
- Accédez à la page « Publier »
Il ApiKey sera nécessaire de s’authentifier auprès de Rainbird. Lors de l’authentification, utilisez votre ApiKey nom d’utilisateur, vous n’avez pas besoin d’un mot de passe (entrez un caractère si un mot de passe est requis).
Pour plus d’informations, consultez la documentation de Rainbird .
Bien démarrer avec votre connecteur
Dans n’importe quel scénario dans lequel vous souhaitez automatiser une décision avec Rainbird, vous devez effectuer les opérations suivantes :
-Démarrer une session sur la carte des connaissances que vous souhaitez utiliser -Provide données à votre session (facultatif) -Query Rainbird dans votre session
Rainbird répond avec une question si plus d’informations sont requises, que vous pouvez répondre à l’aide de l’opération Response , ou un résultat est fourni.
Comment démarrer une session :
Toute décision commence par une Start opération pour démarrer une session et obtenir le SessionID.
Dans l’opération Start , indiquez votre KmID pour générer un SessionID. Vous devez ensuite utiliser cet ID avec d’autres opérations pour interagir avec votre carte de connaissances au sein de la même session.
Comment fournir des données par lots à votre session :
Utilisez une Inject opération avant d’interroger pour fournir les données requises pour prendre une décision.
Comment effectuer une requête :
Pour effectuer une requête, utilisez l’opération Query pour fournir l’ID de session, le nom de la relation et l’objet/objet de la relation.
Visitez la documentation de Rainbird pour consulter des exemples de cette demande.
Comment répondre à une question
Utilisez l’opération Response pour répondre à toute question retournée par Rainbird. L’opération et Response l’opération Query retournent une question demandant plus d’informations ou un résultat. La boucle question/réponse est récursive jusqu’à ce que Rainnbird ait suffisamment d’informations pour fournir un résultat.
Pour plus d’informations sur le flux de demande, consultez la documentation de Rainbird .
Problèmes connus et limitations
La configuration actuelle du connecteur ne permet pas aux utilisateurs d’utiliser la clé de sécurité pour l’opération de preuve. Si un utilisateur souhaite utiliser l’opération de preuve, il devra s’assurer que la sécurité des preuves est désactivée dans Rainbird Studio, dans la section Publier de chaque carte.
Erreurs courantes et solutions
Utilisation de la variable d’environnement incorrecte :
-Code d’erreur : cette erreur peut générer différents messages d’erreur tels que Session ID not found ou 401: Unauthorized.
-Résolution : chaque opération doit être effectuée sur l’environnement approprié (celui lié à votre compte). Vérifiez que chaque étape correspond à votre environnement.
### Utilisation de la structure de données incorrecte.
-Code d’erreur : 400: bad request -Résolution : cela peut être dû à des incompatibilités de données. Lisez les détails de l’erreur pour obtenir plus de contexte et vérifiez que les données utilisées dans le flux correspondent aux données de votre modèle Rainbird.
Questions fréquentes (FAQ)
Comment savoir quel environnement j’ai besoin d’utiliser ?
Vous pouvez trouver l’environnement dans votre compte Rainbird. Connectez-vous à votre compte et accédez à la Account page (en bas du menu de navigation gauche). Dans la About section, vous trouverez les informations relatives à votre environnement de compte (Entreprise ou Communauté).
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé API | securestring | Clé API associée à votre compte Rainbird | Vrai |
| mot de passe facultatif | securestring | Aucun mot de passe requis, tapez n’importe quel caractère | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Annuler : annule l’interaction précédente avec le moteur |
Annuler une action précédente. Cette action supprime la dernière action effectuée. Il supprime le dernier élément de données donné à Rainbird. |
| Démarrer - Démarrer une nouvelle session |
Créez un ID de session sur une carte de connaissances. Cette première étape vous permettra d’effectuer d’autres actions sur votre modèle Rainbird, telles que l’injection de faits ou l’exécution d’une requête. |
| Injecter - Injecter des faits dans une session |
Injectez des données dans une carte de connaissances par rapport à un ID de session spécifique. Cela est généralement effectué avant une requête. Il s’agit d’un moyen de charger des données dans un modèle Rainbird. |
| Preuve : retourne la preuve pour un fait donné |
Générez une preuve basée sur un ID de fait. Les connaissances déduites par Rainbird sont toujours fournies avec des données pour expliquer le processus décisionnel. Ces données sont rendues accessibles via cette action. Remarque : assurez-vous que la clé de preuve est hors du studio Rainbird. |
| Requête - Interroger une session en cours d’exécution |
Posez une question à une carte de connaissances. Cette action déclenche le moteur de décision de Rainbird. Il effectue la décision automatisée, puis fournit une réponse finale. Si Rainbird a besoin de plus d’informations pour conclure, il posera une question. |
| Réponse - Répondre à une question posée |
Donnez une réponse à Rainbird. Lorsque Rainbird revient avec une question à une requête, il s’attend à ce qu’un utilisateur ou un système entre en entrée plus de données. Cette action fournit une réponse de retour. |
| Version - Version du moteur de rapports |
Retournez la version actuelle du moteur d’inférence rainbird. |
Annuler : annule l’interaction précédente avec le moteur
Annuler une action précédente. Cette action supprime la dernière action effectuée. Il supprime le dernier élément de données donné à Rainbird.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
|
ID session
|
sessionID | True | string |
ID de session à revenir à l’aide d’une annulation |
Retours
- response
- object
Démarrer - Démarrer une nouvelle session
Créez un ID de session sur une carte de connaissances. Cette première étape vous permettra d’effectuer d’autres actions sur votre modèle Rainbird, telles que l’injection de faits ou l’exécution d’une requête.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai). |
|
ID de la carte des connaissances (kmId)
|
kmID | True | string |
ID de carte de connaissances pour démarrer une session par rapport à |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string |
ID de la session nouvellement créée |
|
pièce d'identité
|
kmVersion.id | string |
ID de la version interrogée, qui sera différent de l’ID de la carte de connaissances lors de l’interrogation des versions actives d’une carte de connaissances |
Injecter - Injecter des faits dans une session
Injectez des données dans une carte de connaissances par rapport à un ID de session spécifique. Cela est généralement effectué avant une requête. Il s’agit d’un moyen de charger des données dans un modèle Rainbird.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
|
ID session
|
sessionID | True | string |
La session pour injecter des faits dans |
|
Objet
|
subject | True |
Instance ou valeur du concept côté objet |
|
|
relation
|
relationship | True |
Relation qui lie l’objet et l’objet |
|
|
objet
|
object | True |
Instance ou valeur du concept côté objet |
|
|
certitude
|
certainty | True | number |
Quelle est la façon dont ce fait ou cette réponse est |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
résultat
|
result | string |
Preuve : retourne la preuve pour un fait donné
Générez une preuve basée sur un ID de fait. Les connaissances déduites par Rainbird sont toujours fournies avec des données pour expliquer le processus décisionnel. Ces données sont rendues accessibles via cette action. Remarque : assurez-vous que la clé de preuve est hors du studio Rainbird.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
|
ID de fait
|
factID | True | string |
FactID pour lequel récupérer des preuves |
|
ID session
|
sessionID | True | string |
SessionID WITH EVIDENCE SECURITY OFF (voir paramètres de modèle) où le fait a été créé |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
certitude
|
fact.certainty | Certainty |
Quelle est la façon dont ce fait ou cette réponse est |
|
type de données
|
fact.object.dataType | string | |
|
type
|
fact.object.type | string | |
|
value
|
fact.object.value | Object |
Instance ou valeur du concept côté objet |
|
type
|
fact.relationship.type | string | |
|
type de données
|
fact.subject.dataType | string | |
|
type
|
fact.subject.type | string | |
|
value
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
conditions
|
rule.bindings.conditions | array of object | |
|
certitude
|
rule.bindings.conditions.certainty | Certainty |
Quelle est la façon dont ce fait ou cette réponse est |
|
factID
|
rule.bindings.conditions.factID | factID |
ID utilisé pour extraire la preuve qui conduit à cette décision |
|
objet
|
rule.bindings.conditions.object | Object |
Instance ou valeur du concept côté objet |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
relation
|
rule.bindings.conditions.relationship | Relationship |
Relation qui lie l’objet et l’objet |
|
saillance
|
rule.bindings.conditions.salience | number | |
|
Objet
|
rule.bindings.conditions.subject | Subject |
Instance ou valeur du concept côté objet |
|
Source
|
source | string | |
|
time
|
time | number |
Requête - Interroger une session en cours d’exécution
Posez une question à une carte de connaissances. Cette action déclenche le moteur de décision de Rainbird. Il effectue la décision automatisée, puis fournit une réponse finale. Si Rainbird a besoin de plus d’informations pour conclure, il posera une question.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
|
ID session
|
sessionID | True | string |
Session à interroger sur |
|
Objet
|
subject | string |
Instance de concept côté objet (objet ou objet requis) |
|
|
relation
|
relationship | True | string |
Relation à rechercher |
|
objet
|
object | string |
Instance de concept côté objet (objet ou objet requis) |
Retours
- response
- object
Réponse - Répondre à une question posée
Donnez une réponse à Rainbird. Lorsque Rainbird revient avec une question à une requête, il s’attend à ce qu’un utilisateur ou un système entre en entrée plus de données. Cette action fournit une réponse de retour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
|
ID session
|
sessionID | True | string |
Session à laquelle envoyer des réponses |
|
Objet
|
subject | True |
Instance ou valeur du concept côté objet |
|
|
relation
|
relationship | True |
Relation qui lie l’objet et l’objet |
|
|
objet
|
object | True |
Instance ou valeur du concept côté objet |
|
|
certitude
|
certainty | True | number |
Quelle est la façon dont ce fait ou cette réponse est |
Retours
- response
- object
Version - Version du moteur de rapports
Retournez la version actuelle du moteur d’inférence rainbird.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Environnement
|
environment | True | string |
Environnement de compte : Communauté (api.rainbird.ai) ou Entreprise (enterprise-api.rainbird.ai).) |
Retours
- response
- string
Définitions
Certitude
Quelle est la façon dont ce fait ou cette réponse est
Quelle est la façon dont ce fait ou cette réponse est
Sujet
Relation
Objet
factID
ID utilisé pour extraire la preuve qui conduit à cette décision
ID utilisé pour extraire la preuve qui conduit à cette décision
objet
Il s’agit du type 'object'.
ficelle
Il s’agit du type de données de base « string ».