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

O intérprete de código no Microsoft Copilot Studio e os pedidos do criador de pedidos permitem que os criadores criem agentes de IA que:

• Executem 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 do Copilot Studio para criar soluções avançadas e condicionadas por IA.

Os programadores devem ler o Intérprete de código para programadores e rever o Exemplo de componente do Power Apps Component Framework (PCF) do intérprete de código para compreender como podem utilizar a mensagem Predict do Dataverse para invocar pedidos e processar as respostas devolvidas.

Pré-requisitos

• Licenciamento: faturação e licenciamento do Microsoft Copilot Studio. A geração e execução de código contam como caraterísticas de ferramentas de texto e de IA generativa (premium).

• Regiões suportadas: disponível para todas as clouds públicas. As clouds soberanas não são atualmente suportadas.

Capacidades do intérprete de código

Os agentes que utilizam intérprete de código podem escrever e executar código Python para tarefas avançadas. Os casos de utilização incluem:

• Processamento de ficheiros do Excel: crie, copie e atualize folhas de cálculo do Excel num livro, leia e aplique estilos de células, 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 de tabelas do 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 um tipo de saída em pedidos.
• Suporte para ficheiros do Excel como tipos de entrada e saída para pedidos.

Crie pedidos de uma das duas formas seguintes:

• No Power Apps: Utilize a opção Criar o seu próprio pedido no Hub de IA.
• No Copilot Studio: Adicione um pedido como uma ferramenta ao nível do agente ou do tópico.

Saiba mais sobre pedidos em Descrição geral dos pedidos.

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

Inicie um novo pedido no Hub de IA do Power Apps e ative o intérprete de código

Pode iniciar um novo pedido no Hub de AI no Power Apps e ativar o intérprete de código nas definições do pedido.

1. Aceder ao Power Apps

2. Selecione Hub de IA no painel esquerdo.

3. Selecione Pedidos.

   

4. Selecione Criar o seu próprio pedido.

   

5. Introduza um nome para o pedido.

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

   

7. Nas Definições, ative o intérprete de código.

8. Feche Definições para regressar ao editor de pedidos.

O editor de pedido está aberto com o intérprete de código ativado. De seguida, escreva instruções para o seu pedido.

Inicie um novo pedido como uma ferramenta dentro de um agente e ative o intérprete de código

É possível iniciar um novo pedido como uma ferramenta dentro de um agente em Copilot Studio e ative o intérprete de código para esse pedido.

1. No Copilot Studio, aceda ao agente onde pretende utilizar o intérprete de código.

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

   • Adicione um pedido ao nível do agente:

     1. Aceda à página Ferramentas.

     2. Selecione Adicionar uma ferramenta>Pedido.

   • Adicione um pedido a nível do tópico:

     1. Aceda à página Tópicos e selecione o tópico onde pretende adicionar o pedido.

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

     3. Selecione Adicionar uma ferramenta>Novo pedido.

   A interface de criação de pedidos do construtor de pedidos incorporada é aberta.

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

   

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

5. Feche Definições para regressar ao editor de pedidos.

O editor de pedido está aberto com o intérprete de código ativado. De seguida, escreva instruções para o seu pedido.

Escrever instruções para o seu pedido

Em seguida, pode escrever as instruções do pedido, configurar o pedido conforme necessário e guardar para criar o pedido.

Saiba mais sobre como usar o intérprete de código em pedidos em Exemplos de pedidos do intérprete de código.

Melhores práticas para o intérprete de código em pedidos

• 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

• A análise de vários ficheiros carregados num único pedido não é suportada.
• A devolução de vários ficheiros de saída num só pedido não é suportada.
• Não há suporte para fazer perguntas sobre um ficheiro carregado em vários turnos.
• Para utilizar o intérprete de código, precisa de configurar o seu 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 em cenários que utilizam o intérprete de código.

Resolução de Problemas

Se encontrar erros ao usar o intérprete de código, siga os seguintes passos:

1. Certifique-se de que todas as permissões necessárias foram concedidas. Verifique se a conta de utilizador e o agente têm as permissões necessárias para executar os pedidos do intérprete de código.
2. Verifique as definições de configuração. Confirme se o intérprete de código está ativado nas definições de pedido e que o seu agente está configurado para utilizar autenticação de utilizador.
3. Consulte os registos de erros para obter informações detalhadas. Reveja os registos de erros no Copilot Studio ou no ambiente Power Platform associado para identificar a causa raiz do problema e tomar medidas corretivas.

Informações relacionadas

• Utilizar intérprete de código para analisar dados estruturados
• Intérprete de código para programadores
• Exemplo de componente PCF do intérprete de código