Use um interpretador de código num prompt para gerar e executar código em Python

Note

As funcionalidades deste artigo são alimentadas pelo arnês padrão, que utiliza as opções de faturação descritas em Licenciamento para agentes alimentados pelo chicote padrão. Aprenda a aceder a funcionalidades padrão nos agentes e fluxos de agentes padrão do Access.

O interpretador de código no Microsoft Copilot Studio e a ferramenta de criação de prompts permite aos criadores desenvolver agentes de IA que:

  • Execute código Python para análise de dados, processamento de arquivos Word, Excel, PowerPoint e PDF e visualizações
  • Utilizem modelos de linguagem para respostas generativas

Esta funcionalidade é adaptado para programadores, analistas de negócios e criadores de low-code. A geração e execução de código integram-se perfeitamente com o ecossistema Copilot Studio para criar soluções poderosas e orientadas por IA.

Os desenvolvedores devem ler Interpretador de código para desenvolvedores e revisar o Exemplo de componente PCF (Power Apps Component Framework) do interpretador de código para entender como eles podem usar a mensagem Dataverse Predict para invocar prompts e processar as respostas retornadas.

Pré-requisitos

Capacidades do interpretador de código

Agentes que usam um interpretador de código podem escrever e executar código Python para tarefas avançadas. Os casos de uso incluem:

  • Processamento de ficheiros Excel: Crie, copie e atualize folhas de trabalho Excel num livro de trabalho, leia e aplique estilos de células, copie formatação entre células, copie e atualize fórmulas entre células e mais.
  • Processamento de ficheiros Word e PowerPoint.
  • Processamento de ficheiros PDF: Criar e copiar ficheiros PDF, ler tabelas e parágrafos de texto.
  • Processamento de dados da tabela Dataverse.
  • Cálculos matemáticos e estatísticos complexos.
  • Análise, manipulação e visualização de dados (por exemplo, gráficos e tabelas).

O intérprete de código adiciona as seguintes capacidades aos pedidos:

  • Suporte para ficheiros como formato de saída em prompts.
  • Suporte para ficheiros Excel como formatos de entrada e saída para indicações.

Note

Para pesquisar sobre o conteúdo do ficheiro Excel, use o interpretador de código em vez da pesquisa semântica. A pesquisa semântica tem limitações para a indexação de células.

Crie prompts de uma das duas formas:

  • Em Power Apps: Use a opção Construa o seu próprio prompt no AI Hub.
  • No Copilot Studio: Adicione um prompt como ferramenta ao nível do agente ou do tema.

Saiba mais sobre os prompts na visão geral dos prompts.

Você também pode usar o interpretador de código no bate-papo do agente no Copilot Studio.

Inicie um novo prompt no Power Apps AI Hub e ative o interpretador de código

Podes iniciar um novo prompt no AI Hub no Power Apps e ativar o interpretador de código nas definições do prompt.

  1. Aceder a Power Apps.

  2. Selecione AI hub no painel esquerdo.

  3. Selecione Pedidos.

    Captura de tela mostrando a seleção de prompts no hub AI.

  4. Selecione Criar o seu próprio pedido.

    Captura de tela da seleção de criar seu próprio prompt no hub de IA.

  5. Introduza um nome para o seu prompt.

  6. Na secção de Instruções , selecione os três pontos (...), e depois selecione Definições.

    Captura de tela de como abrir as configurações de prompt.

  7. Nas Definições, ativa o interpretador de código.

  8. Fecha as Definições para voltar ao editor de prompts.

O editor de prompts está aberto com o interpretador de código ativado. De seguida, escreva instruções para o seu prompt.

Inicie um novo prompt como ferramenta dentro de um agente e ative o interpretador de código

Podes iniciar um novo prompt como ferramenta dentro de um agente em Copilot Studio e ativar o interpretador de código para esse prompt.

  1. No Copilot Studio, vai ao agente onde queres usar o interpretador de código.

  2. Adicione um novo prompt ao agente como ferramenta, seja ao nível do agente ou ao nível do tópico.

    • Adicione um prompt ao nível do agente:

      1. Vai à página de Ferramentas .

      2. Selecionar Adicionar uma ferramenta>Prompt.

    • Adicione um prompt ao nível do tema:

      1. Vai à página de Tópicos e seleciona o tema onde queres adicionar o prompt.

      2. Selecione Adicionar nó na posição do tópico onde quer adicionar o prompt.

      3. Selecione Adicionar uma ferramenta>Novo prompt.

    A interface de criação de prompts embutida do construtor de prompts abre-se.

  3. Na barra de informações, selecione os três pontos (...), e depois selecione Definições.

    Captura de tela mostrando as configurações do prompt de abertura.

  4. Na página Definições, selecione Ativar o intérprete de código.

  5. Fecha as Definições para voltar ao editor de prompts.

O editor de prompts está aberto com o interpretador de código ativado. De seguida, escreva instruções para o seu prompt.

Escreva instruções para o seu prompt

De seguida, podes escrever as instruções do prompt, configurar o prompt conforme necessário e guardar para criar o prompt.

Saiba mais sobre como usar o interpretador de código em prompts em exemplos de prompts de interpretador de código.

Práticas recomendadas para interpretador de código em prompts

  • Usa outras ferramentas de IA como o Copilot para obter o prompt otimizado para começar.
  • Use pedidos precisos com exemplos (pedidos de poucas capturas).
  • Especifique as saídas (por exemplo, "Devolver como JSON" ou "Excel" ou "PDF").

Limitações

  • Não há suporte para a análise de vários arquivos carregados em um único prompt.
  • Não há suporte para o retorno de várias saídas de arquivo em um único prompt.
  • Não há suporte para fazer perguntas sobre um arquivo carregado em vários turnos.
  • Para usar o interpretador de código, precisas de configurar o teu agente, nas definições do agente, para usar autenticação de utilizador. Por exemplo, usar Direct Line com Sem autenticação selecionado não funciona para cenários usando o interpretador de código.

Troubleshooting

Se encontrar erros ao usar o interpretador de código, experimente os seguintes passos:

  1. Assegure que todas as permissões necessárias são concedidas. Verifique se a conta de utilizador e o agente têm as permissões necessárias para executar os prompts do interpretador de código.
  2. Verifique as definições de configuração. Confirme que o interpretador de código está ativado nas definições de prompt e que o seu agente está configurado para usar autenticação de utilizador.
  3. Consulte os registos de erros para informações detalhadas. Revise os registos de erros no Copilot Studio ou no ambiente Power Platform associado para identificar a causa raiz do problema e tomar medidas corretivas.
  • Last updated on