Partilhar via

Utilizar o intérprete de código para gerar e executar código Python

O interpretador de código no Microsoft Copilot Studio e os prompts do construtor de prompts permitem que os criadores criem 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 do Copilot Studio para criar soluções avançadas e condicionadas 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.

Requerimentos

Capacidades do intérprete de código de relance

O intérprete de código permite que os agentes escrevam e executem 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:

  • Usando a opção Criar o seu próprio pedido no Hub de IA do Power Apps
  • Dentro de uma ferramenta de pedidos adicionada a um agente no Copilot Studio ao nível do agente

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

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

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

Primeiro, você começa criando 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 prompt no Power Apps AI Hub e ativar o interpretador de código

Você pode criar um novo prompt vazio no AI Hub no Power Apps e ativar o interpretador de código nas configurações de 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. Aceder ao 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

Você pode criar um novo prompt vazio como uma 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, vá para o agente onde você deseja 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 prompt do construtor de prompt incorporado é aberta 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

  • Use outras ferramentas de IA, como o Copilot, para obter o pedido otimizado para iniciar.
  • 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.
  • Last updated on