Referência de componentes na Biblioteca de Agentes no Copilot Agent Kit

Os componentes na Biblioteca de Agentes são coleções de componentes pré-construídas e reutilizáveis que podes adicionar a qualquer agente do Copilot Studio. Cada componente é embalado como uma coleção de componentes próprio, por isso instala apenas os componentes de que precisa.

Este artigo é a referência por componente. Para uma visão geral dos componentes, como navegar e instalar componentes do kit e como adicioná-los ao seu agente, consulte Gestão de Componentes na Biblioteca de Agentes.

Componentes num relance

A Biblioteca de Agentes inclui os seguintes componentes distribuídos pelas suas soluções. Componentes que não requerem referências de ligação estão numa solução base própria. Os componentes que partilham um conector comum são agrupados.

Prerequisites

Antes de começar, certifique-se de que são cumpridos os seguintes pré-requisitos:

• Instale e configure o Copilot Agent Kit no seu ambiente Power Platform.
• O utilizador iniciado tem o papel de segurança CSK - Maker atribuído no Copilot Agent Kit para navegar e instalar componentes.
• O ambiente Power Platform tem o Copilot Studio ativado.
• Tenha créditos AI Builder disponíveis no seu ambiente (necessários para componentes baseados em prompts).
• Para o ServiceNow Ticket Assistant, tenha uma instância ServiceNow com acesso à API REST e uma ligação ServiceNow configurada na Power Platform. Saiba mais sobre a configuração do principal de serviço ServiceNow.

Document Extraction

A Extração de Documentos transforma documentos carregados em dados estruturados. Utiliza um prompt do AI Builder para analisar e extrair campos-chave com base num esquema configurável.

Quando utilizar: Processamento de faturas, revisão de contratos, digitalização de formulários ou qualquer cenário que exija recolher informação estruturada de documentos não estruturados.

Como funciona a Extração de Documentos

1. O utilizador carrega um documento na conversa do agente.
2. O componente processa o documento com o AI Builder.
3. O componente devolve dados extraídos como saída estruturada que pode armazenar, mostrar ou passar para fluxos a jusante.

Entradas de extração de documentos

Saídas de extração de documentos

Todos os prompts do AI Builder são devolvidos.

Content Synthesizer

O Content Synthesizer transforma resultados brutos de pesquisa numa secção de investigação estruturada e baseada em evidências, com citações em linha. É o motor de síntese partilhado usado tanto pelos pipelines do Componente de Investigação como do Componente Executivo Brief. Também pode ser adicionado a qualquer agente como uma ferramenta autónoma para síntese de conteúdos sob demanda.

Quando usar: Qualquer cenário que exija sintetizar múltiplos documentos fonte numa narrativa coesa e baseada em citações, seja como parte de um pipeline em múltiplas etapas ou como uma ferramenta autónoma de geração de conteúdo.

Como funciona o Content Synthesizer

1. O pipeline pai (ou agente) transmite um prompt de pesquisa, conteúdo bruto dos resultados de pesquisa e instruções de estilo opcionais.
2. O enunciado integra insights de todas as fontes por tema. Não resume fonte por fonte.
3. A evidência baseia-se no conteúdo fornecido, com pontos de dados específicos como números, percentagens, datas e entidades nomeadas.
4. A saída é um objeto JSON contendo a secção de markdown sintetizada e um array de citações extraídas.

Entradas do Sintetizador de Conteúdo

Saídas do Sintetizador de Conteúdo

O prompt devolve um objeto JSON com dois campos:

Estrutura de saída do sintetizador de conteúdos

A secção sintetizada segue esta estrutura:

• Abertura: Apresenta as descobertas mais importantes e antecipa os temas-chave.
• Corpo: Organizado por tema (não por fonte), com marcadores de atribuição e [n] citação em linha, chamadas a negrito para a Descoberta de Chaves e marcadores opcionais [CHART SUGGESTION] .
• Conclusões-chave: Três a cinco pontos concisos e acionáveis.
• Rodapés: Avaliação de confiança (de Alta a Baixa), atualidade dos dados e lacunas notáveis.

Research Component

O Componente de Investigação sintetiza informação de múltiplas fontes num relatório de investigação abrangente. Utiliza um pipeline de IA em três fases para planear, pesquisar e compilar conclusões.

Quando utilizar: Análise da concorrência, investigação de mercado, revisão de políticas ou qualquer cenário que exija uma visão consolidada em múltiplas fontes de informação.

Como funciona o Componente de Investigação

1. O utilizador fornece uma pergunta ou tema de investigação.
2. Fase 1 (Planeador de Investigação): Cria um plano de investigação estruturado com secções e questões.
3. Fase 2 (Sintetizador de Conteúdo): Pesquisa fontes web para cada secção e gera conteúdo com citações.
4. Fase 3 (Finalizador de Relatório): Combina todas as secções e citações num relatório polido.
5. O relatório final é apresentado em linha na conversa.

Entradas do Componente de Investigação

Resultados dos Componentes de Investigação

O componente apresenta o relatório em linha na conversa.

Componente do Resumo Executivo

O Executive Brief Component gera resumos concisos e orientados para a decisão a partir de entradas complexas. Utiliza um pipeline de IA em três etapas para planear, sintetizar insights e compilar um briefing executivo polido.

Quando utilizar: Preparação para reuniões do conselho, atualizações do estado do projeto, revisões trimestrais de negócio ou qualquer cenário que exija um resumo polido para as partes interessadas.

Como funciona o Componente do Briefing Executivo

1. O utilizador fornece um tópico ou pergunta breve.
2. Fase 1 (Planeador de Briefings Executivos): Cria um plano estratégico de investigação com áreas de investigação.
3. Fase 2 (Insight Synthesizer, alimentado pelo Content Synthesizer): Pesquisa em fontes internas e web de cada área e extrai factos-chave e citações.
4. Fase 3 (Finalizador de Briefs): Compila todos os insights e citações num briefing executivo polido.
5. O resumo é apresentado em linha na conversa.

Contributos para o Componente do Briefing Executivo

Resultados do Componente do Resumo Executivo

O componente apresenta o briefing executivo em linha na conversa.

Assistente de Bilhetes ServiceNow

O ServiceNow Ticket Assistant fornece gestão de incidentes de ponta a ponta diretamente de um agente da Copilot Studio. Inclui cinco tópicos que abrangem todo o ciclo de vida do incidente.

Quando utilizar: help desk de TI, self-service de colaboradores ou qualquer cenário que envolva gestão de incidentes com o ServiceNow.

O ServiceNow incluiu tópicos

ServiceNow prerequisites

Este componente é fornecido na sua própria solução (CopilotStudioKit_ServiceNow_Components) porque requer uma referência de ligação ServiceNow durante a importação. Antes de importar esta solução, certifique-se de que tem:

• Uma instância ServiceNow com acesso à API REST.
• Uma ligação configurada no Power Platform para o ServiceNow. És solicitado a configurar isto durante a importação da solução.
• Permissões de utilizador do ServiceNow apropriadas para as operações necessárias.

Configuração do principal de serviço ServiceNow

Para configurar uma ligação ServiceNow Power Platform que utilize Microsoft Entra ID, siga os passos em Como configurar uma ligação ServiceNow Power Platform que utilize Microsoft Entra ID.

Como funciona o Assistente de Bilhetes ServiceNow

1. O utilizador expressa uma intenção (por exemplo, "Preciso de criar um ticket" ou "Qual é o estado de INC0012345?").
2. O tema apropriado é ativado e apresenta uma carta adaptativa para recolher os inputs necessários.
3. O componente chama a API ServiceNow através de um conector e devolve o resultado.
4. Após a conclusão da operação, o tópico Próximas Ações apresenta opções para o próximo passo.

Create incident

Cria um novo incidente ServiceNow recolhendo dados do utilizador e submetendo-os ao ServiceNow através de um conector.

Quando utilizar: Help desk de TI, self-service de colaboradores ou qualquer cenário em que os utilizadores precisem registar novos incidentes diretamente da conversa.

Criar fluxo de incidentes

1. O utilizador expressa a intenção de criar um incidente, como "Preciso de abrir um ticket para um portátil avariado."
2. Um cartão adaptativo recolhe os detalhes necessários do incidente.
3. O componente chama a API ServiceNow para criar o incidente e retorna uma confirmação com o número do incidente.
4. É apresentado um menu de Próximas Ações para que o utilizador possa continuar com outra operação ServiceNow.

Criar entradas de incidente através de cartão adaptativo

Criar saídas de incidente

Mensagem de confirmação com o número de incidente criado exibido em linha.

Verificar o estado do incidente

Recupera o estado e detalhes mais recentes de um incidente existente do ServiceNow.

Verificar o estado do incidente

1. O utilizador pergunta sobre um incidente, por exemplo, "Qual é o estado do INC0010002?"
2. Um cartão adaptativo recolhe o número do incidente.
3. O componente consulta o ServiceNow e devolve os detalhes do incidente.

Verifique as entradas de estado do incidente através do cartão adaptativo

Verificar as saídas do estado do incidente

Resolver ou fechar incidente

Atualiza o estado de um incidente ServiceNow existente para Resolvido, Encerrado, Cancelado, Em Espera ou Em Progresso, juntamente com detalhes da resolução.

Resolver ou fechar o fluxo de incidentes

1. O utilizador expressa a intenção de resolver ou encerrar um incidente, como "Fechar INC0010002 do ticket."
2. Um cartão adaptativo recolhe o número do incidente, o estado do alvo, o código de resolução e as notas de resolução.
3. O componente atualiza o incidente no ServiceNow e devolve uma confirmação.

Pré-requisitos para resolver ou encerrar incidentes

Uma instância ServiceNow com acesso à API REST e uma ligação ServiceNow na Power Platform.

Resolver ou fechar entradas de incidentes através de cartão adaptativo

Resolver ou fechar saídas de incidente

Mensagem de confirmação com o estado atualizado do incidente exibido em linha.

Obtenha incidentes recentes

Recupera e exibe até 10 incidentes recentes do ServiceNow para o utilizador atual. Não são necessários campos de entrada. O componente utiliza automaticamente o email do utilizador iniciado sessão.

Quando usar: Quando os utilizadores querem uma visão geral rápida dos seus incidentes recentes ou abertos.

Acompanhe o fluxo dos incidentes recentes

1. O utilizador pergunta sobre os seus incidentes, como "Mostrar os meus incidentes recentes."
2. O componente consulta o ServiceNow para até 10 incidentes recentes que correspondam ao email do utilizador iniciado.
3. Os detalhes do incidente são apresentados em linha na conversa.

Obtenha informações sobre incidentes recentes

None. O componente utiliza automaticamente o email do utilizador iniciado sessão.

Obtenha resultados de incidentes recentes

Painel de detalhes dos componentes

Quando abres um componente da Biblioteca de Agentes no Copilot Agent Kit, o painel de detalhes mostra a descrição do componente, categoria, variáveis de entrada e saída, e a tecnologia utilizada.

Para instalar um componente e adicioná-lo a um fluxo de trabalho de agente, consulte Gestão de Componentes.

Use componentes com uma solução gerida

Use a solução gerida para a maioria dos utilizadores. Os componentes importados são de apenas leitura. Pode adicioná-los aos seus agentes e usá-los sem risco de alterar acidentalmente os temas, prompts ou fluxos subjacentes.

Mesmo sem editar os próprios componentes, tens duas formas de controlar o comportamento: instruções de agente e predefinidos de entrada de ferramentas.

Agent instructions

O campo Instruções do seu agente do Copilot Studio é a principal forma de moldar a forma como os componentes são utilizados. Através de instruções em linguagem natural, pode controlar:

• Quando um componente é invocado: Descreva os cenários ou intenções do utilizador que devem ativar cada ferramenta.
• Que dados são transmitidos: Diga ao agente que contexto, variáveis ou histórico de conversas deve incluir.
• Como os resultados são apresentados: Especifique formatação, tom, ações subsequentes ou roteamento após um componente devolver a sua saída.
• Orquestração geral: Defina a ordem das operações quando estão envolvidos múltiplos componentes, como por exemplo: "Após concluir a investigação, gere um briefing executivo a partir dos resultados."

Entradas de ferramentas por defeito

Quando adiciona componentes como ferramentas, como os prompts do AI Builder, pode configurar parâmetros de entrada diretamente no Copilot Studio, mesmo usando uma solução gerida. Estes inputs permitem-te definir padrões mais específicos do que aquilo que as instruções do agente sozinhas conseguem alcançar. For example:

• Forneça um padrão ExtractionSchema adaptado aos documentos da sua empresa, como campos de fatura como nome, número de fatura e data.
• Preencha AdditionalInstructions com o estilo de escrita preferido da sua organização ou com os requisitos de conformidade.

Os valores por defeito de entrada são configurados por agente, pelo que diferentes agentes podem passar valores distintos ao mesmo componente partilhado.

Personalize componentes com uma solução não gerida

Se precisar de modificar os componentes internos, como alterar a lógica de prompts, editar fluxos de tópicos ou reconfigurar conectores, deve importar a solução não gerida. Esta solução dá-lhe acesso total de edição a todos os temas, prompts e fluxos na Biblioteca de Agentes.

Personalizações comuns incluem:

• Modificar prompts: Ajuste os prompts do AI Builder para corresponderem ao seu domínio e formato de saída.
• Alterar fontes de dados: Aponte componentes para as suas próprias tabelas Dataverse, listas SharePoint ou conectores externos.
• Ajuste os temas: Atualize os fluxos das conversas para corresponder à terminologia e aos processos da sua organização.
• Atualizar frases gatilho: Adicione frases gatilho que reflitam como os seus utilizadores naturalmente pedem as coisas.
• Adicionar autenticação: Configurar a autenticação se os componentes precisarem de aceder a dados específicos do utilizador.

Related information

• Components management
• Documentação do AI Builder