Compartilhar via


Fonte de dados de inventário do agente

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

Público

  • Engenheiros e integradores de plataforma implementando lógica de sincronização ou validação
  • Operadores e equipes de suporte solucionando problemas de configurações do agente
  • Analistas e autores de relatório que consomem detalhes do agente para dashboards e relatórios

Como utilizar este artigo

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

Terminologia

  • As tabelas do Dataverse referenciadas incluem bot, botcomponente processesconversationtranscript.
  • "Tópico v2" indica o esquema de tópico da plataforma usado em fluxos de conversação.

Tabela Detalhes do Agente

A tabela a seguir fornece detalhes sobre a tabela Dataverse de Detalhes do Agente, que alimenta a página Inventário do Agente .

Dica

Para obter melhor legibilidade, selecione Expandir tabela para exibir a tabela inteira.

Não Nome da coluna Nome do esquema de coluna Tipo de dados Source Versão Description
1 ID do Agente cat_agentid Texto Dataverse: coluna → bot de tabela botid V1 Identificador exclusivo do Dataverse para o agente (botid).
2 Nome cat_name Texto Dataverse: coluna → bot de tabela name 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 Conector do Administrador do Power Platform–List environments as admin saída: prefer friendlyName, fallback to displayName ou properties.linkedEnvironmentMetadata.friendlyName V1 Nome de exibição do ambiente em que o agente é implantado.
5 ID do Ambiente cat_environmentid Texto Conector do Administrador do Power Platform –List environments as admin saída: name (identificador de instância) V1 Identificador exclusivo para o ambiente (nome da instância).
6 Tipo de ambiente cat_environmenttype Texto Conector do Administrador do Power Platform –List environments as admin saída: properties.environmentSku V1 SKU/tipo de ambiente (Produção, Desenvolvimento).
7 Description cat_description Texto de Várias Linhas Dataverse: Tabela botcomponent em que componenttypename = GPT personalizado (15) → description coluna V1 Descrição legível pelo agente.
8 Instruções cat_Instructions Texto de Várias Linhas Dataverse: propriedade botcomponent → coluna YAML data → tabela (GPT personalizado) → instructions V1 Instruções voltadas para o administrador ou diretrizes de uso para o agente.
9 Data de criação do agente cat_agentcreateddate DateTime Dataverse: coluna → bot de tabela createdon V1 Carimbo de data/hora de criação para o agente.
10 Data da modificação do agente cat_agentmodifieddate DateTime Dataverse: coluna → bot de tabela modifiedon V1 Carimbo de data/hora da última modificação para o agente.
11 Agente criado por cat_agentcreatedby Texto Dataverse: coluna → bot de tabela createdby V1 Usuário que criou o agente.
12 Agente modificado por cat_agentmodifiedby Texto Dataverse: coluna → bot de tabela modifiedby V1 Usuário que modificou o agente pela última vez.
13 Estado Gerenciado cat_managedstate Texto Dataverse: coluna → bot de tabela ismanaged V1 Indica se o agente é gerenciado ou não gerenciado.
14 Publicado cat_published booleano Dataverse: Data da publicação bot → tabela → verdadeira V1 True se o agente tiver uma data publicada.
15 Data de publicação cat_publisheddate DateTime Dataverse: coluna → de tabela botpublished (data publicada) V1 Carimbo de data/hora quando o agente foi publicado.
16 Publicado por cat_publishedby Texto Dataverse: coluna → bot de tabela publishedby V2 Usuário que publicou o agente.
17 ID do aplicativo padrão cat_defaultapplicationid Texto Dataverse: Propriedade de → bot JSON de → synchronizationstatus de tabela applicationId V1 ID do aplicativo padrão associada ao agente.
18 Usa a IA de Geração cat_usesgenai booleano Derivado: true 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 generativos.
19 Tipo de orquestração cat_orchestrationtype Texto Dataverse: → JSON de botconfiguration de tabela GenerativeActionsEnabled (verdadeiro → generativo; caso contrário, clássico) V1 Tipo de orquestração (generativo ou clássico).
20 Agente Autônomo cat_AutonomousAgent booleano Dataverse: Table botcomponentcomponenttypename = External Trigger (17) → presence = true V2 True se o agente contiver um componente de gatilho externo (autônomo).
21 Usa resultados avançados da pesquisa cat_usesenhancedsearchresults booleano Dataverse: → JSON de botconfiguration de tabela isSemanticSearchEnabled (true → true) V1 Indica se a pesquisa semântica/aprimorada está habilitada.
22 Usa ferramentas cat_usesactions booleano Dataverse: → de tabela botcomponent (Tópico v2) data contém TaskDialog → true V1 True se o agente usa nós de ferramenta/ação.
23 Usa o conhecimento de IA cat_usesaiknowledge booleano Dataverse: → JSON de botconfiguration de tabela useModelKnowledge (true → true) V1 Indica se o agente tem permissão para usar conhecimento geral de IA.
24 Usa fontes de conhecimento cat_UsesKnowledgeSources booleano Dataverse: Tabela botcomponent em que componenttypename = Anexo de Arquivo de Bot ou fontes de conhecimento → data.KnowledgeSourceConfiguration presentes → true V1 True se alguma fonte de conhecimento estiver configurada.
vinte e cinco Usa fontes de respostas generativas clássicas cat_UsesClassicGenerativeAnswersSources booleano Dataverse: Table botcomponent (Topic 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: → de tabela botcomponent (Tópico v2) data contém InvokeAIBuilderModelAction → true V1 True se os prompts forem usados.
27 Usa MCP cat_UsesMCP booleano Dataverse: → de tabela botcomponent (Tópico v2) data contém kind: InvokeExternalAgentTaskAction → true V2 True se as ações do PROTOCOLO MCP (Model Context Protocol) estiverem presentes.
28 Usa resposta personalizada cat_UsesCustomizedResponse booleano Dataverse: → de tabela botcomponent (Tópico v2) data contém kind: AnswerQuestionWithAI → true V2 True se os nós de resposta personalizados estiverem presentes.
29 Usa o contexto de autenticação do Conector Maker cat_UsesConnectorMakerAuthContext booleano Dataverse: botcomponent.dataconnectionProperties.mode = maker → true V2 True se qualquer conector estiver configurado para ser executado no modo de autenticação do criador.
30 Usa o contexto de autenticação de fluxo de nuvem cat_UsesCloudFlowAuthContext booleano Dataverse: lógica de →processesclientdata.connectionreferences + impersonation/ de tabela runtimesource (representação = {} ou runtimesource inserido → maker; impersonation.source=invoker → invoker) V2 Indica se os fluxos de nuvem invocados exigem o contexto de autenticação do criador ou do invocador.
31 Tipo de Autenticação End-User cat_enduserauthenticationtype Texto Dataverse: coluna → bot de tabela authenticationmode V1 Modo de autenticação do usuário final para o agente.
32 Usa solicitações HTTP cat_useshttprequests booleano Dataverse: → de tabela botcomponent (Tópico v2) data contém HttpRequestAction → true V1 True se o agente emite ações de solicitação HTTP.
33 Usa habilidades cat_usesskills booleano Dataverse: → de tabela botcomponent (Tópico v2) data contém InvokeSkillAction → true V2 True se o agente invocar habilidades.
34 Fontes de conhecimento cat_knowledgesources Texto de Várias Linhas Dataverse: Tabela botcomponent em que componenttypename = Anexo de Arquivo de 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 de Várias Linhas Dataverse: Table botcomponent (Topic 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 de Várias Linhas Dataverse: a tabela botcomponent (Tópico v2) → data contém HttpRequestAction entradas V1 Lista de ações de solicitação HTTP configuradas.
37 Solicitações cat_aibuilderprompts Texto de Várias Linhas Dataverse: a tabela botcomponent (Tópico v2) → data contém InvokeAIBuilderModelAction entradas V1 Lista de prompts usados pelo agente.
38 Conexões cat_Connections Texto de Várias Linhas Conexões de agente: botcomponent.data.connectionreference + connectionProperties.mode; Conexões de fluxo: processes.clientdata.connectionreferences (nome da api, representação, runtimesource)— derivar o nome da conexão e o modo de autenticação (criador ou invocador) V2 Nomes de conexão de conector/fluxo e modos de autenticação inferidos (criador/invocador).
39 Gatilhos do agente cat_AgentTriggers Texto de Várias Linhas Dataverse: → de botcomponent Tabela 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: → de Tabela botcomponent (Tópico v2) data começa com kind: AdaptiveDialog e beginDialog.kind: OnKnowledgeRequested → true V2 True se os diálogos personalizados de solicitação de conhecimento adaptável estiverem presentes.
41 Usa modelos de raciocínio profundo cat_UsesDeepReasoningModels booleano Dataverse: → de tabela botconfiguration.optInUseLatestModels (true → true) V2 True se o agente optar por modelos de raciocínio mais recentes/mais profundos.
42 Usa entrada de arquivo cat_UsesFileInput booleano Dataverse: → de tabela botconfiguration.isFileAnalysisEnabled (true → true) V2 True se a análise/entrada de arquivo estiver habilitada.
43 EnvironmentUrl cat_EnvironmentUrl Texto Conector do Administrador do Power Platform –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 — a presença indica disponibilidade V2 Indica se as transcrições de conversa existem para o agente.

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

As regras de detecção a seguir se aplicam a cada campo derivado ou booliano. 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 em código (V2).
  • Nome do Ambiente (cat_environmentname): Conector List environments as admindo Administrador do Power Platform —prefer friendlyName, fallback to displayName ou properties.linkedEnvironmentMetadata.friendlyName.
  • ID do ambiente (cat_environmentid): conector name de administrador (identificador de instância).
  • Tipo de ambiente (cat_environmenttype): conector properties.environmentSkude administrador.
  • Descrição (cat_description): em que botcomponentcomponenttypename = 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 da 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 versus não gerenciado).
  • Publicado (cat_published): true quando bot contém um carimbo de data/hora publicado.
  • Data da Publicação (cat_publisheddate): bot.published carimbo de data/hora.
  • Publicado por (cat_publishedby): bot.publishedby.
  • ID do aplicativo padrão (cat_defaultapplicationid): bot.synchronizationstatusapplicationIdJSON .
  • Usa a IA gen (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.GenerativeActionsEnabledgenerative mais classic.
  • Agente Autônomo (cat_AutonomousAgent): true quando botcomponent.componenttypename = Gatilho Externo (17) existe.
  • Usa resultados de pesquisa aprimorados (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 do KnowledgeSources botcomponent (data.KnowledgeSourceConfiguration ou entradas de Anexo de Arquivo de Bot).
  • Usa fontes de respostas generativas clássicas (cat_UsesClassicGenerativeAnswersSources): o tópico v2 data.searchAndSummarizeContent inclui tipos de origem 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 Conector Maker (cat_UsesConnectorMakerAuthContext): qualquerbotcomponent.data.connectionProperties.mode = maker .
  • Usa o Contexto de Autenticação do Fluxo de Nuvem (cat_UsesCloudFlowAuthContext): derivado de processes.clientdata.connectionreferences uso impersonation e runtimesource regras (representação = {} ou runtimesource inserido → maker; impersonation.source = invocador → invocador).
  • 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): brutas data.KnowledgeSourceConfiguration de botcomponent (JSON/YAML de várias linhas).
  • Fontes de Dados Clássicas (cat_ClassicDataSources): Entradas clássicas do tópico v2 data.searchAndSummarizeContent agregadas.
  • Ações de Solicitação Http (cat_httprequestactions): Tópico v2 dataHttpRequestAction configurações.
  • Prompts (cat_aibuilderpromts): Tópico v2 dataInvokeAIBuilderModelAction configurações.
  • Conexões (cat_Connections): agregar de e botcomponent.data.connectionreference (nome da + connectionProperties.modeprocesses.clientdata.connectionreferences api, representação, runtimesource) para derivar o nome da conexão e o modo de autenticação (criador/invocador).
  • Gatilhos do agente (cat_AgentTriggers): botcomponent linhas em que componenttypename = Gatilho Externo (17) → data.triggerConnectionType.
  • Informações de uso: coletados 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 entrada de arquivo (cat_UsesFileInput): bot.configuration.isFileAnalysisEnabled = true.
  • EnvironmentUrl (cat_EnvironmentUrl): conector List environments as admin de administrador → URL da instância.
  • IsTranscriptAvailable (cat_IsTranscriptAvailable): true quando existem registros para o agente em conversationtranscript.