Rainbird (versión preliminar)
Rainbird es una plataforma de automatización inteligente sin código que permite automatizar decisiones complejas. Este conector le permite interactuar con los mapas de conocimiento que ha integrado en Rainbird.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Rainbird Technologies Ltd |
| URL | https://rainbird.ai/contact-us/ |
| Correo Electrónico | support@rainbird.zohodesk.eu |
| Metadatos del conector | |
|---|---|
| Publicador | Rainbird Technologies ltd |
| Sitio web | https://rainbird.ai/ |
| Directiva de privacidad | https://rainbird.ai/privacy-policy/ |
| Categorías | IA; Business Intelligence |
Rainbird permite a su organización automatizar la toma de decisiones compleja a escala. Aproveche sus propios conocimientos sobre pymes para codificar su lógica de toma de decisiones en nuestro no-code Studio y, a continuación, conéctese al flujo de trabajo para proporcionar decisiones de alta calidad, rendimiento y auditables que le permitan crear soluciones de un extremo a otro totalmente automatizadas.
Visite el sitio web de Rainbird para obtener más detalles.
Prerrequisitos
Para usar este conector, necesita acceso a una cuenta de Rainbird.
Puede registrarse ahora para obtener acceso a una cuenta gratuita de la comunidad: Registrarse. Para las cuentas Premium, póngase en contacto con nosotros: Póngase en contacto con nosotros: Póngase en contacto con nosotros.
Obtención de credenciales
Para usar este conector, necesitará lo siguiente: clave de -API (ApiKey) -Knowledge id. de mapa (KmID)
y ApiKeyKmID se pueden encontrar en Rainbird Studio.
- Inicio de sesión en su cuenta
- Abra el mapa de conocimiento (o cree uno si es necesario)
- Vaya a la página "Publicar".
ApiKey Se necesitará para autenticarse con Rainbird. Al autenticar usa ApiKey como nombre de usuario, no necesita una contraseña (escriba ningún carácter si se requiere una contraseña).
Visite la documentación de Rainbird para obtener más detalles.
Introducción al conector
En cualquier escenario en el que quiera automatizar una decisión con Rainbird, deberá hacer lo siguiente:
-Iniciar una sesión en el mapa de conocimiento que desea usar -Provide datos en la sesión (opcional) -Query Rainbird en la sesión
Rainbird responderá con una pregunta si se requiere más información, que puede responder mediante la Response operación o se proporciona un resultado.
Cómo iniciar una sesión:
Cualquier decisión comenzará con una Start operación para iniciar una sesión y obtener .SessionID
En la Start operación, proporcione KmID para generar un SessionID. A continuación, debe usar este identificador con otras operaciones para interactuar con el mapa de conocimiento dentro de la misma sesión.
Cómo proporcionar datos por lotes a la sesión:
Use una Inject operación antes de consultar para proporcionar los datos necesarios para tomar una decisión.
Cómo realizar una consulta:
Para realizar una consulta, use la Query operación para proporcionar el SessionID, el nombre de la relación y el asunto o el objeto de la relación.
Visite la documentación de Rainbird para ver ejemplos de esta solicitud.
Cómo responder a una pregunta
Use la Response operación para responder a cualquier pregunta devuelta por Rainbird. Tanto la Query operación como Response devolverán una pregunta que solicite más información o un resultado. El bucle de preguntas y respuestas es recursivo hasta que Rainnbird tiene suficiente información para proporcionar un resultado.
Visite la documentación de Rainbird para obtener más información sobre el flujo de solicitud.
Problemas y limitaciones conocidos
La configuración del conector actual no permite a los usuarios usar la clave de seguridad para la operación de evidencia. Si un usuario quiere usar la operación de evidencia, tendrá que asegurarse de que la seguridad de la evidencia está desactivada en Rainbird Studio, en la sección Publicar de cada mapa.
Errores y soluciones comunes
Con la variable de entorno incorrecta:
-Código de error: este error puede generar varios mensajes de error como Session ID not found o 401: Unauthorized.
-Resolución: todas las operaciones deben realizarse en el entorno correcto (el vinculado a su cuenta). Asegúrese de que cada paso coincida con el entorno.
### Uso de la estructura de datos incorrecta.
-Código de error: 400: bad request -Resolution: esto puede deberse a incompatibilidades de datos. Lea los detalles del error para obtener más contexto y asegúrese de que los datos usados en el flujo coinciden con los datos del modelo de Rainbird.
Preguntas más frecuentes
¿Cómo sé qué entorno necesito usar?
Puede encontrar el entorno en su cuenta de Rainbird. Inicie sesión en su cuenta y vaya a la Account página (parte inferior del menú de navegación izquierdo). En la About sección encontrará la información relacionada con su entorno de cuenta (Enterprise o Community).
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API asociada a la cuenta de Rainbird | Cierto |
| contraseña opcional | securestring | No se requiere ninguna contraseña, escriba ningún carácter | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Consulta: consulta de una sesión en ejecución |
Formular una pregunta a un mapa de conocimiento. Esta acción desencadena el motor de decisión de Rainbird. Realiza la toma de decisiones automatizada y, a continuación, proporciona una respuesta final. Si Rainbird necesita más información para llegar a una conclusión, formulará una pregunta. |
| Deshacer: deshacer la interacción anterior con el motor |
Deshacer una acción anterior. Esta acción quita la última acción realizada. Quita el último fragmento de datos proporcionados a Rainbird. |
| Evidencia: devuelve la evidencia de un hecho determinado. |
Genere una evidencia basada en un identificador de hechos. El conocimiento inferido por Rainbird siempre incluye datos para explicar el proceso de toma de decisiones. Estos datos se hacen accesibles a través de esta acción. Nota: Asegúrese de que la clave de evidencia está desactivada en Rainbird Studio. |
| Inicio: inicio de una nueva sesión |
Cree un nuevo identificador de sesión en un mapa de conocimiento. Este primer paso le permitirá realizar más acciones en el modelo de Rainbird, como insertar hechos o realizar una consulta. |
| Inserción: inserción de hechos en una sesión |
Inserte datos en un mapa de conocimiento con un identificador de sesión específico. Normalmente, esto se realiza antes de una consulta. Es una manera de cargar datos en un modelo rainbird. |
| Respuesta: respuesta a una pregunta |
Devuelve una respuesta a Rainbird. Cuando Rainbird vuelve con una pregunta a una consulta, espera que un usuario o un sistema escriban más datos. Esta acción devuelve una respuesta. |
| Versión: versión del motor de informes |
Devuelve la versión actual del motor de inferencia de Rainbird. |
Consulta: consulta de una sesión en ejecución
Formular una pregunta a un mapa de conocimiento. Esta acción desencadena el motor de decisión de Rainbird. Realiza la toma de decisiones automatizada y, a continuación, proporciona una respuesta final. Si Rainbird necesita más información para llegar a una conclusión, formulará una pregunta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
Id. sesión
|
sessionID | True | string |
Sesión en la que se va a consultar |
|
Asunto
|
subject | string |
La instancia de concepto del lado sujeto (objeto o sujeto requerido) |
|
|
Relación
|
relationship | True | string |
Relación con la consulta de |
|
objeto
|
object | string |
La instancia de concepto del lado del objeto (objeto o asunto requerido) |
Devoluciones
- response
- object
Deshacer: deshacer la interacción anterior con el motor
Deshacer una acción anterior. Esta acción quita la última acción realizada. Quita el último fragmento de datos proporcionados a Rainbird.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
Id. sesión
|
sessionID | True | string |
Identificador de sesión para retroceder con una deshacer |
Devoluciones
- response
- object
Evidencia: devuelve la evidencia de un hecho determinado.
Genere una evidencia basada en un identificador de hechos. El conocimiento inferido por Rainbird siempre incluye datos para explicar el proceso de toma de decisiones. Estos datos se hacen accesibles a través de esta acción. Nota: Asegúrese de que la clave de evidencia está desactivada en Rainbird Studio.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
Id. de hechos
|
factID | True | string |
El factID para el que se va a recuperar la evidencia |
|
Id. sesión
|
sessionID | True | string |
SessionID WITH EVIDENCE SECURITY OFF (consulte la configuración del modelo) donde se creó el hecho. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
certeza
|
fact.certainty | Certainty |
La certeza de que este hecho o respuesta es |
|
Tipo de dato
|
fact.object.dataType | string | |
|
type
|
fact.object.type | string | |
|
value
|
fact.object.value | Object |
Instancia o valor del concepto del lado objeto |
|
type
|
fact.relationship.type | string | |
|
Tipo de dato
|
fact.subject.dataType | string | |
|
type
|
fact.subject.type | string | |
|
value
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
condiciones
|
rule.bindings.conditions | array of object | |
|
certeza
|
rule.bindings.conditions.certainty | Certainty |
La certeza de que este hecho o respuesta es |
|
factID
|
rule.bindings.conditions.factID | factID |
Identificador usado para capturar la evidencia que conduce a esta decisión |
|
objeto
|
rule.bindings.conditions.object | Object |
Instancia o valor del concepto del lado objeto |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
Relación
|
rule.bindings.conditions.relationship | Relationship |
Relación que vincula asunto y objeto |
|
Prominencia
|
rule.bindings.conditions.salience | number | |
|
Asunto
|
rule.bindings.conditions.subject | Subject |
Instancia o valor del concepto del lado sujeto |
|
source
|
source | string | |
|
time
|
time | number |
Inicio: inicio de una nueva sesión
Cree un nuevo identificador de sesión en un mapa de conocimiento. Este primer paso le permitirá realizar más acciones en el modelo de Rainbird, como insertar hechos o realizar una consulta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai). |
|
Id. de mapa de conocimiento (kmId)
|
kmID | True | string |
Identificador de mapa de conocimiento para iniciar una sesión en |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Identificador de la sesión recién creada |
|
id
|
kmVersion.id | string |
Identificador de la versión que se consulta, que será diferente al identificador de mapa de conocimiento al consultar versiones dinámicas de un mapa de conocimiento. |
Inserción: inserción de hechos en una sesión
Inserte datos en un mapa de conocimiento con un identificador de sesión específico. Normalmente, esto se realiza antes de una consulta. Es una manera de cargar datos en un modelo rainbird.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
Id. sesión
|
sessionID | True | string |
Sesión en la que se insertarán hechos |
|
Asunto
|
subject | True |
Instancia o valor del concepto del lado sujeto |
|
|
Relación
|
relationship | True |
Relación que vincula asunto y objeto |
|
|
objeto
|
object | True |
Instancia o valor del concepto del lado objeto |
|
|
certeza
|
certainty | True | number |
La certeza de que este hecho o respuesta es |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | string |
Respuesta: respuesta a una pregunta
Devuelve una respuesta a Rainbird. Cuando Rainbird vuelve con una pregunta a una consulta, espera que un usuario o un sistema escriban más datos. Esta acción devuelve una respuesta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
|
Id. sesión
|
sessionID | True | string |
Sesión a la que se van a enviar respuestas |
|
Asunto
|
subject | True |
Instancia o valor del concepto del lado sujeto |
|
|
Relación
|
relationship | True |
Relación que vincula asunto y objeto |
|
|
objeto
|
object | True |
Instancia o valor del concepto del lado objeto |
|
|
certeza
|
certainty | True | number |
La certeza de que este hecho o respuesta es |
Devoluciones
- response
- object
Versión: versión del motor de informes
Devuelve la versión actual del motor de inferencia de Rainbird.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
environment | True | string |
Entorno de cuenta: Community (api.rainbird.ai) o Enterprise (enterprise-api.rainbird.ai).) |
Devoluciones
- response
- string
Definiciones
Certeza
Asunto
Relación
Objeto
factID
Identificador usado para capturar la evidencia que conduce a esta decisión
Identificador usado para capturar la evidencia que conduce a esta decisión
objeto
Este es el tipo 'object'.
cuerda / cadena
Este es el tipo de datos básico "string".