Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O interpretador de código no Microsoft Copilot Studio e os prompts do builder permitem que os criadores desenvolvam agentes de IA que:
- Execute código Python para análise de dados, processamento de arquivos Word, Excel, PowerPoint e PDF, e visualizações.
- Usar modelos de linguagem para respostas generativas
Esse recurso é personalizado para desenvolvedores, analistas de negócios e criadores de low-code. A geração e a execução de código se integram perfeitamente ao ecossistema Copilot Studio para criar soluções avançadas e orientadas por IA.
Os desenvolvedores devem ler o Code interpreter para desenvolvedores e examinar o exemplo de componente do Code interpreter Power Apps Component Framework (PCF) para entender como podem usar a mensagem do Dataverse Predict para invocar prompts e processar as respostas retornadas.
Requirements
Licenciamento: cobrança e licenciamento do Microsoft Copilot Studio. Geração de código e contagem de execução como recursos de texto e ferramentas de IA generativas (premium).
Regiões com suporte: disponíveis para todas as nuvens públicas. Não há suporte para nuvens soberanas.
Funcionalidades do interpretador de código
Os agentes que usam o interpretador de código podem escrever e executar Python código para tarefas avançadas. Os casos de uso incluem:
- Processamento de arquivos Excel: criar, copiar e atualizar planilhas Excel em uma pasta de trabalho, ler e aplicar estilos de célula, copiar formatação entre células, copiar e atualizar fórmulas em células e muito mais.
- Processamento de arquivos do Word e PowerPoint.
- Processamento de arquivo PDF: criar e copiar arquivos 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 diagramas).
O interpretador de código adiciona os seguintes recursos aos prompts:
- Suporte para arquivos como tipo de saída em prompts.
- Suporte para arquivos Excel como tipos de entrada e saída para prompts.
Crie prompts de uma das duas maneiras:
- Em Power Apps: use a opção Crie seu próprio prompt no Hub de IA.
- Em Copilot Studio: adicione um prompt como uma ferramenta no nível do agente ou do tópico.
Saiba mais sobre prompts em visão geral de prompts.
Você também pode usar o interpretador de código no chat do agente no Copilot Studio.
Iniciar um novo prompt no Hub de IA Power Apps e ativar o interpretador de código
Você pode iniciar um novo prompt no Hub de IA no Power Apps e ativar o interpretador de código nas configurações de prompt.
Vá para Power Apps.
Selecione o hub de IA no painel esquerdo.
Selecione Prompts.
Selecione Criar sua própria solicitação.
Insira um nome para o prompt.
Na seção Instruções , selecione os três pontos (...) e selecione Configurações.
Em Configurações, ative o interpretador de código.
Feche as Configurações para retornar ao editor de prompt.
O editor de prompt é aberto com o interpretador de código ativado. Em seguida, escreva instruções para o prompt.
Iniciar um novo prompt como uma ferramenta dentro de um agente e ativar o interpretador de código
Você pode iniciar um novo prompt como uma ferramenta dentro de um agente em Copilot Studio e ativar o interpretador de código para esse prompt.
Em Copilot Studio, vá para o agente onde você deseja usar o interpretador de código.
Adicione um novo prompt ao agente como uma ferramenta, no nível do agente ou no nível do tópico.
Adicione um prompt no nível do agente:
Vá para a página Ferramentas .
Selecione Adicionar uma ferramenta>Prompt.
Adicione um prompt no nível do tópico:
Vá para a página Tópicos e selecione o tópico no qual você deseja adicionar o prompt.
Selecione Adicionar nó na posição no tópico em que você deseja adicionar o prompt.
Selecione Adicionar uma ferramenta>Novo prompt.
A interface de criação de prompt do construtor de prompts inserida é aberta.
Na barra de informações, selecione os três pontos (...) e selecione Configurações.
Na página Configurações, selecione Habilitar o intérprete de código.
Feche as Configurações para retornar ao editor de prompt.
O editor de prompt é aberto com o interpretador de código ativado. Em seguida, escreva instruções para o prompt.
Escreva instruções para o seu prompt
Em seguida, você pode escrever as instruções de prompt, configurar o prompt conforme necessário e salvar para criar o prompt.
Saiba mais sobre como usar o interpretador de código em prompts em exemplos de prompts do interpretador de código.
Práticas recomendadas para interpretador de código em instruções
- Use outras ferramentas de IA, como Copilot para obter o prompt otimizado para iniciar.
- Use prompts precisos com exemplos (solicitação de poucos exemplos).
- Especifique saídas (por exemplo, "Retornar 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 retornar várias saídas de arquivo em um único prompt.
- Fazer perguntas sobre um arquivo carregado várias vezes não é compatível.
- Para usar o interpretador de código, você precisa configurar seu agente, nas configurações do agente, para usar autenticação de usuário. Por exemplo, usar Direct Line com No authentication selecionado não funciona para cenários usando o interpretador de código.
Solução de problemas
Se você encontrar erros ao usar o interpretador de código, tente as seguintes etapas:
- Verifique se todas as permissões necessárias são concedidas. Verifique se a conta de usuário e o agente têm as permissões necessárias para executar prompts de interpretador de código.
- Verifique as configurações. Confirme se o interpretador de código está habilitado nas configurações de prompt e se o agente está configurado para usar a autenticação do usuário.
- Consulte os logs de erros para obter informações detalhadas. Examine os logs de erros no Copilot Studio ou no ambiente do Power Platform associado para identificar a causa raiz do problema e tomar medidas corretivas.