Herramientas
Invantive MCP Server ofrece las siguientes herramientas a un cliente de IA como Anthropic Claude. Las herramientas sobre una base de datos solo leen: no modifican datos ni ejecutan instrucciones SQL. Solo check_sql acepta una, que la analiza sin ejecutarla. Las herramientas de estado trabajan sobre una página de estado de Invantive Cloud Status en lugar de una base de datos; cuatro de ellas modifican la página de estado.
describe_entities: lista las entidades que se pueden leer de la base de datos, con su nombre, etiqueta, tipo, contenedor de datos y el orden de magnitud de su número de filas. Disponible a partir de la versión 26.0. Vea abajo.describe_entity: describe una entidad completa, con sus campos, clave primaria, claves únicas, claves externas y la velocidad que cabe esperar. Disponible a partir de la versión 27.0. Vea abajo.read_records: lee filas de una entidad, con selección, filtro, orden y número de filas en la notación de la interfaz de consulta de la versión 4 de OData. Disponible a partir de la versión 26.0. Vea abajo.analyze_records: ejecuta la misma lectura queread_recordsy devuelve cómo se ejecutó en lugar de las filas. Disponible a partir de la versión 28.0. Vea abajo.current_cloud_user: devuelve el perfil del usuario que ha iniciado sesión y de la organización de ese usuario, tal como se guardan en Invantive Cloud. Disponible a partir de la versión 26.0. Vea abajo.check_sql: comprueba la sintaxis de las instrucciones de Invantive UniversalSQL y PSQL sin ejecutarlas. Disponible a partir de la versión 28.0. Vea abajo.status_get_summary: devuelve de un vistazo el estado de la página de estado. Vea abajo.status_list_incidents: lista los incidentes de la página de estado, del más reciente al más antiguo. Vea abajo.status_get_incident: devuelve un incidente con sus componentes y actualizaciones. Vea abajo.status_create_incident: abre un incidente en la página de estado. Vea abajo.status_add_update: publica una actualización de una incidencia, que puede resolverla. Vea abajo.status_set_component_state: establece el estado de un componente. Vea abajo.status_schedule_maintenance: planifica un mantenimiento con una ventana de tiempo. Vea abajo.
Instrucciones para el cliente
Cuando se conecta un cliente de IA, el servidor le envía instrucciones. Indican la versión del servidor y las direcciones en las que la misma base de datos está disponible para otros clientes, con si el usuario activó cada dirección: Invantive MCP Server, el protocolo SQL Server de Invantive UniversalSQL Server para clientes SQL Server y ODBC, Bridge Online para Power BI y App Online para aplicaciones, ambos sobre OData versión 4. También ofrecen consejos para leer de forma eficiente, indican los límites de velocidad de las plataformas y remiten a Invantive Data Hub.
Las instrucciones indican también que Invantive Cloud puede intercambiar datos entre la base de datos y otras plataformas, mediante replicación, combinación o integración. Enumeran los nombres comerciales de esas plataformas, como Exact Online, Salesforce y AFAS Profit. La lista incluye las plataformas para las que Invantive Cloud dispone de un controlador. Se excluyen los controladores de prueba, los auxiliares, los controladores obsoletos y los productos propios de Invantive. La lista está disponible desde la versión 27.0.
Listado de entidades
describe_entities enumera las entidades de la base de datos que se pueden leer, para que un cliente de IA pueda elegir una. No describe una entidad en detalle: describe_entity lo hace para una sola entidad. La herramienta acepta dos argumentos, ambos opcionales:
entities: los nombres de las entidades que se van a listar. Un nombre se compara sin distinguir mayúsculas y minúsculas y debe escribirse tal como lo devolvió una respuesta anterior. Se acepta un único nombre o una lista separada por comas en lugar de una matriz.nameOnly: cuando es verdadero, cada entidad se reduce a su nombre, etiqueta, tipo y contenedor de datos. Úselo solo cuando la respuesta se haya truncado. El valor predeterminado es false.
La respuesta contiene:
database: el segmento de URL de la base de datos.detailLevel:summary, onamesOnlycuando se aplicónameOnly.entityCountyreturnedEntityCount: el número de entidades que coinciden con la solicitud y el número de entidades en la respuesta.truncatedytruncationHint: presente cuando la respuesta contiene menos entidades de las que coinciden. La sugerencia explica cómo hacer una pregunta más precisa, indicando las entidades de interés enentities.unknownEntitiesyunknownEntitiesHint: presentes cuandoentitiescontiene un nombre que no existe. La sugerencia indica las entidades existentes más cercanas, para como máximo los cinco primeros nombres desconocidos.unknownEntitiesHintestá disponible desde la versión 27.0.dataContainers: un objeto por contenedor de datos, ya que la partición pertenece al contenedor de datos y no a la entidad. Contiene elaliasque lleva un nombre de entidad después de@, elproviderque sirve al contenedor de datos y si estesupportsPartitions. Un contenedor de datos que admite particiones también contienepartitionLabelPlural,partitionCount,selectedPartitionCountyallPartitionsSelected: el término que usa la plataforma para varias particiones, como divisiones en Exact Online, el número de particiones disponibles, el número que consulta una llamada aread_recordsy si esa es la totalidad.partitioningNote: cómo se relaciona la partición con las entidades de esta base de datos. Presente cuando al menos un contenedor de datos admite particiones.selectedPartitionCountTotal: el número de particiones seleccionadas en todos los contenedores de datos.entities: un objeto por entidad, ordenado por contenedor de datos y después por nombre, de modo que una respuesta truncada omita las mismas entidades en cada llamada.
Una entidad contiene:
name: el nombre que hay que pasar en el argumentoentityderead_recordsydescribe_entity.label: la etiqueta que usa la plataforma para el contenido. Presente solo cuando difiere dename.type: el tipo de objeto, comotable,viewotablefunction.dataContainer: el alias del contenedor de datos que contiene la entidad.rowCountBand: el orden de magnitud del número de filas, cuando la plataforma proporciona una estimación. El valor esempty,<=100,<=1k,<=10k,<=100k,<=1Mo>1M.notReadable: verdadero cuando la entidad no se puede leer. Ausente en otro caso.
Los miembros rowCountBand y notReadable se omiten cuando se aplica nameOnly.
Hasta la versión 26.0 inclusive, cada entidad también contenía description, keyField y partitionSpecific, y un contenedor de datos contenía toda la partición: los términos, la columna de partición y las particiones seleccionadas. Desde la versión 27.0 estos se incluyen en la respuesta de describe_entity. Eso mantiene la lista corta y rápida en una base de datos con más de mil entidades.
El tamaño de la respuesta está limitado a 60,000 caracteres por defecto. La configuración MaxDescribeEntitiesResponseChars cambia ese límite. Está disponible desde la versión 26.0. El ajuste MaxEntityDescriptionChars no se usa desde la versión 27.0, ya que la lista no contiene descripciones.
Los siguientes argumentos enumeran dos entidades de la base de datos:
{ "entities": [ "SalesInvoices", "Accounts" ] }
Describir una entidad
describe_entity describe una entidad por completo. Un cliente de IA la llama con un nombre de describe_entities, antes de leer la entidad con read_records. Está disponible desde la versión 27.0. La herramienta recibe un argumento:
entity: el nombre de la entidad, tal como lo devuelvedescribe_entities. Un nombre se compara sin distinguir mayúsculas de minúsculas. Obligatorio.
Un nombre que no existe se rechaza con el código de mensaje itgenmcp665. La sugerencia indica las entidades existentes más cercanas.
La respuesta contiene:
database: el segmento de URL de la base de datos.name,label,labelSingular,typeydataContainer: como en la lista.labelylabelSingularestán presentes solo cuando difieren dename.description: qué contiene la entidad, escrito para un usuario de negocio y de forma completa.documentationes una explicación adicional, cuando la plataforma la proporciona.partitionSpecific: verdadero cuando el contenido depende de las particiones seleccionadas. Ausente en otro caso.notReadable: verdadero cuando la entidad no se puede leer. Ausente en otro caso.rowCountBandyestimatedRowCount: el orden de magnitud del número de filas y la estimación en sí, cuando la plataforma la proporciona. Una estimación no es un recuento.performance: qué esperar de la velocidad de lectura de la entidad.primaryKey,uniqueKeysyforeignKeys: las claves y las relaciones con otras entidades.dataContainerDetailsypartitioningNote: el contenedor de datos que contiene la entidad y cómo se relaciona la partición con la entidad.fieldCount,returnedFieldCount,truncatedytruncationHint: el número de campos, el número en la respuesta y, cuando se omiten campos, qué hacer al respecto.fields: los campos de la entidad.
Un campo contiene:
name: el nombre tal como lo aceptan los argumentosselect,filteryorderbyderead_records.label: la etiqueta que usa la plataforma. Presente solo cuando difiere dename.dataType: el tipo primitivo de la versión 4 de OData, comoString,Int32,Decimal,DateTimeOffset,BooleanoGuid.nullable: indica si el campo puede estar vacío.maxLength,precisionyscale: la longitud de un campo de texto o binario y los dígitos de un campo decimal, cuando la plataforma los indica.primaryKey: true cuando el campo forma parte de la clave primaria. Ausente en otro caso.description: lo que contiene el campo, escrito para un usuario de negocio.filterOnPlatform: true cuando la propia plataforma evalúa un filtro sobre el campo, de modo que solo se recuperan las filas que cumplen la condición. False cuando primero se recuperan todas las filas y después se filtran, lo que resulta lento en una entidad grande.sortOnPlatform: true cuando la propia plataforma ordena por el campo. Ausente cuando no se conoce.
Los miembros uniqueKeys y foreignKeys, y el guarantee de una clave, están disponibles desde la versión 28.0. La versión 27.0 responde la clave primaria sin garantía, ya que su motor no guarda otros metadatos de claves.
Una clave contiene fields, guarantee y, cuando la plataforma la proporciona, name. La garantía es enforced cuando la propia plataforma mantiene única la clave, y declared cuando el controlador o el modelo la declaran sin que la plataforma la imponga. Los campos de una clave se denominan como los campos de la entidad. Un nombre que no es campo de la entidad se escribe como la plataforma nombra la columna. Una clave que repite la clave primaria no aparece en uniqueKeys.
Una clave externa es una relación desde campos de esta entidad hasta la clave de otra entidad. Contiene:
fields: los campos de esta entidad que contienen la referencia.referencedEntityyreferencedFields: la entidad referida, con el nombre que le dadescribe_entities, y sus campos, en el mismo orden quefields.referencedTable: el nombre que la plataforma asigna al objeto referido. Presente solo cuando ese objeto no es una entidad de esta base de datos, en cuyo casoreferencedFieldscontiene los nombres de columna de la plataforma.kind:keycuando los campos hacen referencia a una clave de la entidad referenciada,textualcuando la relación existe solo en palabras y se cumple bajo una condición, ycandidatecuando se deduce de los nombres de los campos y se cumple en los datos sin que la plataforma lo indique.guarantee:enforcedodeclared, como en el caso de una clave.description: indica cuándo se cumple una relacióntextualocandidate. Una relación de estos tipos no se cumple para todas las filas.name: el nombre de la clave externa en la plataforma, cuando tiene una.
Este servidor lee una entidad por llamada y no combina datos. Un cliente de IA lee las filas relacionadas con una segunda llamada a read_records, filtrando por los valores de fields.
El rendimiento contiene los siguientes miembros, cuando el controlador de la plataforma los indica:
accessLatencyMs: el tiempo medio de un viaje de ida y vuelta a la plataforma, en milisegundos.fullScanRowsPerMinute: el número medio de filas por minuto cuando se lee la entidad completa.pointQueryRowsPerMinute: el número medio de filas por minuto cuando las filas se leen mediante un filtro sobre una clave.estimatedFullScanSeconds: una estimación del tiempo para leer cada fila de la entidad, a partir deestimatedRowCountyfullScanRowsPerMinute. Está presente solo cuando se conocen ambos.
Las cifras son promedios estáticos del driver para la plataforma y no mediciones de esta base de datos. La cifra de escritura no se devuelve, ya que el servidor solo lee. Un driver que no indica cifras deja performance fuera.
El tamaño de la respuesta está limitado a 60,000 caracteres por defecto. El ajuste MaxDescribeEntityResponseChars cambia ese límite y MaxSelectedPartitionsDescribed el número de particiones listadas en dataContainerDetails. Ambos están disponibles desde la versión 27.0 y 26.0, respectivamente. Cuando los campos no caben, los campos de las claves van primero. Las claves, las relaciones y el rendimiento nunca se omiten.
Los siguientes argumentos describen una entidad de la base de datos:
{ "entity": "SalesInvoices" }
Lectura de registros
read_records lee filas de una entidad. Un cliente de IA la invoca una vez que describe_entities ha mostrado qué entidad contiene los datos y describe_entity ha listado sus campos. La herramienta acepta los siguientes argumentos:
entity: el nombre de la entidad, tal como lo devuelvedescribe_entities. Obligatorio.select: una lista de nombres de campos separados por comas, tal como los devuelvedescribe_entity, en la notación$selectde la interfaz de consulta OData versión 4.filter: la condición que deben cumplir las filas, en la notación$filter, con los operadoreseq,ne,gt,ge,lt,le,and,orynot.orderby: una lista de campos con una dirección, en la notación$orderby, comoAmountDC desc.first: el número máximo de filas que se leerán. Si se omite, se leen todas las filas que cumplen el filtro.
La lectura se traduce en una sentencia select y se ejecuta con la autorización del usuario que ha iniciado sesión. Las filas se devuelven como contenido estructurado, un objeto por fila con los campos seleccionados. No hay cursor ni paginación. Un cliente de IA pasa first salvo que quiera el conjunto completo, y acota la respuesta con filter y orderby.
Un campo o literal que el analizador de OData no conoce se rechaza con el código de mensaje itgenmcp640. Cuando el rechazo se refiere a un campo, la sugerencia indica los campos de la entidad más parecidos. Las fechas y los números se escriben sin comillas.
Los siguientes argumentos leen las cinco facturas abiertas más grandes de una entidad:
{ "entity": "SalesInvoices"
, "select": "InvoiceNumber,AmountDC"
, "filter": "Status eq 20"
, "orderby": [ "AmountDC desc" ]
, "first": 5
}
Análisis de una lectura
analyze_records recibe los argumentos de read_records: entity, que es obligatorio, y select, filter, orderby y first. La lectura se traduce en la misma instrucción select, se ejecuta con la misma autorización y se registra de la misma forma. Sus filas se leen y se cuentan, pero no se devuelven. La respuesta contiene:
sqlStatement: la sentenciaselectque se ejecutó.rowsReturnedyrowsRead: las filas que devolvió la sentencia y las filas que leyó de todas las tablas.counters: lo que contó la sentencia, sumado en todos los pasos, comoPairsEvaluatedoRowsSorted; solo los contadores que no son cero.steps: un objeto por cada paso de la ejecución, como la lectura de una tabla, una unión o una ordenación, con los mismos miembros que una línea del archivo/stepsde Invantive Data Hub: el tipo y la descripción del paso, las filas de entrada y de salida, la duración, el tiempo de procesador y la asignación incluidos los pasos inferiores, las mismas cifras sin los pasos inferiores tal como las mide explain analyze, cómo una unión emparejó sus filas, el número de filas que declara una tabla y los contadores del propio paso. Los miembros de un paso se escriben como en esa línea, empezando por mayúscula, comoExclusiveCpuMs.
Un cliente de IA lo invoca cuando una lectura es lenta o lee más filas de las que devuelve, por ejemplo para ver si un filtro se pasó al contenedor de datos, qué algoritmo de unión se eligió o qué paso asignó la memoria. Medir cada paso cuesta una lectura del tiempo de procesador por fila y por paso, lo que solo esta herramienta hace.
Los siguientes argumentos analizan la lectura de las cinco facturas abiertas más grandes de una entidad, con los mismos argumentos que read_records usaría:
{ "entity": "SalesInvoices"
, "select": "InvoiceNumber,AmountDC"
, "filter": "Status eq 20"
, "orderby": [ "AmountDC desc" ]
, "first": 5
}
Lectura del usuario actual
current_cloud_user devuelve el perfil del usuario que ha iniciado sesión y de la organización de ese usuario, tal como se guardan en Invantive Cloud. Un cliente de IA la invoca cuando la respuesta depende de quién pregunta o de a qué organización pertenecen los datos. La herramienta no acepta argumentos y no lee nada de la base de datos.
La respuesta contiene los siguientes miembros del usuario:
Uid,IwidyCognitoUserId: los identificadores del usuario, del usuario web y en el proveedor de identidad.Name,GivenNameyFamilyName: el nombre completo, el nombre de pila y el apellido.Gender:Mpara masculino,Fpara femenino yUpara desconocido.JobTitle: el cargo.EmailAddress,PhoneNumberyMobileNumber: cómo llegar al usuario.LanguageCode: el idioma en formato ISO 639-1. Se usa el idioma predeterminado del servicio cuando el usuario no tiene ninguno.CreatedUtcyModifiedUtc: cuándo se creó el usuario y cuándo se modificó por última vez.LogInStartUtcyLogInEndUtc: el periodo en el que el usuario puede iniciar sesión.UserIconUrlyUserIcon: la miniatura del usuario como dirección y en forma binaria.
La respuesta contiene los siguientes miembros de la organización del usuario:
PartyName: el nombre de la organización. Primero se usa el nombre del perfil del usuario, y el nombre que tiene la propia organización cuando el perfil no tiene ninguno. La alternativa está disponible desde la versión 27.0.PartyAddressLine1,PartyAddressLine2,PartyAddressLine3,PartyPostalCode,PartyCityyPartyCountry: la dirección. Primero se usa el país de la organización, y el país del perfil del usuario cuando la organización no tiene ninguno. La alternativa está disponible desde la versión 27.0.PartyEmailAddress,PartyPhoneyPartyWebSite: cómo contactar con la organización.PartyLegalStructure: la forma jurídica, comoNL-BV.PartyCoCNumber,PartyVatNumber,PartyIbanyPartyBic: el número de la Cámara de Comercio, el número de IVA, el IBAN y el BIC.
Los miembros PartyCurrencyCode, PartyState, PartyGlnNumber, PartyRsinNumber, PartySiretNumber, PartyPaypalIdentifier y PartyWageTaxNumber forman parte de la respuesta, pero el servicio no los rellena. Invantive Cloud no tiene ningún valor para ellos.
Comprobación de la sintaxis de SQL
check_sql analiza una o más instrucciones Invantive UniversalSQL y PSQL, separadas por ;, sin ejecutarlas y sin leer la base de datos. Un cliente de IA la llama sobre una instrucción que escribió para Invantive Data Hub, Invantive Query Tool o un script, antes de que la instrucción consuma presupuesto o cambie datos. Los nombres de tablas y columnas no se comprueban, ya que eso requiere la base de datos. Disponible a partir de la versión 28.0.
La herramienta recibe un argumento, sql, con como máximo 1,000,000 caracteres. La respuesta contiene:
Valid:truecuando las instrucciones siguen la gramática.MessageCode,MessageyHint: el error de sintaxis, su mensaje con un extracto y marcadores de posición, y qué hacer. Los códigos se explican en Syntax Errors.Url: la dirección de la sección del código de mensaje en Syntax Errors.Position:LineyColumn, contados desde 1 con un tabulador como una columna,Offset, contado desde 0 en el texto, yLength, el número de caracteres marcados.Syntax:Kindcomomissingopremature-end,Expectedcon lo que es válido en la posición, como lista de elementos sin traducir comoFROM,,,nameoexpression, yContextcon la parte de la instrucción comowhereClause.
Un error de sintaxis es la respuesta de la herramienta y no un fallo de ella: el resultado no se marca como error.
Herramientas en Invantive Cloud Status
Las herramientas de estado permiten a un cliente de IA leer y mantener una página de estado de Invantive Cloud Status, por ejemplo para responder si un servicio está caído o para informar de una interrupción. Solo se ofrecen en un servidor donde están definidos los ajustes StatusPage:Server y StatusPage:ApiToken: la dirección del servidor de estado, como https://statuspage.invantive.eu, y un token de API de un inquilino, creado en «Settings» y «API tokens». StatusPage:TimeoutSec define el número de segundos que puede tardar una llamada, con un valor predeterminado de 20. Las herramientas todavía no están publicadas.
Las herramientas trabajan sobre las páginas del tenant del token. Basta un token con el ámbito de lectura para las tres herramientas que leen. Las cuatro herramientas que cambian la página de estado necesitan un token con ámbito de escritura; con un token de ámbito de lectura, el servidor de estado las rechaza. Un cambio es visible para los lectores de inmediato y puede notificar a los suscriptores, por lo que se indica al cliente de IA que confirme el texto con el usuario antes de llamar.
Los estados de un componente son operational, degraded_performance, partial_outage, major_outage y under_maintenance. Las fases de un incidente son investigating, identified, monitoring y resolved.
status_get_summary no recibe argumentos. La respuesta contiene:
overallState: el estado más grave de los componentes que cuentan para el estado general.componentCount: el número de componentes.componentsNotOperational: por cada componente que no esté operativo, su códigocomponent,name,statey el momentosinceen que mantiene ese estado.openIncidents: por cada incidente que no esté resuelto, supublicId,title,phase,impactystartedAt.maintenance: el mantenimiento en curso o previsto dentro de siete días, conpublicId,title,phase,windowStartywindowEnd.
status_list_incidents acepta dos argumentos opcionales:
openOnly: si es verdadero, solo los incidentes que no están resueltos. El valor predeterminado es false.first: el número de los incidentes más recientes que se devolverán, de 1 a 100. El valor por defecto es 20.
La respuesta contiene incidents, con los mismos miembros por incidencia que openIncidents de status_get_summary.
status_get_incident toma el publicId de un incidente, como 2026-0187. La respuesta es el incidente tal como lo devuelve la API de gestión del servidor de estado, con sus componentes afectados y su estado, su cronología de actualizaciones con su fase y su versión.
status_create_incident acepta:
title: el título que ven los lectores. Obligatorio.message: la primera actualización, para clientes.impact: uno denone,minor,majorocritical. El valor por defecto esminor.phase: la fase de la primera actualización. El valor por defecto esinvestigating.template: el código de una plantilla de incidencia, que completa lo que no se indica.components: los componentes afectados, cada uno con su códigocomponenty lastateque recibe mientras el incidente está abierto.
status_add_update acepta:
publicId: el id público del incidente. Obligatorio.message: el texto de la actualización, para clientes. Obligatorio.phase: la fase de la actualización. Obligatorio. La faseresolvedcierra el incidente y devuelve sus componentes a operativos.internalNote: una nota solo para operadores, que nunca se publica ni se envía.
status_set_component_state acepta:
component: el código del componente, tal como lo devuelvestatus_get_summary. Obligatorio.state: el nuevo estado. Obligatorio.hold: cuando es verdadero, las sondas no cambian el estado hasta que un operador lo libera. El valor predeterminado es true.
status_schedule_maintenance acepta:
title: el título que ven los lectores. Obligatorio.message: qué ocurre y qué notan los lectores. Obligatorio.windowStartywindowEnd: el inicio y el fin de la ventana como fecha y hora ISO 8601 con desfase horario, como2026-11-08T06:00:00+01:00. Obligatorio.components: los códigos de los componentes afectados.autoStart: inicia el mantenimiento al comienzo de la ventana. El valor predeterminado es true.autoComplete: completa el mantenimiento al final de la ventana. El valor predeterminado es true.muteProbes: silencie las sondas de los componentes afectados durante la ventana de tiempo. El valor predeterminado es true.
Las herramientas que modifican la página de estado devuelven el incidente, el componente o el mantenimiento tal como lo devuelve el servidor de estado tras el cambio.
Seguimiento del tamaño de una respuesta
Invantive MCP Server escribe en la traza el tamaño de cada respuesta en caracteres. El tamaño es la cantidad de la línea de traza con el código de mensaje itgenmcp664, que se escribe en el nivel de depuración. Suma el contenido estructurado y los bloques de texto de la respuesta, y el mensaje indica la herramienta, la base de datos y ambas partes. La línea se escribe tanto para una respuesta correcta como para una fallida, ya que el cliente de IA las lee en su contexto. El envoltorio mensaje JSON-RPC no se cuenta. Disponible a partir de la versión 27.0.
Cuando falla una herramienta
Una herramienta que falla responde con isError activado y los detalles en el contenido estructurado, para que el cliente de IA pueda indicar al usuario qué debe hacer. La respuesta contiene:
MessageyMessageCode: qué salió mal y el código que hay que citar al pedir ayuda.KindRequest: la pista, que es el siguiente paso para el cliente de IA o el usuario. Cada respuesta tiene uno. Cuando no se conoce una sugerencia específica, indica si hay que volver a enviar la solicitud, corregirla o informar al usuario.NaturalKey: de qué trata el mensaje, como la base de datos o la entidad solicitada.IsRecoverable: verdadero cuando volver a enviar la misma solicitud más adelante puede tener éxito y falso cuando no puede. Se omite cuando nada indica ninguna de las dos cosas.RetryAfterSec: el número de segundos que el servicio aconseja esperar antes de volver a enviar la misma solicitud, por un bloqueo o por la cabeceraRetry-Afterde la plataforma. Está presente solo cuandoIsRecoverablees verdadero y se recomendó una espera; no se inventa ninguna espera. Cuando la espera es superior a 60 segundos, la sugerencia indica al cliente de IA que deje la espera en manos del usuario. Disponible a partir de la versión 27.0.Actor: quién debe actuar primero.aicuando el cliente de IA puede corregir la solicitud o esperar y enviarla de nuevo,usercuando una persona debe decidir o actuar fuera de la conversación, como en una licencia, una dirección IP o un inicio de sesión, yforumscuando nadie puede resolverlo en la conversación, por lo que la referencia y el código de mensaje se buscan o se notifican en los foros. Una espera de más de 60 segundos corresponde al usuario. Disponible a partir de la versión 27.0.HelpUrl: la dirección del tema del foro o de la página de ayuda sobre el código de mensaje, cuando se conoce. Disponible a partir de la versión 27.0.Uid: la referencia del fallo, para indicar al soporte.
Una solicitud de una entidad o un campo que no existe indica en la pista los nombres existentes más parecidos. describe_entities hace lo mismo con los nombres de su argumento entities, en unknownEntitiesHint. Ambos están disponibles a partir de la versión 27.0.
Una solicitud desde una dirección IP que no está autorizada para la base de datos se rechaza con el código de mensaje itgenmcp326. El mensaje indica la dirección y la sugerencia indica la base de datos a la que debe añadirse.
Una herramienta de estado que falla responde de la misma manera. Cuando el servidor de estado rechaza la llamada, MessageCode contiene el código de mensaje del servidor de estado, o itgenmst001 cuando la respuesta no contiene ninguno. Una denegación por falta de alcance de escritura indica al usuario que solicite un token con alcance de escritura. itgenmst002 significa que las herramientas de estado no están configuradas en el servidor, y itgenmst003 que no se puede acceder al servidor de estado.