[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699SBCATA5DEB8KQD8SA1ET":3,"skill-same:01M699SBCATA5DEB8KQD8SA1ET":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M699SBCATA5DEB8KQD8SA1ET","jupyter-notebook",null,"Usado quando o utilizador pede para criar, estruturar ou editar Jupyter notebooks (`.ipynb`) para experiências, explorações ou tutoriais; prefira os modelos incluídos e execute o script auxiliar `new_notebook.py` para gerar um notebook inicial limpo.","microsoft\u002Fai-agents-for-beginners","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998ZK2275KMJE6Y5SEA2X2",79423,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[19],"jupyter notebook","2026-11-10 10:12:30",false,"---\nname: jupyter-notebook\ndescription: Usado quando o utilizador pede para criar, estruturar ou editar Jupyter\n  notebooks (`.ipynb`) para experiências, explorações ou tutoriais; prefira os modelos\n  incluídos e execute o script auxiliar `new_notebook.py` para gerar um notebook inicial\n  limpo.\n---\n# Competência Jupyter Notebook\n\nCrie notebooks Jupyter limpos e reprodutíveis para dois modos principais:\n\n- Experimentos e análise exploratória\n- Tutoriais e walkthroughs orientados ao ensino\n\nPrefira os modelos incluídos e o script auxiliar para uma estrutura consistente e menos erros no JSON.\n\n## Quando usar\n- Crie um novo `.ipynb` notebook a partir do zero.\n- Converta notas soltas ou scripts num notebook estruturado.\n- Refatore um notebook existente para que seja mais reprodutível e fácil de ler.\n- Construa experimentos ou tutoriais que serão lidos ou executados por outras pessoas.\n\n## Árvore de decisão\n- Se o pedido for exploratório, analítico ou orientado por hipóteses, escolha `experiment`.\n- Se o pedido for instrucional, passo-a-passo ou dirigido a um público específico, escolha `tutorial`.\n- Se estiver a editar um notebook existente, trate-o como uma refatoração: preserve a intenção e melhore a estrutura.\n\n## Caminho de competências (definir uma vez)\n\n```bash\nexport CODEX_HOME=\"${CODEX_HOME:-$HOME\u002F.codex}\"\nexport JUPYTER_NOTEBOOK_CLI=\"$CODEX_HOME\u002Fskills\u002Fjupyter-notebook\u002Fscripts\u002Fnew_notebook.py\"\n```\n\nAs skills a nível de utilizador instalam-se em `$CODEX_HOME\u002Fskills` (por omissão: `~\u002F.codex\u002Fskills`).\n\n## Workflow\n1. Defina a intenção.\nIdentifique o tipo de notebook: `experiment` ou `tutorial`.\nRegiste o objetivo, o público e como se percebe que está \"concluído\".\n\n2. Estruture a partir do modelo.\nUse o script auxiliar para evitar criar manualmente o JSON bruto do notebook.\n\n```bash\nuv run --python 3.12 python \"$JUPYTER_NOTEBOOK_CLI\" \\\n  --kind experiment \\\n  --title \"Compare prompt variants\" \\\n  --out output\u002Fjupyter-notebook\u002Fcompare-prompt-variants.ipynb\n```\n\n```bash\nuv run --python 3.12 python \"$JUPYTER_NOTEBOOK_CLI\" \\\n  --kind tutorial \\\n  --title \"Intro to embeddings\" \\\n  --out output\u002Fjupyter-notebook\u002Fintro-to-embeddings.ipynb\n```\n\n3. Preencha o notebook com pequenos passos executáveis.\nMantenha cada célula de código focada num único passo.\nAdicione pequenas células markdown que expliquem o propósito e o resultado esperado.\nEvite saídas grandes e ruidosas quando um resumo curto for suficiente.\n\n4. Aplique o padrão adequado.\nPara experimentos, siga `references\u002Fexperiment-patterns.md`.\nPara tutoriais, siga `references\u002Ftutorial-patterns.md`.\n\n5. Edite com segurança ao trabalhar com notebooks existentes.\nPreserve a estrutura do notebook; evite reordenar células a menos que isso melhore a narrativa de cima para baixo.\nPrefira edições direcionadas em vez de reescritas completas.\nSe tiver de editar o JSON bruto, reveja `references\u002Fnotebook-structure.md` primeiro.\n\n6. Valide o resultado.\nExecute o notebook de cima para baixo quando o ambiente permitir.\nSe a execução não for possível, declare-o explicitamente e indique como validar localmente.\nUse a checklist de passagem final em `references\u002Fquality-checklist.md`.\n\n## Modelos e script auxiliar\n- Os modelos estão em `assets\u002Fexperiment-template.ipynb` e `assets\u002Ftutorial-template.ipynb`.\n- O script auxiliar carrega um modelo, atualiza a célula de título e escreve um notebook.\n\nScript path:\n- `$JUPYTER_NOTEBOOK_CLI` (instalado por omissão: `$CODEX_HOME\u002Fskills\u002Fjupyter-notebook\u002Fscripts\u002Fnew_notebook.py`)\n\n## Convenções para ficheiros temporários e de saída\n- Use `tmp\u002Fjupyter-notebook\u002F` para ficheiros intermédios; elimine quando terminar.\n- Escreva artefactos finais em `output\u002Fjupyter-notebook\u002F` quando trabalhar neste repo.\n- Use nomes de ficheiro estáveis e descritivos (por exemplo, `ablation-temperature.ipynb`).\n\n## Dependências (instalar só quando necessário)\nPrefira `uv` para gestão de dependências.\n\nOptional Python packages for local notebook execution:\n\n```bash\nuv pip install jupyterlab ipykernel\n```\n\nO script de scaffolding incluído usa apenas a biblioteca padrão do Python e não requer dependências extra.\n\n## Ambiente\nNão há variáveis de ambiente obrigatórias.\n\n## Mapa de referência\n- `references\u002Fexperiment-patterns.md`: estrutura de experimentos e heurísticas.\n- `references\u002Ftutorial-patterns.md`: estrutura de tutoriais e fluxo de ensino.\n- `references\u002Fnotebook-structure.md`: forma do JSON do notebook e regras de edição segura.\n- `references\u002Fquality-checklist.md`: checklist de validação final.\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**Aviso legal**:\nEste documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). Embora nos esforcemos por garantir a exatidão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se uma tradução profissional realizada por um tradutor humano. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes da utilização desta tradução.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->","# Competência Jupyter Notebook\n\nCrie notebooks Jupyter limpos e reprodutíveis para dois modos principais:\n\n- Experimentos e análise exploratória\n- Tutoriais e walkthroughs orientados ao ensino\n\nPrefira os modelos incluídos e o script auxiliar para uma estrutura consistente e menos erros no JSON.\n\n## Quando usar\n- Crie um novo `.ipynb` notebook a partir do zero.\n- Converta notas soltas ou scripts num notebook estruturado.\n- Refatore um notebook existente para que seja mais reprodutível e fácil de ler.\n- Construa experimentos ou tutoriais que serão lidos ou executados por outras pessoas.\n\n## Árvore de decisão\n- Se o pedido for exploratório, analítico ou orientado por hipóteses, escolha `experiment`.\n- Se o pedido for instrucional, passo-a-passo ou dirigido a um público específico, escolha `tutorial`.\n- Se estiver a editar um notebook existente, trate-o como uma refatoração: preserve a intenção e melhore a estrutura.\n\n## Caminho de competências (definir uma vez)\n\n```bash\nexport CODEX_HOME=\"${CODEX_HOME:-$HOME\u002F.codex}\"\nexport JUPYTER_NOTEBOOK_CLI=\"$CODEX_HOME\u002Fskills\u002Fjupyter-notebook\u002Fscripts\u002Fnew_notebook.py\"\n```\n\nAs skills a nível de utilizador instalam-se em `$CODEX_HOME\u002Fskills` (por omissão: `~\u002F.codex\u002Fskills`).\n\n## Workflow\n1. Defina a intenção.\nIdentifique o tipo de notebook: `experiment` ou `tutorial`.\nRegiste o objetivo, o público e como se percebe que está \"concluído\".\n\n2. Estruture a partir do modelo.\nUse o script auxiliar para evitar criar manualmente o JSON bruto do notebook.\n\n```bash\nuv run --python 3.12 python \"$JUPYTER_NOTEBOOK_CLI\" \\\n  --kind experiment \\\n  --title \"Compare prompt variants\" \\\n  --out output\u002Fjupyter-notebook\u002Fcompare-prompt-variants.ipynb\n```\n\n```bash\nuv run --python 3.12 python \"$JUPYTER_NOTEBOOK_CLI\" \\\n  --kind tutorial \\\n  --title \"Intro to embeddings\" \\\n  --out output\u002Fjupyter-notebook\u002Fintro-to-embeddings.ipynb\n```\n\n3. Preencha o notebook com pequenos passos executáveis.\nMantenha cada célula de código focada num único passo.\nAdicione pequenas células markdown que expliquem o propósito e o resultado esperado.\nEvite saídas grandes e ruidosas quando um resumo curto for suficiente.\n\n4. Aplique o padrão adequado.\nPara experimentos, siga `references\u002Fexperiment-patterns.md`.\nPara tutoriais, siga `references\u002Ftutorial-patterns.md`.\n\n5. Edite com segurança ao trabalhar com notebooks existentes.\nPreserve a estrutura do notebook; evite reordenar células a menos que isso melhore a narrativa de cima para baixo.\nPrefira edições direcionadas em vez de reescritas completas.\nSe tiver de editar o JSON bruto, reveja `references\u002Fnotebook-structure.md` primeiro.\n\n6. Valide o resultado.\nExecute o notebook de cima para baixo quando o ambiente permitir.\nSe a execução não for possível, declare-o explicitamente e indique como validar localmente.\nUse a checklist de passagem final em `references\u002Fquality-checklist.md`.\n\n## Modelos e script auxiliar\n- Os modelos estão em `assets\u002Fexperiment-template.ipynb` e `assets\u002Ftutorial-template.ipynb`.\n- O script auxiliar carrega um modelo, atualiza a célula de título e escreve um notebook.\n\nScript path:\n- `$JUPYTER_NOTEBOOK_CLI` (instalado por omissão: `$CODEX_HOME\u002Fskills\u002Fjupyter-notebook\u002Fscripts\u002Fnew_notebook.py`)\n\n## Convenções para ficheiros temporários e de saída\n- Use `tmp\u002Fjupyter-notebook\u002F` para ficheiros intermédios; elimine quando terminar.\n- Escreva artefactos finais em `output\u002Fjupyter-notebook\u002F` quando trabalhar neste repo.\n- Use nomes de ficheiro estáveis e descritivos (por exemplo, `ablation-temperature.ipynb`).\n\n## Dependências (instalar só quando necessário)\nPrefira `uv` para gestão de dependências.\n\nOptional Python packages for local notebook execution:\n\n```bash\nuv pip install jupyterlab ipykernel\n```\n\nO script de scaffolding incluído usa apenas a biblioteca padrão do Python e não requer dependências extra.\n\n## Ambiente\nNão há variáveis de ambiente obrigatórias.\n\n## Mapa de referência\n- `references\u002Fexperiment-patterns.md`: estrutura de experimentos e heurísticas.\n- `references\u002Ftutorial-patterns.md`: estrutura de tutoriais e fluxo de ensino.\n- `references\u002Fnotebook-structure.md`: forma do JSON do notebook e regras de edição segura.\n- `references\u002Fquality-checklist.md`: checklist de validação final.\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**Aviso legal**:\nEste documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). Embora nos esforcemos por garantir a exatidão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se uma tradução profissional realizada por um tradutor humano. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes da utilização desta tradução.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->",{"name":5,"description":7},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook",26019,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners","https:\u002F\u002Faka.ms\u002Fai-agents-beginners","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-07 12:51:12",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill jupyter-notebook",{"tool":41,"command":42},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill jupyter-notebook",{"tool":44,"command":45},"pnpm","pnpm dlx skills add microsoft\u002Fai-agents-for-beginners --skill jupyter-notebook","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",true,[49,55,59,65,69,73],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"assets\u002Fexperiment-template.ipynb","ASSET","资产文件",3100,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Fassets\u002Fexperiment-template.ipynb",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"assets\u002Ftutorial-template.ipynb",3068,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Fassets\u002Ftutorial-template.ipynb",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fexperiment-patterns.md","REFERENCE","参考文档",1513,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Freferences\u002Fexperiment-patterns.md",{"path":66,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fnotebook-structure.md",1558,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Freferences\u002Fnotebook-structure.md",{"path":70,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Fquality-checklist.md",1374,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Freferences\u002Fquality-checklist.md",{"path":74,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Ftutorial-patterns.md",1470,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fpt-PT\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002Freferences\u002Ftutorial-patterns.md",[78,96,107,115,121,128],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":93,"publishedAt":20},"01M69A206TRZ8KK0CW0HYJF5V5","testing-course-samples","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[83,88],{"categoryNo":84,"categoryName":85,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[94,95],"testing","testing course samples",{"skillNo":97,"name":98,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":104,"publishedAt":20},"01M69A1XRB2SFHYRMEH0K08EKZ","microsoft-docs","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[101],{"categoryNo":102,"categoryName":103,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000023","Skill与智能体开发",[105,9,106],"docs","microsoft docs",{"skillNo":108,"name":109,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":20},"01M69A1VPZFJQ1HNGTZQ5P3WSC","local-ai-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Flocal-ai-agents\u002FSKILL.md",[],[113,114],"ai agents","local ai agents",{"skillNo":116,"name":5,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":20},"01M69A1S947N7MM6V9JF85S2E7","當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[19],{"skillNo":122,"name":123,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":20},"01M69A1Q8EXPWKZSQK69V6WF22","deploying-scalable-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[127],"deploying scalable agents",{"skillNo":129,"name":130,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":133,"publishedAt":20},"01M69A1MHZTH3RH9N8VYSYG74X","azure-openai-to-responses","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fazure-openai-to-responses\u002FSKILL.md",[],[134],"azure openai to responses"]