Rainbird (Pré-visualização)
O Rainbird é uma plataforma de automação inteligente sem código que permite automatizar decisões complexas. Este conector permite que você interaja com mapas de conhecimento que você construiu no Rainbird.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Rainbird Tecnologias Ltd |
| URL | https://rainbird.ai/contact-us/ |
| support@rainbird.zohodesk.eu |
| Metadados do conector | |
|---|---|
| Editora | Rainbird Tecnologias Ltd |
| Sítio Web | https://rainbird.ai/ |
| Política de privacidade | https://rainbird.ai/privacy-policy/ |
| Categorias | IA; Inteligência de Negócios |
O Rainbird permite que sua organização automatize a tomada de decisões complexas em escala. Aproveite sua própria experiência em PMEs para codificar sua lógica de tomada de decisão em nosso estúdio sem código e, em seguida, conecte-se ao seu fluxo de trabalho para fornecer decisões de alta qualidade, com desempenho e auditáveis que permitem criar soluções de ponta a ponta totalmente automatizadas.
Visite o site da Rainbird para mais detalhes.
Pré-requisitos
Para usar esse conector, você precisa ter acesso a uma conta Rainbird.
Você pode se inscrever agora para ter acesso a uma conta da comunidade gratuita: Inscreva-se. Para contas premium, entre em contacto connosco: Contacte-nos.
Como obter credenciais
Para usar esse conector, você precisará do seguinte: -API Key (ApiKey) -Knowledge Map ID (KmID)
O ApiKey e o KmID pode ser encontrado no Rainbird Studio.
- Inicie sessão na sua conta
- Abra seu mapa de conhecimento (ou crie um novo, se necessário)
- Ir para a página 'Publicar'
O ApiKey será necessário para autenticar com Rainbird. Ao autenticar use o seu ApiKey como nome de usuário, você não precisa de uma senha (insira qualquer caractere se uma senha for necessária).
Visite a documentação do Rainbird para obter mais detalhes.
Introdução ao conector
Em qualquer cenário em que você queira automatizar uma decisão com o Rainbird, você precisará fazer o seguinte:
-Inicie uma Sessão no Mapa de Conhecimento que pretende utilizar -Provide dados para a sua Sessão (opcional) -Query Rainbird na sua Sessão
Rainbird irá responder com uma pergunta se mais informações são necessárias, que você pode responder usando a Response operação, ou um resultado é fornecido.
Como iniciar uma sessão:
Qualquer decisão começará com uma Start operação para iniciar uma sessão e obter o SessionID.
Na operação, forneça o Start seu KmID para gerar um SessionIDarquivo . Em seguida, você deve usar essa ID com outras operações para interagir com seu Mapa de Conhecimento na mesma sessão.
Como fornecer dados em lote para sua sessão:
Use uma Inject operação antes de consultar para fornecer quaisquer dados necessários para tomar uma decisão.
Como fazer uma consulta:
Para fazer uma consulta, use a Query operação para fornecer o SessionID, o nome do relacionamento e um ou ambos o assunto/objeto da relação.
Visite a documentação do Rainbird para ver exemplos deste pedido.
Como responder a uma pergunta
Use a Response operação para responder a qualquer pergunta retornada pelo Rainbird. Tanto a operação como Response a Query retornarão uma pergunta pedindo mais informações ou um resultado. O loop de pergunta/resposta é recursivo até que o Rainnbird tenha informações suficientes para fornecer um resultado.
Visite a documentação do Rainbird para obter mais informações sobre o fluxo de solicitações.
Problemas conhecidos e limitações
A configuração atual do conector não permite que os usuários usem a chave de segurança para a operação de evidência. Se um usuário quiser usar a operação de evidência, ele terá que se certificar de que a segurança de evidência está desativada no Rainbird Studio, na seção Publicar de cada mapa.
Erros e soluções comuns
Usando a variável de ambiente errada:
-Código de erro: Este erro pode gerar várias mensagens de erro, como Session ID not found ou 401: Unauthorized.
- Resolução: Toda operação precisa ser feita contra o ambiente correto (aquele vinculado à sua conta). Certifique-se de que cada etapa corresponde ao seu ambiente.
### Usando a estrutura de dados errada.
-Código de erro: 400: bad request -Resolução: Isso pode ser causado por incompatibilidades de dados. Leia os detalhes do erro para obter mais contexto e certifique-se de que os dados usados no fluxo correspondem aos dados do seu modelo Rainbird.
FAQ
Como sei qual ambiente preciso usar?
Pode encontrar o ambiente na sua conta Rainbird. Inicie sessão na sua conta e vá para a Account página (parte inferior do menu de navegação esquerdo).
About Na seção, você encontrará as informações relacionadas ao ambiente da sua conta (Empresa ou Comunidade).
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de api | securestring | A chave api associada à sua conta Rainbird | Verdade |
| palavra-passe opcional | securestring | Nenhuma senha necessária, digite qualquer caractere | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Consulta - Consultar uma sessão em execução |
Faça uma pergunta a um mapa de conhecimento. Esta ação aciona o motor de decisão do Rainbird. Ele executa a decisão automatizada e, em seguida, fornece uma resposta final. Se o Rainbird precisar de mais informações para chegar a uma conclusão, ele fará uma pergunta. |
| Desfazer - Desfaz a interação anterior com o motor |
Desfazer uma ação anterior. Esta ação remove a última ação executada. Ele remove o último pedaço de dados dado ao Rainbird. |
| Iniciar - Iniciar uma nova sessão |
Crie um novo ID de sessão em um mapa de conhecimento. Este primeiro passo permitirá que você faça outras ações contra seu modelo Rainbird, como injetar fatos ou fazer uma consulta. |
| Injetar - Injetar factos numa sessão |
Injete dados em um mapa de conhecimento em relação a um ID de sessão específico. Isso geralmente é realizado antes de uma consulta. É uma maneira de carregar dados em um modelo Rainbird. |
| Prova - Devolve a prova de um determinado facto |
Gere uma evidência baseada em um ID de fato. O conhecimento inferido pela Rainbird vem sempre acompanhado de dados para explicar o processo de tomada de decisão. Estes dados são disponibilizados através desta ação. Nota: certifique-se de que a chave de prova está desligada no estúdio Rainbird. |
| Resposta - Responder a uma pergunta feita |
Dê uma resposta para Rainbird. Quando o Rainbird volta com uma pergunta para uma consulta, ele espera que um usuário ou um sistema insira mais dados. Esta ação fornece uma resposta de volta. |
| Versão - Versão do mecanismo de relatórios |
Retorne a versão atual do mecanismo de inferência do Rainbird. |
Consulta - Consultar uma sessão em execução
Faça uma pergunta a um mapa de conhecimento. Esta ação aciona o motor de decisão do Rainbird. Ele executa a decisão automatizada e, em seguida, fornece uma resposta final. Se o Rainbird precisar de mais informações para chegar a uma conclusão, ele fará uma pergunta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão a ser consultada |
|
Assunto
|
subject | string |
A instância de conceito do lado do assunto (objeto ou assunto necessário) |
|
|
relação
|
relationship | True | string |
A relação a ser consultada para |
|
objecto
|
object | string |
A instância do conceito do lado do objeto (objeto ou assunto necessário) |
Devoluções
- response
- object
Desfazer - Desfaz a interação anterior com o motor
Desfazer uma ação anterior. Esta ação remove a última ação executada. Ele remove o último pedaço de dados dado ao Rainbird.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
O ID da sessão para recuar com um desfazer |
Devoluções
- response
- object
Iniciar - Iniciar uma nova sessão
Crie um novo ID de sessão em um mapa de conhecimento. Este primeiro passo permitirá que você faça outras ações contra seu modelo Rainbird, como injetar fatos ou fazer uma consulta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai). |
|
ID do Mapa de Conhecimento (kmId)
|
kmID | True | string |
O ID do mapa de conhecimento para iniciar uma sessão em relação |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
ID da sessão recém-criada |
|
id
|
kmVersion.id | string |
ID da versão que está sendo consultada, que será diferente da ID do mapa de conhecimento ao consultar versões ao vivo de um mapa de conhecimento |
Injetar - Injetar factos numa sessão
Injete dados em um mapa de conhecimento em relação a um ID de sessão específico. Isso geralmente é realizado antes de uma consulta. É uma maneira de carregar dados em um modelo Rainbird.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão para injetar fatos em |
|
Assunto
|
subject | True |
A instância ou o valor do conceito do lado do assunto |
|
|
relação
|
relationship | True |
A relação que liga Assunto e Objeto |
|
|
objecto
|
object | True |
A instância ou o valor do conceito do lado do objeto |
|
|
certeza
|
certainty | True | number |
Quão certo é este facto ou resposta |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultado
|
result | string |
Prova - Devolve a prova de um determinado facto
Gere uma evidência baseada em um ID de fato. O conhecimento inferido pela Rainbird vem sempre acompanhado de dados para explicar o processo de tomada de decisão. Estes dados são disponibilizados através desta ação. Nota: certifique-se de que a chave de prova está desligada no estúdio Rainbird.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
|
ID do Facto
|
factID | True | string |
O factID para o qual se devem recolher provas |
|
ID da Sessão
|
sessionID | True | string |
O sessionID WITH EVIDENCE SECURITY OFF (consulte as configurações do modelo) onde o fato foi criado |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
certeza
|
fact.certainty | Certainty |
Quão certo é este facto ou resposta |
|
Tipo de dados
|
fact.object.dataType | string | |
|
tipo
|
fact.object.type | string | |
|
valor
|
fact.object.value | Object |
A instância ou o valor do conceito do lado do objeto |
|
tipo
|
fact.relationship.type | string | |
|
Tipo de dados
|
fact.subject.dataType | string | |
|
tipo
|
fact.subject.type | string | |
|
valor
|
fact.subject.value | string | |
|
identificação do facto
|
factID | string | |
|
condições
|
rule.bindings.conditions | array of object | |
|
certeza
|
rule.bindings.conditions.certainty | Certainty |
Quão certo é este facto ou resposta |
|
identificação do facto
|
rule.bindings.conditions.factID | factID |
ID utilizado para obter as provas que levaram a esta decisão |
|
objecto
|
rule.bindings.conditions.object | Object |
A instância ou o valor do conceito do lado do objeto |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
relação
|
rule.bindings.conditions.relationship | Relationship |
A relação que liga Assunto e Objeto |
|
saliência
|
rule.bindings.conditions.salience | number | |
|
Assunto
|
rule.bindings.conditions.subject | Subject |
A instância ou o valor do conceito do lado do assunto |
|
origem
|
source | string | |
|
time
|
time | number |
Resposta - Responder a uma pergunta feita
Dê uma resposta para Rainbird. Quando o Rainbird volta com uma pergunta para uma consulta, ele espera que um usuário ou um sistema insira mais dados. Esta ação fornece uma resposta de volta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão para enviar respostas |
|
Assunto
|
subject | True |
A instância ou o valor do conceito do lado do assunto |
|
|
relação
|
relationship | True |
A relação que liga Assunto e Objeto |
|
|
objecto
|
object | True |
A instância ou o valor do conceito do lado do objeto |
|
|
certeza
|
certainty | True | number |
Quão certo é este facto ou resposta |
Devoluções
- response
- object
Versão - Versão do mecanismo de relatórios
Retorne a versão atual do mecanismo de inferência do Rainbird.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Empresa (enterprise-api.rainbird.ai).) |
Devoluções
- response
- string
Definições
Certeza
Assunto
A instância ou o valor do conceito do lado do assunto
A instância ou o valor do conceito do lado do assunto
Relacionamento
Objeto
A instância ou o valor do conceito do lado do objeto
A instância ou o valor do conceito do lado do objeto
identificação do facto
ID utilizado para obter as provas que levaram a esta decisão
ID utilizado para obter as provas que levaram a esta decisão
objecto
Este é o tipo 'objeto'.
cadeia (de caracteres)
Este é o tipo de dados básico 'string'.