Partilhar via

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

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:

  • Executar código Python para análise de dados, processamento de ficheiros 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 programadores devem ler o interpretador de código para programadores e rever o exemplo de componente do Power Apps Component Framework (PCF) do interpretador de código para perceber como podem usar a mensagem do Dataverse para invocar prompts e processar as respostas devolvidas.

Requerimentos

Capacidades do intérprete de código de relance

O interpretador de código permite aos agentes escrever e executar código Python para tarefas avançadas. Os casos de uso incluem:

  • Processamento de ficheiros do Excel: crie, copie e atualize folhas de cálculo do Excel num livro, leia StyleNames, aplique StyleNames, copie formatação entre células, copie e atualize fórmulas entre células, etc.
  • Processamento de ficheiros Word e PowerPoint.
  • Processamento de ficheiros PDF: crie e copie ficheiros PDF, leia 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 arquivos como um tipo de saída nos prompts
  • Suporte para ficheiros do Excel como tipos de entrada e saída para pedidos

Você pode criar prompts de duas maneiras:

  • Usar a opção Cria o teu próprio prompt no AI Hub em Power Apps
  • Dentro de uma ferramenta de prompts adicionada a um agente no Copilot Studio no nível do agente

Para obter mais informações sobre prompts, consulte Visão geral de prompts.

Também pode usar o interpretador de código no chat do agente no Copilot Studio.

Crie um novo prompt vazio e ative o interpretador de código para o prompt

Primeiro, começa por criar um novo prompt vazio no AI Hub ou no Copilot Studio. Em seguida, ative o interpretador de código nas configurações de prompt.

Criar um prompt no Power Apps AI Hub e ativar o interpretador de código

Podes criar um novo prompt vazio no AI Hub no Power Apps e ativar o interpretador de código nas definições do prompt. Você pode ver exemplos de como escrever e configurar prompts que usam interpretador de código, consulte Usar interpretador de código em exemplos de prompts.

  1. Vai 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. Forneça o nome do pedido.

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

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

  7. Na página Configurações , ative o interpretador de código.

  8. Feche a página de definições para regressar ao editor de pedidos.

Um prompt vazio é criado com o interpretador de código ativado. Em seguida, você pode escrever as instruções do prompt e configurá-lo conforme necessário.

Criar um prompt como uma ferramenta dentro de um agente e ativar o interpretador de código

Podes criar um novo prompt vazio como ferramenta dentro de um agente no Copilot Studio e ativar o interpretador de código para esse prompt. Mais adiante neste artigo, mostraremos como escrever e configurar um prompt que usa o interpretador de código.

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

  2. Selecione o separador Ferramentas e, em seguida, selecione Adicionar uma ferramenta>Nova ferramenta>Pedido.

    Captura de tela mostrando a seleção de uma ferramenta de prompt.

    A interface de criação de prompts incorporada abre no Copilot Studio.

  3. Na barra de informações, selecione os três pontos (...), 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. Feche a página de definições para regressar ao editor de pedidos.

Um prompt vazio é criado com o interpretador de código ativado. Em seguida, você pode escrever as instruções do prompt e configurá-lo conforme necessário.

Próximos passos com o interpretador de código em prompts

Em seguida, você pode escrever as instruções do prompt e configurá-lo conforme necessário.

Para obter exemplos detalhados de como usar o interpretador de código em prompts, consulte Exemplos de prompt do 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 Linha Direta sem autenticação selecionada não funcionará 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