Rainbird (anteprima)
Rainbird è una piattaforma di automazione intelligente senza codice che consente di automatizzare decisioni complesse. Questo connettore consente di interagire con le mappe delle conoscenze integrate in Rainbird.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Rainbird Technologies Ltd |
| URL | https://rainbird.ai/contact-us/ |
| support@rainbird.zohodesk.eu |
| Metadati del connettore | |
|---|---|
| Editore | Rainbird Technologies ltd |
| Sito web | https://rainbird.ai/ |
| Informativa sulla privacy | https://rainbird.ai/privacy-policy/ |
| Categorie | IA; Business intelligence |
Rainbird consente all'organizzazione di automatizzare processi decisionali complessi su larga scala. Sfruttare le proprie competenze per le PMI per codificare la logica decisionale in no-code Studio, quindi connettersi al flusso di lavoro per fornire decisioni di alta qualità, prestazioni e controllabili che consentono di creare soluzioni end-to-end completamente automatizzate.
Per maggiori dettagli, visitare il sito Web di Rainbird .
Prerequisiti
Per usare questo connettore, è necessario accedere a un account Rainbird.
È possibile iscriversi ora per ottenere l'accesso a un account community gratuito: Iscrizione. Per gli account Premium, contattaci: Contattaci.
Come ottenere le credenziali
Per usare questo connettore, è necessario quanto segue: -API Chiave (ApiKey) -Knowledge ID mappa (KmID)
Il ApiKey e il KmID si trova in Rainbird Studio.
- Accedere al proprio account
- Aprire la mappa delle conoscenze (o crearne una nuova, se necessario)
- Passare alla pagina "Pubblica"
Sarà ApiKey necessario eseguire l'autenticazione con Rainbird. Quando si esegue l'autenticazione, usare ApiKey come nome utente, non è necessaria una password (immettere un carattere se è necessaria una password).
Per altri dettagli, vedere la documentazione di Rainbird .
Introduzione al connettore
In qualsiasi scenario in cui si vuole automatizzare una decisione con Rainbird, è necessario eseguire le operazioni seguenti:
-Avviare una sessione sulla mappa delle informazioni che si vuole usare -Provide dati per la sessione (facoltativa) -Query Rainbird nella sessione
Rainbird risponderà con una domanda se sono necessarie altre informazioni, che è possibile rispondere usando l'operazione Response o viene fornito un risultato.
Come avviare una sessione:
Qualsiasi decisione inizierà con un'operazione Start per avviare una sessione e ottenere .SessionID
Nell'operazione Start specificare KmID per generare un oggetto SessionID. È quindi necessario usare questo ID con altre operazioni per interagire con la mappa delle informazioni all'interno della stessa sessione.
Come fornire dati batch alla sessione:
Usare un'operazione Inject prima di eseguire query per fornire i dati necessari per prendere una decisione.
Come eseguire una query:
Per eseguire una query, usare l'operazione Query per specificare SessionID, il nome della relazione e o entrambi l'oggetto o l'oggetto della relazione.
Visitare la documentazione di Rainbird per visualizzare esempi di questa richiesta.
Come rispondere a una domanda
Usare l'operazione Response per rispondere a qualsiasi domanda restituita da Rainbird. Entrambe le Query operazioni e Response restituiranno una domanda che richiede altre informazioni o un risultato. Il ciclo di domande/risposta è ricorsivo fino a quando Rainnbird non dispone di informazioni sufficienti per fornire un risultato.
Per altre informazioni sul flusso di richiesta, vedere la documentazione di Rainbird .
Problemi noti e limitazioni
La configurazione corrente del connettore non consente agli utenti di usare la chiave di sicurezza per l'operazione di evidenza. Se un utente vuole usare l'operazione di prova, dovrà assicurarsi che la sicurezza delle prove venga disattivata in Rainbird Studio, nella sezione Pubblica di ogni mappa.
Errori e rimedi comuni
Uso della variabile di ambiente errata:
-Codice errore: questo errore può restituire vari messaggi di errore, Session ID not found ad esempio o 401: Unauthorized.
-Risoluzione: ogni operazione deve essere eseguita sull'ambiente corretto (quello collegato all'account). Assicurarsi che ogni passaggio corrisponda all'ambiente.
### Uso della struttura di dati errata.
-Codice errore: 400: bad request -Risoluzione: questo può essere causato da incompatibilità dei dati. Leggere i dettagli dell'errore per ottenere più contesto e assicurarsi che i dati usati nel flusso corrispondano ai dati del modello Rainbird.
Domande frequenti
Come è possibile sapere quale ambiente è necessario usare?
È possibile trovare l'ambiente nell'account Rainbird. Accedere al proprio account e passare alla Account pagina (nella parte inferiore del menu di spostamento a sinistra).
About Nella sezione sono disponibili le informazioni correlate all'ambiente dell'account (Enterprise o Community).
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Chiave API | securestring | Chiave API associata all'account Rainbird | Vero |
| password facoltativa | securestring | Nessuna password necessaria, digitare qualsiasi carattere | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Annulla - Annulla l'interazione precedente con il motore |
Annullare un'azione precedente. Questa azione rimuove l'ultima azione eseguita. Rimuove l'ultimo dato a Rainbird. |
| Evidenza: restituisce l'evidenza per un dato fatto |
Generare un'evidenza basata su un ID fatto. Le conoscenze dedotte da Rainbird vengono sempre fornite con i dati per spiegare il processo decisionale. Questi dati vengono resi accessibili tramite questa azione. Nota: assicurarsi che la chiave di evidenza sia disattivata in Rainbird Studio. |
| Inserire i fatti in una sessione |
Inserire dati in una mappa delle informazioni rispetto a un ID sessione specifico. Questa operazione viene in genere eseguita prima di una query. È un modo per caricare i dati in un modello Rainbird. |
| Query - Eseguire query su una sessione in esecuzione |
Porre una domanda a una mappa delle conoscenze. Questa azione attiva il motore decisionale di Rainbird. Esegue la decisione automatizzata e quindi fornisce una risposta finale. Se Rainbird ha bisogno di altre informazioni per giungere a una conclusione, farà una domanda. |
| Risposta : rispondere a una domanda |
Dare una risposta a Rainbird. Quando Rainbird torna con una domanda a una query, prevede che un utente o un sistema inserisca più dati. Questa azione restituisce una risposta. |
| Start - Avviare una nuova sessione |
Creare un nuovo ID sessione in una mappa delle conoscenze. Questo primo passaggio consentirà di eseguire altre azioni sul modello Rainbird, ad esempio l'inserimento di fatti o l'esecuzione di una query. |
| Versione - Versione del motore di report |
Restituisce la versione del motore di inferenza di Rainbird corrente. |
Annulla - Annulla l'interazione precedente con il motore
Annullare un'azione precedente. Questa azione rimuove l'ultima azione eseguita. Rimuove l'ultimo dato a Rainbird.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
ID sessione
|
sessionID | True | string |
ID sessione di cui eseguire il passaggio indietro con un annullamento |
Restituisce
- response
- object
Evidenza: restituisce l'evidenza per un dato fatto
Generare un'evidenza basata su un ID fatto. Le conoscenze dedotte da Rainbird vengono sempre fornite con i dati per spiegare il processo decisionale. Questi dati vengono resi accessibili tramite questa azione. Nota: assicurarsi che la chiave di evidenza sia disattivata in Rainbird Studio.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
ID fatto
|
factID | True | string |
ID di fatto per il quale recuperare l'evidenza |
|
ID sessione
|
sessionID | True | string |
SessionID WITH EVIDENCE SECURITY OFF (vedere le impostazioni del modello) in cui è stato creato il fatto |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
certezza
|
fact.certainty | Certainty |
Come è certo questo fatto o risposta è |
|
Tipo di dato
|
fact.object.dataType | string | |
|
type
|
fact.object.type | string | |
|
value
|
fact.object.value | Object |
Istanza o valore del concetto sul lato oggetto |
|
type
|
fact.relationship.type | string | |
|
Tipo di dato
|
fact.subject.dataType | string | |
|
type
|
fact.subject.type | string | |
|
value
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
Condizioni
|
rule.bindings.conditions | array of object | |
|
certezza
|
rule.bindings.conditions.certainty | Certainty |
Come è certo questo fatto o risposta è |
|
factID
|
rule.bindings.conditions.factID | factID |
ID usato per recuperare le prove che portano a questa decisione |
|
oggetto
|
rule.bindings.conditions.object | Object |
Istanza o valore del concetto sul lato oggetto |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
relazione
|
rule.bindings.conditions.relationship | Relationship |
Relazione che collega Oggetto e Oggetto |
|
salience
|
rule.bindings.conditions.salience | number | |
|
Oggetto
|
rule.bindings.conditions.subject | Subject |
Istanza o valore del concetto sul lato soggetto |
|
source
|
source | string | |
|
time
|
time | number |
Inserire i fatti in una sessione
Inserire dati in una mappa delle informazioni rispetto a un ID sessione specifico. Questa operazione viene in genere eseguita prima di una query. È un modo per caricare i dati in un modello Rainbird.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
ID sessione
|
sessionID | True | string |
Sessione in cui inserire fatti |
|
Oggetto
|
subject | True |
Istanza o valore del concetto sul lato soggetto |
|
|
relazione
|
relationship | True |
Relazione che collega Oggetto e Oggetto |
|
|
oggetto
|
object | True |
Istanza o valore del concetto sul lato oggetto |
|
|
certezza
|
certainty | True | number |
Come è certo questo fatto o risposta è |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
risultato
|
result | string |
Query - Eseguire query su una sessione in esecuzione
Porre una domanda a una mappa delle conoscenze. Questa azione attiva il motore decisionale di Rainbird. Esegue la decisione automatizzata e quindi fornisce una risposta finale. Se Rainbird ha bisogno di altre informazioni per giungere a una conclusione, farà una domanda.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
ID sessione
|
sessionID | True | string |
Sessione su cui eseguire una query |
|
Oggetto
|
subject | string |
Istanza del concetto sul lato soggetto (oggetto o oggetto richiesto) |
|
|
relazione
|
relationship | True | string |
Relazione con cui eseguire una query |
|
oggetto
|
object | string |
Istanza del concetto sul lato oggetto (oggetto o oggetto richiesto) |
Restituisce
- response
- object
Risposta : rispondere a una domanda
Dare una risposta a Rainbird. Quando Rainbird torna con una domanda a una query, prevede che un utente o un sistema inserisca più dati. Questa azione restituisce una risposta.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
ID sessione
|
sessionID | True | string |
Sessione a cui inviare risposte |
|
Oggetto
|
subject | True |
Istanza o valore del concetto sul lato soggetto |
|
|
relazione
|
relationship | True |
Relazione che collega Oggetto e Oggetto |
|
|
oggetto
|
object | True |
Istanza o valore del concetto sul lato oggetto |
|
|
certezza
|
certainty | True | number |
Come è certo questo fatto o risposta è |
Restituisce
- response
- object
Start - Avviare una nuova sessione
Creare un nuovo ID sessione in una mappa delle conoscenze. Questo primo passaggio consentirà di eseguire altre azioni sul modello Rainbird, ad esempio l'inserimento di fatti o l'esecuzione di una query.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai). |
|
ID mappa delle informazioni (kmId)
|
kmID | True | string |
ID mappa delle informazioni per avviare una sessione |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | string |
ID della sessione appena creata |
|
id
|
kmVersion.id | string |
ID della versione su cui viene eseguita la query, che sarà diverso dall'ID mappa delle informazioni durante l'esecuzione di query sulle versioni live di una mappa delle conoscenze |
Versione - Versione del motore di report
Restituisce la versione del motore di inferenza di Rainbird corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente account: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
Restituisce
- response
- string
Definizioni
Attendibilità
Oggetto
Relazione
Oggetto
factID
ID usato per recuperare le prove che portano a questa decisione
ID usato per recuperare le prove che portano a questa decisione
oggetto
Si tratta del tipo 'object'.
corda
Si tratta del tipo di dati di base 'string'.