Partilhar via

Fonte de dados do Inventário do Agente

Este artigo é a referência autorizada para a tabela Detalhes do Agente no Dataverse, que alimenta a página Inventário do Agente no Copilot Studio Kit. A tabela Detalhes do agente lista todos os campos, a origem do Dataverse ou a regra de deteção, a versão e uma descrição concisa para os consumidores a jusante.

Audiência

  • Engenheiros e integradores de plataforma implementando lógica de sincronização ou validação
  • Operadores e equipes de suporte solucionam problemas de configurações de agentes
  • Analistas e autores de relatórios consumindo Detalhes do agente para painéis e relatórios

Como usar este artigo

  • Use a tabela de esquema para nomes exatos de colunas, tipos de dados e fontes.
  • Use as regras de derivação ao implementar a lógica de deteção ou testes de validação.
  • A coluna Versão indica a maturidade do campo (V1, V2).

Terminologia

  • As tabelas do Dataverse referenciadas incluem bot, botcomponent, processes, e conversationtranscript.
  • "Tópico v2" denota o esquema de tópico da plataforma usado em fluxos de conversação.

Tabela de detalhes do agente

A tabela a seguir fornece detalhes sobre a tabela Agent Details Dataverse, que alimenta a página Agent Inventory .

Sugestão

Para melhor legibilidade, selecione Expandir tabela para visualizar a tabela inteira.

Não Nome da coluna Nome do esquema de coluna Tipo de dados Fonte Versão Description
1 ID do Agente cat_agentid Texto Dataverse: Tabela bot → botid coluna V1 Identificador exclusivo do Dataverse para o agente (botid).
2 Nome cat_name Texto Dataverse: Tabela bot → name coluna V1 O nome de exibição do agente.
3 Tipo cat_type Texto Valor codificado como personalizado V2 Tipo de agente (Declarativo, Personalizado).
4 Nome do Ambiente cat_environmentname Texto Power Platform Admin connector—List environments as admin saída: preferir friendlyName, fallback para displayName ou properties.linkedEnvironmentMetadata.friendlyName V1 Nome de exibição do ambiente onde o agente é implantado.
5 ID do Ambiente cat_environmentid Texto Power Platform Admin connector—List environments as admin saída: name (identificador da instância) V1 Identificador exclusivo para o ambiente (nome da instância).
6 Tipo de ambiente cat_environmenttype Texto Power Platform Admin connector—List environments as admin saída: properties.environmentSku V1 Ambiente SKU/tipo (Produção, Desenvolvimento).
7 Description cat_description Texto Multilinha Dataverse: Tabela botcomponent onde componenttypename = GPT personalizada (15) → description coluna V1 Descrição do agente legível por humanos.
8 Instruções cat_Instructions Texto Multilinha Dataverse: Tabela botcomponent (GPT personalizada) → coluna YAML data → instructions propriedade V1 Instruções para o administrador ou orientação de uso para o agente.
9 Data de criação do agente cat_agentcreateddate DateTime Dataverse: Tabela bot → createdon coluna V1 Criação de carimbo de data/hora para o agente.
10 Data de modificação do agente cat_agentmodifieddate DateTime Dataverse: Tabela bot → modifiedon coluna V1 Carimbo de data/hora da última modificação para o agente.
11 Agente criado por cat_agentcreatedby Texto Dataverse: Tabela bot → createdby coluna V1 Usuário que criou o agente.
12 Agente modificado por cat_agentmodifiedby Texto Dataverse: Tabela bot → modifiedby coluna V1 Usuário que modificou o agente pela última vez.
13 Estado Gerenciado cat_managedstate Texto Dataverse: Tabela bot → ismanaged coluna V1 Indica se o agente é gerenciado ou não gerenciado.
14 Publicado cat_published booleano Dataverse: Tabela bot → data de publicação presente → verdadeira V1 True se o agente tiver uma data publicada.
15 Data de Publicação cat_publisheddate DateTime Dataverse: Tabela bot → published coluna (data publicada) V1 Carimbo de data/hora quando o agente foi publicado.
16 Publicado por cat_publishedby Texto Dataverse: Tabela bot → publishedby coluna V2 Usuário que publicou o agente.
17 ID do aplicativo padrão cat_defaultapplicationid Texto Dataverse: Tabela bot → synchronizationstatus propriedade JSON → applicationId V1 ID do aplicativo padrão associado ao agente.
18 Usa Gen AI cat_usesgenai booleano Derivado: verdadeiro se o agente usa qualquer uma das ações, prompts, fontes de conhecimento, MCP, respostas personalizadas, fontes generativas clássicas, conhecimento de IA ou tem orquestração generativa V1 Indica se o agente usa recursos de IA generativa.
19 Tipo de orquestração cat_orchestrationtype Texto Dataverse: Tabela bot → → configurationGenerativeActionsEnabled JSON (verdadeiro → generativo; caso contrário, clássico) V1 Tipo de orquestração (generativa ou clássica).
20 Agente Autónomo cat_AutonomousAgent booleano Dataverso: Tabela botcomponent → componenttypename = Gatilho Externo (17) → presença = verdadeiro V2 True se o agente contiver um componente de gatilho externo (autônomo).
21 Utiliza Resultados de Pesquisa Avançados cat_usesenhancedsearchresults booleano Dataverse: Tabela bot → configuration → isSemanticSearchEnabled JSON (true → true) V1 Indica se a pesquisa semântica/aprimorada está habilitada.
22 Usa ferramentas cat_usesactions booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém TaskDialog → true V1 True se o agente usa nós de ferramenta/ação.
23 Usa conhecimento de IA cat_usesaiknowledge booleano Dataverse: Tabela bot → configuration → useModelKnowledge JSON (true → true) V1 Indica se o agente tem permissão para usar conhecimentos gerais de IA.
24 Usa fontes de conhecimento cat_UsesKnowledgeSources booleano Dataverse: Tabela botcomponent onde componenttypename = Anexo de Arquivo Bot ou Fontes de Conhecimento → data.KnowledgeSourceConfiguration apresentam → verdadeiro V1 True se alguma fonte de conhecimento estiver configurada.
25 Usa fontes de respostas generativas clássicas cat_UsesClassicGenerativeAnswersSources booleano Dataverse: Tabela botcomponent (Tópico v2) → Na data coluna, a propriedade searchAndSummarizeContent contém qualquer uma das fontes clássicas: publicdatasource, sharePointSearchDataSource, customdatasource e azureopenaionyourdatasource → true V2 True se as fontes de resposta generativas clássicas estiverem configuradas.
26 Usa prompts cat_usesaibuilderprompts booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém InvokeAIBuilderModelAction → true V1 True se os prompts forem usados.
27 Usa MCP cat_UsesMCP booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém kind: InvokeExternalAgentTaskAction → true V2 True se as ações MCP (Model Context Protocol) estiverem presentes.
28 Usa resposta personalizada cat_UsesCustomizedResponse booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém kind: AnswerQuestionWithAI → true V2 True se nós de resposta personalizados estiverem presentes.
29 Usa o contexto de autenticação do Connector Maker cat_UsesConnectorMakerAuthContext booleano Dataverso: botcomponent.data → connectionProperties.mode = maker → verdadeiro V2 True se qualquer conector estiver configurado para ser executado no modo de autenticação do fabricante.
30 Usa o contexto de autenticação do Cloud Flow cat_UsesCloudFlowAuthContext booleano Dataverse: Tabela processes →clientdata.connectionreferences + impersonation/runtimesource lógica (impersonation = {} ou embedded runtimesource → maker; impersonation.source=invoker → invoker) V2 Indica se os fluxos de nuvem invocados exigem contexto de autenticação do criador ou do invocador.
31 Tipo de autenticação End-User cat_enduserauthenticationtype Texto Dataverse: Tabela bot → authenticationmode coluna V1 Modo de autenticação do usuário final para o agente.
32 Usa solicitações HTTP cat_useshttprequests booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém HttpRequestAction → true V1 True se o agente emitir ações de solicitação HTTP.
33 Usa Habilidades cat_usesskills booleano Dataverse: Tabela botcomponent (Tópico v2) → data contém InvokeSkillAction → true V2 True se o agente invocar habilidades.
34 Fontes de Conhecimento cat_knowledgesources Texto Multilinha Dataverse: Tabela botcomponent onde componenttypename = Anexo de Arquivo Bot ->FileDataName ou Fontes de Conhecimento → data.KnowledgeSourceConfiguration V1 Lista de fontes de conhecimento configuradas (configuração bruta).
35 Fontes de dados clássicas cat_ClassicDataSources Texto Multilinha Dataverse: Tabela botcomponent (Tópico v2) → Na data coluna, a propriedade searchAndSummarizeContent contém qualquer uma das fontes clássicas: publicdatasource, sharePointSearchDataSource, customdatasource e azureopenaionyourdatasource V2 Lista de fontes de dados clássicas referenciadas pelo agente.
36 Ações de solicitação Http cat_httprequestactions Texto Multilinha Dataverse: Tabela botcomponent (Tópico v2) → data contém HttpRequestAction entradas V1 Lista de ações de solicitação HTTP configuradas.
37 Pedidos cat_aibuilderprompts Texto Multilinha Dataverse: Tabela botcomponent (Tópico v2) → data contém InvokeAIBuilderModelAction entradas V1 Lista de prompts usados pelo agente.
38 Connections cat_Connections Texto Multilinha Conexões de agentes: botcomponent.data.connectionreference + connectionProperties.mode; Conexões de fluxo: processes.clientdata.connectionreferences (api name, impersonation, runtimesource) — derivar o nome da conexão e o modo de autenticação (maker ou invoker) V2 Nomes de conexão de conector/fluxo e modos de autenticação inferidos (maker/invoker).
39 Gatilhos do agente cat_AgentTriggers Texto Multilinha Dataverse: Tabela botcomponent → componenttypename = Gatilho Externo (17) → data.triggerConnectionType V2 Lista de conectores de gatilho usados pelo agente.
40 Usa fontes de conhecimento personalizadas cat_UsesCustomKnowledgesSources booleano Dataverse: Tabela botcomponent (Tópico v2) → data começa com kind: AdaptiveDialog e beginDialog.kind: OnKnowledgeRequested → verdadeiro V2 True se caixas de diálogo de solicitação de conhecimento adaptáveis personalizadas estiverem presentes.
41 Usa modelos de raciocínio profundo cat_UsesDeepReasoningModels booleano Dataverse: Tabela bot → configuration.optInUseLatestModels (true → true) V2 True se o agente optar por modelos de raciocínio mais recentes/mais profundos.
42 Usa a entrada de arquivo cat_UsesFileInput booleano Dataverse: Tabela bot → configuration.isFileAnalysisEnabled (true → true) V2 True se a análise/entrada de arquivos estiver habilitada.
43 EnvironmentUrl cat_EnvironmentUrl Texto Power Platform Admin connector—List environments as admin saída: URL da instância V2 URL da instância do ambiente.
44 IsTranscriptAvailable cat_IsTranscriptAvailable Texto Dataverse: conversationtranscript tabela — presença indica disponibilidade V2 Indica se existem transcrições de conversas para o agente.

Regras de derivação e deteção de campo

As seguintes regras de deteção aplicam-se a cada campo derivado ou booleano. Os nomes das colunas de esquema são indicados entre parênteses.

  • ID do agente (cat_agentid): Dataverse bot.botid.
  • Nome (cat_name): Dataverse bot.name.
  • Tipo (cat_type): valor Custom codificado (V2).
  • Nome do ambiente (cat_environmentname): Power Platform Admin connector List environments as admin—prefira friendlyName, fallback para displayName ou properties.linkedEnvironmentMetadata.friendlyName.
  • ID do ambiente (cat_environmentid): admin connector name (identificador de instância).
  • Tipo de ambiente (cat_environmenttype): admin connector properties.environmentSku.
  • Descrição (cat_description): botcomponent onde componenttypename = GPT personalizado (15) → description.
  • Instruções (cat_Instructions): botcomponent (GPT personalizado) → YAML data.instructions.
  • Data de criação do agente (cat_agentcreateddate): bot.createdon.
  • Data de modificação do agente (cat_agentmodifieddate): bot.modifiedon.
  • Agente criado por (cat_agentcreatedby): bot.createdby.
  • Agente modificado por (cat_agentmodifiedby): bot.modifiedby.
  • Estado gerenciado (cat_managedstate): bot.ismanaged (gerenciado vs não gerenciado).
  • Publicado (cat_published): true quando bot contém um carimbo de data/hora publicado.
  • Data de publicação (cat_publisheddate): bot.published carimbo de data/hora.
  • Publicado por (cat_publishedby): bot.publishedby.
  • ID do aplicativo padrão (cat_defaultapplicationid): bot.synchronizationstatus JSON → applicationId.
  • Usa Gen AI (cat_usesgenai): true se o agente usa qualquer uma das ferramentas/ações, prompts, fontes de conhecimento, MCP, respostas personalizadas, fontes generativas clássicas, conhecimento de IA ou tem orquestração generativa habilitada.
  • Tipo de orquestração (cat_orchestrationtype): bot.configuration.GenerativeActionsEnabled → generative mais classic.
  • Agente Autônomo (cat_AutonomousAgent): true quando botcomponent.componenttypename = Gatilho Externo (17) existe.
  • Usa Resultados de Pesquisa Avançados (cat_usesenhancedsearchresults): bot.configuration.isSemanticSearchEnabled = true.
  • Usa Ferramentas (cat_usesactions): O tópico v2 botcomponent.data contém TaskDialog entradas.
  • Usa conhecimento de IA (cat_usesaiknowledge): bot.configuration.useModelKnowledge = true.
  • Usa fontes de conhecimento (cat_UsesKnowledgeSources): presença de entradas KnowledgeSources botcomponent (data.KnowledgeSourceConfiguration ou entradas de anexo de arquivo Bot).
  • Usa fontes de respostas generativas clássicas (cat_UsesClassicGenerativeAnswersSources): O tópico v2 data.searchAndSummarizeContent inclui tipos de fonte clássicos (publicdatasource, sharePointSearchDataSource, customdatasource, azureopenaionyourdatasource).
  • Usa prompts (cat_usesaibuilderprompts): O tópico v2 data contém InvokeAIBuilderModelAction.
  • Usa MCP (cat_UsesMCP): O tópico v2 data contém kind: InvokeExternalAgentTaskAction.
  • Usa resposta personalizada (cat_UsesCustomizedResponse): O tópico v2 data contém kind: AnswerQuestionWithAI.
  • Usa o contexto de autenticação do Connector Maker (cat_UsesConnectorMakerAuthContext): qualquerbotcomponent.data.connectionProperties.mode = maker .
  • Usa o Cloud Flow Auth Context (cat_UsesCloudFlowAuthContext): derivado do processes.clientdata.connectionreferences uso impersonation e runtimesource regras (impersonation = {} ou embedded runtimesource → maker; impersonation.source = invoker → invoker).
  • End-User Tipo de autenticação (cat_enduserauthenticationtype): bot.authenticationmode.
  • Usa solicitações HTTP (cat_useshttprequests): O tópico v2 data contém HttpRequestAction entradas.
  • Usa habilidades (cat_usesskills): O tópico v2 data contém InvokeSkillAction entradas.
  • Fontes de conhecimento (cat_knowledgesources): raw data.KnowledgeSourceConfiguration from botcomponent (multi-line JSON/YAML).
  • Fontes de dados clássicas (cat_ClassicDataSources): Entradas clássicas do tópico v2 data.searchAndSummarizeContent agregadas.
  • Http Request Actions (cat_httprequestactions): Tópico v2 data → HttpRequestAction configurações.
  • Prompts (cat_aibuilderpromts): Tópico v2 data → InvokeAIBuilderModelAction configurações.
  • Conexões (cat_Connections): agregar de e botcomponent.data.connectionreference (nome da api, representação, runtimesource) para derivar o nome da + connectionProperties.modeprocesses.clientdata.connectionreferences conexão e o modo de autenticação (maker/invoker).
  • Gatilhos do agente (cat_AgentTriggers): botcomponent linhas onde componenttypename = Gatilho externo (17) → data.triggerConnectionType.
  • Informações de uso: coletadas de pontos de extremidade da API de licenciamento para relatórios de direitos e consumo.
  • Usa fontes de conhecimento personalizadas (cat_UsesCustomKnowledgesSources): O tópico v2 data começa com kind: AdaptiveDialog e beginDialog.kind: OnKnowledgeRequested.
  • Usa Modelos de Raciocínio Profundo (cat_UsesDeepReasoningModels): bot.configuration.optInUseLatestModels = true.
  • Usa a entrada de arquivo (cat_UsesFileInput): bot.configuration.isFileAnalysisEnabled = true.
  • EnvironmentUrl (cat_EnvironmentUrl): conector List environments as admin admin → URL da instância.
  • IsTranscriptAvailable (cat_IsTranscriptAvailable): true quando existem registros para o agente em conversationtranscript.
  • Last updated on