import{S as Wt,i as Xt,s as Yt,e as s,k as u,w as f,t as n,M as Zt,c as t,d as o,m as c,a as r,x as v,h as m,b as d,G as a,g as l,y as h,L as er,q as b,o as E,B as q,v as or}from"../../chunks/vendor-hf-doc-builder.js";import{I as $}from"../../chunks/IconCopyLink-hf-doc-builder.js";import{C as ar}from"../../chunks/CodeBlock-hf-doc-builder.js";import{C as sr}from"../../chunks/CourseFloatingBanner-hf-doc-builder.js";function tr(Cs){let A,Eo,y,I,Ce,Y,ha,De,ba,qo,Z,_o,Ee,Ea,$o,qe,qa,wo,H,_a,Ie,$a,wa,go,O,ga,ee,Aa,ya,Ao,_e,Pa,yo,p,He,ka,xa,Oe,za,Ma,Le,ja,Na,Re,Sa,Ca,Ue,Da,Ia,Fe,Ha,Po,$e,Oa,ko,P,L,Ve,oe,La,Be,Ra,xo,we,Ua,zo,k,R,Ge,ae,Fa,Te,Va,Mo,ge,Ba,jo,x,U,Qe,se,Ga,Je,Ta,No,F,Qa,Ke,Ja,Ka,So,z,V,We,te,Wa,Xe,Xa,Co,Ae,Ya,Do,M,B,Ye,re,Za,Ze,es,Io,ye,os,Ho,j,G,eo,ie,as,oo,ss,Oo,Pe,ts,Lo,N,T,ao,le,rs,so,is,Ro,ke,ls,Uo,S,Q,to,de,ds,ro,ns,Fo,xe,ms,Vo,w,io,ne,lo,us,cs,no,me,mo,ps,fs,uo,ue,co,vs,Bo,J,hs,ce,bs,Es,Go,C,K,po,pe,qs,fo,_s,To,ze,$s,Qo,D,W,vo,fe,ws,ho,gs,Jo,Me,As,Ko,g,ys,bo,Ps,ks,ve,xs,zs,Wo,he,Xo,je,Ms,Yo,X,js,be,Ns,Ss,Zo;return Y=new $({}),Z=new sr({props:{chapter:4,classNames:"absolute z-10 right-0 top-0"}}),oe=new $({}),ae=new $({}),se=new $({}),te=new $({}),re=new $({}),ie=new $({}),le=new $({}),de=new $({}),pe=new $({}),fe=new $({}),he=new ar({props:{code:`---
language: fr
license: mit
datasets:
- oscar
---
`,highlighted:`<span class="hljs-meta">---</span>
<span class="hljs-attr">language:</span> <span class="hljs-string">fr</span>
<span class="hljs-attr">license:</span> <span class="hljs-string">mit</span>
<span class="hljs-attr">datasets:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">oscar</span>
<span class="hljs-meta">---
</span>`}}),{c(){A=s("meta"),Eo=u(),y=s("h1"),I=s("a"),Ce=s("span"),f(Y.$$.fragment),ha=u(),De=s("span"),ba=n("Construindo um cart\xE3o para o modelo"),qo=u(),f(Z.$$.fragment),_o=u(),Ee=s("p"),Ea=n("O cart\xE3o para o modelo (model card) \xE9 um arquivo que \xE9 discutivelmente t\xE3o importante quanto os arquivos modelo e tokenizer em um reposit\xF3rio modelo. \xC9 a defini\xE7\xE3o central do modelo, garantindo a reutiliza\xE7\xE3o pelos membros da comunidade e a reprodutibilidade dos resultados, e fornecendo uma plataforma sobre a qual outros membros podem construir seus artefatos."),$o=u(),qe=s("p"),qa=n("Documentar o processo de treinamento e avalia\xE7\xE3o ajuda outros a entender o que esperar de um modelo - e fornecer informa\xE7\xF5es suficientes sobre os dados que foram utilizados e o pr\xE9 e p\xF3s-processamento que foram feitos garante que as limita\xE7\xF5es, enviesamentos e contextos nos quais o modelo \xE9 e n\xE3o \xE9 \xFAtil possam ser identificados e compreendidos."),wo=u(),H=s("p"),_a=n("Portanto, criar um model card que defina claramente seu modelo \xE9 um passo muito importante. Aqui, fornecemos algumas dicas que o ajudar\xE3o com isto. A cria\xE7\xE3o do model card \xE9 feita atrav\xE9s do arquivo "),Ie=s("em"),$a=n("README.md"),wa=n(" que voc\xEA viu anteriormente, que \xE9 um arquivo Markdown."),go=u(),O=s("p"),ga=n("O conceito de \u201Cmodel card\u201D tem origem em uma dire\xE7\xE3o de pesquisa do Google, primeiro compartilhada no artigo "),ee=s("a"),Aa=n("\u201CModel Cards for Model Reporting\u201D"),ya=n(" de Margaret Mitchell et al. Muitas das informa\xE7\xF5es contidas aqui s\xE3o baseadas nesse artigo, e recomendamos que voc\xEA d\xEA uma olhada nele para entender por que os cart\xF5es modelo s\xE3o t\xE3o importantes em um mundo que valoriza a reprodutibilidade, a reusabilidade e a justi\xE7a."),Ao=u(),_e=s("p"),Pa=n("O model card geralmente come\xE7a com uma vis\xE3o geral muito breve e de alto n\xEDvel do que o modelo serve, seguida por detalhes adicionais nas se\xE7\xF5es seguintes:"),yo=u(),p=s("ul"),He=s("li"),ka=n("Descri\xE7\xE3o do modelo"),xa=u(),Oe=s("li"),za=n("Usos e limita\xE7\xF5es"),Ma=u(),Le=s("li"),ja=n("Como usar"),Na=u(),Re=s("li"),Sa=n("Dados de treinamento"),Ca=u(),Ue=s("li"),Da=n("Procedimento de treinamento"),Ia=u(),Fe=s("li"),Ha=n("Resultados da avalia\xE7\xE3o"),Po=u(),$e=s("p"),Oa=n("Vamos dar uma olhada no que cada uma dessas se\xE7\xF5es deve conter."),ko=u(),P=s("h3"),L=s("a"),Ve=s("span"),f(oe.$$.fragment),La=u(),Be=s("span"),Ra=n("Descri\xE7\xE3o do modelo"),xo=u(),we=s("p"),Ua=n("A descri\xE7\xE3o do modelo fornece detalhes b\xE1sicos sobre o modelo. Isto inclui a arquitetura, vers\xE3o, se foi introduzida em um artigo, se uma implementa\xE7\xE3o original est\xE1 dispon\xEDvel, o autor, e informa\xE7\xF5es gerais sobre o modelo. Qualquer direito autoral deve ser atribu\xEDdo aqui. Informa\xE7\xF5es gerais sobre procedimentos de treinamento, par\xE2metros e ren\xFAncias importantes tamb\xE9m podem ser mencionadas nesta se\xE7\xE3o."),zo=u(),k=s("h3"),R=s("a"),Ge=s("span"),f(ae.$$.fragment),Fa=u(),Te=s("span"),Va=n("Usos e limita\xE7\xF5es"),Mo=u(),ge=s("p"),Ba=n("Aqui voc\xEA descreve os casos de uso a que o modelo se destina, incluindo os idiomas, campos e dom\xEDnios onde ele pode ser aplicado. Esta se\xE7\xE3o do cart\xE3o modelo tamb\xE9m pode documentar \xE1reas que s\xE3o conhecidas por estarem fora do escopo do modelo, ou onde \xE9 prov\xE1vel que ele tenha um desempenho sub\xF3timo."),jo=u(),x=s("h3"),U=s("a"),Qe=s("span"),f(se.$$.fragment),Ga=u(),Je=s("span"),Ta=n("Como usar"),No=u(),F=s("p"),Qa=n("Esta se\xE7\xE3o deve incluir alguns exemplos de como utilizar o modelo. Isto pode mostrar a utiliza\xE7\xE3o da fun\xE7\xE3o "),Ke=s("code"),Ja=n("pipeline()"),Ka=n(", utiliza\xE7\xE3o do modelo e classes de tokenizer, e qualquer outro c\xF3digo que voc\xEA acha que possa ser \xFAtil."),So=u(),z=s("h3"),V=s("a"),We=s("span"),f(te.$$.fragment),Wa=u(),Xe=s("span"),Xa=n("Dados de treinamento"),Co=u(),Ae=s("p"),Ya=n("Esta parte deve indicar em que conjunto(s) de dados o modelo foi treinado. Uma breve descri\xE7\xE3o do(s) conjunto(s) de dados tamb\xE9m \xE9 bem-vinda."),Do=u(),M=s("h3"),B=s("a"),Ye=s("span"),f(re.$$.fragment),Za=u(),Ze=s("span"),es=n("Procedimento de treinamento"),Io=u(),ye=s("p"),os=n("Nesta se\xE7\xE3o voc\xEA deve descrever todos os aspectos relevantes do treinamento que s\xE3o \xFAteis a partir de uma perspectiva de reprodutibilidade. Isto inclui qualquer pr\xE9-processamento e p\xF3s-processamento que foram feitos nos dados, assim como detalhes como o n\xFAmero de \xE9pocas para as quais o modelo foi treinado, o tamanho do lote, a taxa de aprendizado, etc."),Ho=u(),j=s("h3"),G=s("a"),eo=s("span"),f(ie.$$.fragment),as=u(),oo=s("span"),ss=n("Vari\xE1veis e m\xE9tricas"),Oo=u(),Pe=s("p"),ts=n("Aqui voc\xEA deve descrever as m\xE9tricas que voc\xEA usa para avalia\xE7\xE3o e os diferentes fatores que voc\xEA est\xE1 mensurando. A men\xE7\xE3o de qual(is) m\xE9trica(s) foi utilizada(s), em qual conjunto de dados e qual divis\xE3o de conjunto de dados facilita a compara\xE7\xE3o do desempenho do seu modelo em compara\xE7\xE3o com o de outros modelos. Estes devem ser informados pelas se\xE7\xF5es anteriores, tais como os usu\xE1rios pretendidos e os casos de uso."),Lo=u(),N=s("h3"),T=s("a"),ao=s("span"),f(le.$$.fragment),rs=u(),so=s("span"),is=n("Resultados da avalia\xE7\xE3o"),Ro=u(),ke=s("p"),ls=n("Finalmente, fornecer uma indica\xE7\xE3o de qu\xE3o bem o modelo funciona no conjunto de dados de avalia\xE7\xE3o. Se o modelo utiliza um limiar de decis\xE3o, ou fornecer o limiar de decis\xE3o utilizado na avalia\xE7\xE3o, ou fornecer detalhes sobre a avalia\xE7\xE3o em diferentes limiares para os usos pretendidos."),Uo=u(),S=s("h2"),Q=s("a"),to=s("span"),f(de.$$.fragment),ds=u(),ro=s("span"),ns=n("Exemplo"),Fo=u(),xe=s("p"),ms=n("Confira a seguir alguns exemplos de model card bem elaborados:"),Vo=u(),w=s("ul"),io=s("li"),ne=s("a"),lo=s("code"),us=n("bert-base-cased"),cs=u(),no=s("li"),me=s("a"),mo=s("code"),ps=n("gpt2"),fs=u(),uo=s("li"),ue=s("a"),co=s("code"),vs=n("distilbert"),Bo=u(),J=s("p"),hs=n("Mais exemplos de diferentes organiza\xE7\xF5es e empresas est\xE3o dispon\xEDveis "),ce=s("a"),bs=n("aqui"),Es=n("."),Go=u(),C=s("h2"),K=s("a"),po=s("span"),f(pe.$$.fragment),qs=u(),fo=s("span"),_s=n("Nota"),To=u(),ze=s("p"),$s=n("Model cards are not a requirement when publishing models, and you don\u2019t need to include all of the sections described above when you make one. However, explicit documentation of the model can only benefit future users, so we recommend that you fill in as many of the sections as possible to the best of your knowledge and ability."),Qo=u(),D=s("h2"),W=s("a"),vo=s("span"),f(fe.$$.fragment),ws=u(),ho=s("span"),gs=n("Model card metadata"),Jo=u(),Me=s("p"),As=n("Os model card n\xE3o s\xE3o uma exig\xEAncia quando se publica modelos, e n\xE3o \xE9 necess\xE1rio incluir todas as se\xE7\xF5es descritas acima quando se faz um. Entretanto, a documenta\xE7\xE3o expl\xEDcita do modelo s\xF3 pode beneficiar futuros usu\xE1rios, por isso recomendamos que voc\xEA preencha o maior n\xFAmero poss\xEDvel de se\xE7\xF5es com o melhor de seu conhecimento e capacidade."),Ko=u(),g=s("p"),ys=n("Por exemplo, se voc\xEA der uma olhada no model card ["),bo=s("code"),Ps=n("camembert-base"),ks=n("("),ve=s("a"),xs=n("https://huggingface.co/camembert-base/blob/main/README.md"),zs=n("), voc\xEA deve ver as seguintes linhas no cabe\xE7alho do model card:"),Wo=u(),f(he.$$.fragment),Xo=u(),je=s("p"),Ms=n("Estes metadados s\xE3o analisados pelo Hugging Face Hub, que ent\xE3o identifica este modelo como sendo um modelo franc\xEAs, com uma licen\xE7a MIT, treinado no conjunto de dados Oscar."),Yo=u(),X=s("p"),js=n("A "),be=s("a"),Ns=n("especifica\xE7\xE3o completa do model card"),Ss=n(" permite especificar idiomas, licen\xE7as, tags, conjuntos de dados, m\xE9tricas, assim como os resultados da avalia\xE7\xE3o do modelo obtido no treinamento."),this.h()},l(e){const i=Zt('[data-svelte="svelte-1phssyn"]',document.head);A=t(i,"META",{name:!0,content:!0}),i.forEach(o),Eo=c(e),y=t(e,"H1",{class:!0});var ea=r(y);I=t(ea,"A",{id:!0,class:!0,href:!0});var Ds=r(I);Ce=t(Ds,"SPAN",{});var Is=r(Ce);v(Y.$$.fragment,Is),Is.forEach(o),Ds.forEach(o),ha=c(ea),De=t(ea,"SPAN",{});var Hs=r(De);ba=m(Hs,"Construindo um cart\xE3o para o modelo"),Hs.forEach(o),ea.forEach(o),qo=c(e),v(Z.$$.fragment,e),_o=c(e),Ee=t(e,"P",{});var Os=r(Ee);Ea=m(Os,"O cart\xE3o para o modelo (model card) \xE9 um arquivo que \xE9 discutivelmente t\xE3o importante quanto os arquivos modelo e tokenizer em um reposit\xF3rio modelo. \xC9 a defini\xE7\xE3o central do modelo, garantindo a reutiliza\xE7\xE3o pelos membros da comunidade e a reprodutibilidade dos resultados, e fornecendo uma plataforma sobre a qual outros membros podem construir seus artefatos."),Os.forEach(o),$o=c(e),qe=t(e,"P",{});var Ls=r(qe);qa=m(Ls,"Documentar o processo de treinamento e avalia\xE7\xE3o ajuda outros a entender o que esperar de um modelo - e fornecer informa\xE7\xF5es suficientes sobre os dados que foram utilizados e o pr\xE9 e p\xF3s-processamento que foram feitos garante que as limita\xE7\xF5es, enviesamentos e contextos nos quais o modelo \xE9 e n\xE3o \xE9 \xFAtil possam ser identificados e compreendidos."),Ls.forEach(o),wo=c(e),H=t(e,"P",{});var oa=r(H);_a=m(oa,"Portanto, criar um model card que defina claramente seu modelo \xE9 um passo muito importante. Aqui, fornecemos algumas dicas que o ajudar\xE3o com isto. A cria\xE7\xE3o do model card \xE9 feita atrav\xE9s do arquivo "),Ie=t(oa,"EM",{});var Rs=r(Ie);$a=m(Rs,"README.md"),Rs.forEach(o),wa=m(oa," que voc\xEA viu anteriormente, que \xE9 um arquivo Markdown."),oa.forEach(o),go=c(e),O=t(e,"P",{});var aa=r(O);ga=m(aa,"O conceito de \u201Cmodel card\u201D tem origem em uma dire\xE7\xE3o de pesquisa do Google, primeiro compartilhada no artigo "),ee=t(aa,"A",{href:!0,rel:!0});var Us=r(ee);Aa=m(Us,"\u201CModel Cards for Model Reporting\u201D"),Us.forEach(o),ya=m(aa," de Margaret Mitchell et al. Muitas das informa\xE7\xF5es contidas aqui s\xE3o baseadas nesse artigo, e recomendamos que voc\xEA d\xEA uma olhada nele para entender por que os cart\xF5es modelo s\xE3o t\xE3o importantes em um mundo que valoriza a reprodutibilidade, a reusabilidade e a justi\xE7a."),aa.forEach(o),Ao=c(e),_e=t(e,"P",{});var Fs=r(_e);Pa=m(Fs,"O model card geralmente come\xE7a com uma vis\xE3o geral muito breve e de alto n\xEDvel do que o modelo serve, seguida por detalhes adicionais nas se\xE7\xF5es seguintes:"),Fs.forEach(o),yo=c(e),p=t(e,"UL",{});var _=r(p);He=t(_,"LI",{});var Vs=r(He);ka=m(Vs,"Descri\xE7\xE3o do modelo"),Vs.forEach(o),xa=c(_),Oe=t(_,"LI",{});var Bs=r(Oe);za=m(Bs,"Usos e limita\xE7\xF5es"),Bs.forEach(o),Ma=c(_),Le=t(_,"LI",{});var Gs=r(Le);ja=m(Gs,"Como usar"),Gs.forEach(o),Na=c(_),Re=t(_,"LI",{});var Ts=r(Re);Sa=m(Ts,"Dados de treinamento"),Ts.forEach(o),Ca=c(_),Ue=t(_,"LI",{});var Qs=r(Ue);Da=m(Qs,"Procedimento de treinamento"),Qs.forEach(o),Ia=c(_),Fe=t(_,"LI",{});var Js=r(Fe);Ha=m(Js,"Resultados da avalia\xE7\xE3o"),Js.forEach(o),_.forEach(o),Po=c(e),$e=t(e,"P",{});var Ks=r($e);Oa=m(Ks,"Vamos dar uma olhada no que cada uma dessas se\xE7\xF5es deve conter."),Ks.forEach(o),ko=c(e),P=t(e,"H3",{class:!0});var sa=r(P);L=t(sa,"A",{id:!0,class:!0,href:!0});var Ws=r(L);Ve=t(Ws,"SPAN",{});var Xs=r(Ve);v(oe.$$.fragment,Xs),Xs.forEach(o),Ws.forEach(o),La=c(sa),Be=t(sa,"SPAN",{});var Ys=r(Be);Ra=m(Ys,"Descri\xE7\xE3o do modelo"),Ys.forEach(o),sa.forEach(o),xo=c(e),we=t(e,"P",{});var Zs=r(we);Ua=m(Zs,"A descri\xE7\xE3o do modelo fornece detalhes b\xE1sicos sobre o modelo. Isto inclui a arquitetura, vers\xE3o, se foi introduzida em um artigo, se uma implementa\xE7\xE3o original est\xE1 dispon\xEDvel, o autor, e informa\xE7\xF5es gerais sobre o modelo. Qualquer direito autoral deve ser atribu\xEDdo aqui. Informa\xE7\xF5es gerais sobre procedimentos de treinamento, par\xE2metros e ren\xFAncias importantes tamb\xE9m podem ser mencionadas nesta se\xE7\xE3o."),Zs.forEach(o),zo=c(e),k=t(e,"H3",{class:!0});var ta=r(k);R=t(ta,"A",{id:!0,class:!0,href:!0});var et=r(R);Ge=t(et,"SPAN",{});var ot=r(Ge);v(ae.$$.fragment,ot),ot.forEach(o),et.forEach(o),Fa=c(ta),Te=t(ta,"SPAN",{});var at=r(Te);Va=m(at,"Usos e limita\xE7\xF5es"),at.forEach(o),ta.forEach(o),Mo=c(e),ge=t(e,"P",{});var st=r(ge);Ba=m(st,"Aqui voc\xEA descreve os casos de uso a que o modelo se destina, incluindo os idiomas, campos e dom\xEDnios onde ele pode ser aplicado. Esta se\xE7\xE3o do cart\xE3o modelo tamb\xE9m pode documentar \xE1reas que s\xE3o conhecidas por estarem fora do escopo do modelo, ou onde \xE9 prov\xE1vel que ele tenha um desempenho sub\xF3timo."),st.forEach(o),jo=c(e),x=t(e,"H3",{class:!0});var ra=r(x);U=t(ra,"A",{id:!0,class:!0,href:!0});var tt=r(U);Qe=t(tt,"SPAN",{});var rt=r(Qe);v(se.$$.fragment,rt),rt.forEach(o),tt.forEach(o),Ga=c(ra),Je=t(ra,"SPAN",{});var it=r(Je);Ta=m(it,"Como usar"),it.forEach(o),ra.forEach(o),No=c(e),F=t(e,"P",{});var ia=r(F);Qa=m(ia,"Esta se\xE7\xE3o deve incluir alguns exemplos de como utilizar o modelo. Isto pode mostrar a utiliza\xE7\xE3o da fun\xE7\xE3o "),Ke=t(ia,"CODE",{});var lt=r(Ke);Ja=m(lt,"pipeline()"),lt.forEach(o),Ka=m(ia,", utiliza\xE7\xE3o do modelo e classes de tokenizer, e qualquer outro c\xF3digo que voc\xEA acha que possa ser \xFAtil."),ia.forEach(o),So=c(e),z=t(e,"H3",{class:!0});var la=r(z);V=t(la,"A",{id:!0,class:!0,href:!0});var dt=r(V);We=t(dt,"SPAN",{});var nt=r(We);v(te.$$.fragment,nt),nt.forEach(o),dt.forEach(o),Wa=c(la),Xe=t(la,"SPAN",{});var mt=r(Xe);Xa=m(mt,"Dados de treinamento"),mt.forEach(o),la.forEach(o),Co=c(e),Ae=t(e,"P",{});var ut=r(Ae);Ya=m(ut,"Esta parte deve indicar em que conjunto(s) de dados o modelo foi treinado. Uma breve descri\xE7\xE3o do(s) conjunto(s) de dados tamb\xE9m \xE9 bem-vinda."),ut.forEach(o),Do=c(e),M=t(e,"H3",{class:!0});var da=r(M);B=t(da,"A",{id:!0,class:!0,href:!0});var ct=r(B);Ye=t(ct,"SPAN",{});var pt=r(Ye);v(re.$$.fragment,pt),pt.forEach(o),ct.forEach(o),Za=c(da),Ze=t(da,"SPAN",{});var ft=r(Ze);es=m(ft,"Procedimento de treinamento"),ft.forEach(o),da.forEach(o),Io=c(e),ye=t(e,"P",{});var vt=r(ye);os=m(vt,"Nesta se\xE7\xE3o voc\xEA deve descrever todos os aspectos relevantes do treinamento que s\xE3o \xFAteis a partir de uma perspectiva de reprodutibilidade. Isto inclui qualquer pr\xE9-processamento e p\xF3s-processamento que foram feitos nos dados, assim como detalhes como o n\xFAmero de \xE9pocas para as quais o modelo foi treinado, o tamanho do lote, a taxa de aprendizado, etc."),vt.forEach(o),Ho=c(e),j=t(e,"H3",{class:!0});var na=r(j);G=t(na,"A",{id:!0,class:!0,href:!0});var ht=r(G);eo=t(ht,"SPAN",{});var bt=r(eo);v(ie.$$.fragment,bt),bt.forEach(o),ht.forEach(o),as=c(na),oo=t(na,"SPAN",{});var Et=r(oo);ss=m(Et,"Vari\xE1veis e m\xE9tricas"),Et.forEach(o),na.forEach(o),Oo=c(e),Pe=t(e,"P",{});var qt=r(Pe);ts=m(qt,"Aqui voc\xEA deve descrever as m\xE9tricas que voc\xEA usa para avalia\xE7\xE3o e os diferentes fatores que voc\xEA est\xE1 mensurando. A men\xE7\xE3o de qual(is) m\xE9trica(s) foi utilizada(s), em qual conjunto de dados e qual divis\xE3o de conjunto de dados facilita a compara\xE7\xE3o do desempenho do seu modelo em compara\xE7\xE3o com o de outros modelos. Estes devem ser informados pelas se\xE7\xF5es anteriores, tais como os usu\xE1rios pretendidos e os casos de uso."),qt.forEach(o),Lo=c(e),N=t(e,"H3",{class:!0});var ma=r(N);T=t(ma,"A",{id:!0,class:!0,href:!0});var _t=r(T);ao=t(_t,"SPAN",{});var $t=r(ao);v(le.$$.fragment,$t),$t.forEach(o),_t.forEach(o),rs=c(ma),so=t(ma,"SPAN",{});var wt=r(so);is=m(wt,"Resultados da avalia\xE7\xE3o"),wt.forEach(o),ma.forEach(o),Ro=c(e),ke=t(e,"P",{});var gt=r(ke);ls=m(gt,"Finalmente, fornecer uma indica\xE7\xE3o de qu\xE3o bem o modelo funciona no conjunto de dados de avalia\xE7\xE3o. Se o modelo utiliza um limiar de decis\xE3o, ou fornecer o limiar de decis\xE3o utilizado na avalia\xE7\xE3o, ou fornecer detalhes sobre a avalia\xE7\xE3o em diferentes limiares para os usos pretendidos."),gt.forEach(o),Uo=c(e),S=t(e,"H2",{class:!0});var ua=r(S);Q=t(ua,"A",{id:!0,class:!0,href:!0});var At=r(Q);to=t(At,"SPAN",{});var yt=r(to);v(de.$$.fragment,yt),yt.forEach(o),At.forEach(o),ds=c(ua),ro=t(ua,"SPAN",{});var Pt=r(ro);ns=m(Pt,"Exemplo"),Pt.forEach(o),ua.forEach(o),Fo=c(e),xe=t(e,"P",{});var kt=r(xe);ms=m(kt,"Confira a seguir alguns exemplos de model card bem elaborados:"),kt.forEach(o),Vo=c(e),w=t(e,"UL",{});var Ne=r(w);io=t(Ne,"LI",{});var xt=r(io);ne=t(xt,"A",{href:!0,rel:!0});var zt=r(ne);lo=t(zt,"CODE",{});var Mt=r(lo);us=m(Mt,"bert-base-cased"),Mt.forEach(o),zt.forEach(o),xt.forEach(o),cs=c(Ne),no=t(Ne,"LI",{});var jt=r(no);me=t(jt,"A",{href:!0,rel:!0});var Nt=r(me);mo=t(Nt,"CODE",{});var St=r(mo);ps=m(St,"gpt2"),St.forEach(o),Nt.forEach(o),jt.forEach(o),fs=c(Ne),uo=t(Ne,"LI",{});var Ct=r(uo);ue=t(Ct,"A",{href:!0,rel:!0});var Dt=r(ue);co=t(Dt,"CODE",{});var It=r(co);vs=m(It,"distilbert"),It.forEach(o),Dt.forEach(o),Ct.forEach(o),Ne.forEach(o),Bo=c(e),J=t(e,"P",{});var ca=r(J);hs=m(ca,"Mais exemplos de diferentes organiza\xE7\xF5es e empresas est\xE3o dispon\xEDveis "),ce=t(ca,"A",{href:!0,rel:!0});var Ht=r(ce);bs=m(Ht,"aqui"),Ht.forEach(o),Es=m(ca,"."),ca.forEach(o),Go=c(e),C=t(e,"H2",{class:!0});var pa=r(C);K=t(pa,"A",{id:!0,class:!0,href:!0});var Ot=r(K);po=t(Ot,"SPAN",{});var Lt=r(po);v(pe.$$.fragment,Lt),Lt.forEach(o),Ot.forEach(o),qs=c(pa),fo=t(pa,"SPAN",{});var Rt=r(fo);_s=m(Rt,"Nota"),Rt.forEach(o),pa.forEach(o),To=c(e),ze=t(e,"P",{});var Ut=r(ze);$s=m(Ut,"Model cards are not a requirement when publishing models, and you don\u2019t need to include all of the sections described above when you make one. However, explicit documentation of the model can only benefit future users, so we recommend that you fill in as many of the sections as possible to the best of your knowledge and ability."),Ut.forEach(o),Qo=c(e),D=t(e,"H2",{class:!0});var fa=r(D);W=t(fa,"A",{id:!0,class:!0,href:!0});var Ft=r(W);vo=t(Ft,"SPAN",{});var Vt=r(vo);v(fe.$$.fragment,Vt),Vt.forEach(o),Ft.forEach(o),ws=c(fa),ho=t(fa,"SPAN",{});var Bt=r(ho);gs=m(Bt,"Model card metadata"),Bt.forEach(o),fa.forEach(o),Jo=c(e),Me=t(e,"P",{});var Gt=r(Me);As=m(Gt,"Os model card n\xE3o s\xE3o uma exig\xEAncia quando se publica modelos, e n\xE3o \xE9 necess\xE1rio incluir todas as se\xE7\xF5es descritas acima quando se faz um. Entretanto, a documenta\xE7\xE3o expl\xEDcita do modelo s\xF3 pode beneficiar futuros usu\xE1rios, por isso recomendamos que voc\xEA preencha o maior n\xFAmero poss\xEDvel de se\xE7\xF5es com o melhor de seu conhecimento e capacidade."),Gt.forEach(o),Ko=c(e),g=t(e,"P",{});var Se=r(g);ys=m(Se,"Por exemplo, se voc\xEA der uma olhada no model card ["),bo=t(Se,"CODE",{});var Tt=r(bo);Ps=m(Tt,"camembert-base"),Tt.forEach(o),ks=m(Se,"("),ve=t(Se,"A",{href:!0,rel:!0});var Qt=r(ve);xs=m(Qt,"https://huggingface.co/camembert-base/blob/main/README.md"),Qt.forEach(o),zs=m(Se,"), voc\xEA deve ver as seguintes linhas no cabe\xE7alho do model card:"),Se.forEach(o),Wo=c(e),v(he.$$.fragment,e),Xo=c(e),je=t(e,"P",{});var Jt=r(je);Ms=m(Jt,"Estes metadados s\xE3o analisados pelo Hugging Face Hub, que ent\xE3o identifica este modelo como sendo um modelo franc\xEAs, com uma licen\xE7a MIT, treinado no conjunto de dados Oscar."),Jt.forEach(o),Yo=c(e),X=t(e,"P",{});var va=r(X);js=m(va,"A "),be=t(va,"A",{href:!0,rel:!0});var Kt=r(be);Ns=m(Kt,"especifica\xE7\xE3o completa do model card"),Kt.forEach(o),Ss=m(va," permite especificar idiomas, licen\xE7as, tags, conjuntos de dados, m\xE9tricas, assim como os resultados da avalia\xE7\xE3o do modelo obtido no treinamento."),va.forEach(o),this.h()},h(){d(A,"name","hf:doc:metadata"),d(A,"content",JSON.stringify(rr)),d(I,"id","construindo-um-carto-para-o-modelo"),d(I,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(I,"href","#construindo-um-carto-para-o-modelo"),d(y,"class","relative group"),d(ee,"href","https://arxiv.org/abs/1810.03993"),d(ee,"rel","nofollow"),d(L,"id","descrio-do-modelo"),d(L,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(L,"href","#descrio-do-modelo"),d(P,"class","relative group"),d(R,"id","usos-e-limitaes"),d(R,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(R,"href","#usos-e-limitaes"),d(k,"class","relative group"),d(U,"id","como-usar"),d(U,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(U,"href","#como-usar"),d(x,"class","relative group"),d(V,"id","dados-de-treinamento"),d(V,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(V,"href","#dados-de-treinamento"),d(z,"class","relative group"),d(B,"id","procedimento-de-treinamento"),d(B,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(B,"href","#procedimento-de-treinamento"),d(M,"class","relative group"),d(G,"id","variveis-e-mtricas"),d(G,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(G,"href","#variveis-e-mtricas"),d(j,"class","relative group"),d(T,"id","resultados-da-avaliao"),d(T,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(T,"href","#resultados-da-avaliao"),d(N,"class","relative group"),d(Q,"id","exemplo"),d(Q,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(Q,"href","#exemplo"),d(S,"class","relative group"),d(ne,"href","https://huggingface.co/bert-base-cased"),d(ne,"rel","nofollow"),d(me,"href","https://huggingface.co/gpt2"),d(me,"rel","nofollow"),d(ue,"href","https://huggingface.co/distilbert-base-uncased"),d(ue,"rel","nofollow"),d(ce,"href","https://github.com/huggingface/model_card/blob/master/examples.md"),d(ce,"rel","nofollow"),d(K,"id","nota"),d(K,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(K,"href","#nota"),d(C,"class","relative group"),d(W,"id","model-card-metadata"),d(W,"class","header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full"),d(W,"href","#model-card-metadata"),d(D,"class","relative group"),d(ve,"href","https://huggingface.co/camembert-base/blob/main/README.md"),d(ve,"rel","nofollow"),d(be,"href","https://github.com/huggingface/hub-docs/blame/main/modelcard.md"),d(be,"rel","nofollow")},m(e,i){a(document.head,A),l(e,Eo,i),l(e,y,i),a(y,I),a(I,Ce),h(Y,Ce,null),a(y,ha),a(y,De),a(De,ba),l(e,qo,i),h(Z,e,i),l(e,_o,i),l(e,Ee,i),a(Ee,Ea),l(e,$o,i),l(e,qe,i),a(qe,qa),l(e,wo,i),l(e,H,i),a(H,_a),a(H,Ie),a(Ie,$a),a(H,wa),l(e,go,i),l(e,O,i),a(O,ga),a(O,ee),a(ee,Aa),a(O,ya),l(e,Ao,i),l(e,_e,i),a(_e,Pa),l(e,yo,i),l(e,p,i),a(p,He),a(He,ka),a(p,xa),a(p,Oe),a(Oe,za),a(p,Ma),a(p,Le),a(Le,ja),a(p,Na),a(p,Re),a(Re,Sa),a(p,Ca),a(p,Ue),a(Ue,Da),a(p,Ia),a(p,Fe),a(Fe,Ha),l(e,Po,i),l(e,$e,i),a($e,Oa),l(e,ko,i),l(e,P,i),a(P,L),a(L,Ve),h(oe,Ve,null),a(P,La),a(P,Be),a(Be,Ra),l(e,xo,i),l(e,we,i),a(we,Ua),l(e,zo,i),l(e,k,i),a(k,R),a(R,Ge),h(ae,Ge,null),a(k,Fa),a(k,Te),a(Te,Va),l(e,Mo,i),l(e,ge,i),a(ge,Ba),l(e,jo,i),l(e,x,i),a(x,U),a(U,Qe),h(se,Qe,null),a(x,Ga),a(x,Je),a(Je,Ta),l(e,No,i),l(e,F,i),a(F,Qa),a(F,Ke),a(Ke,Ja),a(F,Ka),l(e,So,i),l(e,z,i),a(z,V),a(V,We),h(te,We,null),a(z,Wa),a(z,Xe),a(Xe,Xa),l(e,Co,i),l(e,Ae,i),a(Ae,Ya),l(e,Do,i),l(e,M,i),a(M,B),a(B,Ye),h(re,Ye,null),a(M,Za),a(M,Ze),a(Ze,es),l(e,Io,i),l(e,ye,i),a(ye,os),l(e,Ho,i),l(e,j,i),a(j,G),a(G,eo),h(ie,eo,null),a(j,as),a(j,oo),a(oo,ss),l(e,Oo,i),l(e,Pe,i),a(Pe,ts),l(e,Lo,i),l(e,N,i),a(N,T),a(T,ao),h(le,ao,null),a(N,rs),a(N,so),a(so,is),l(e,Ro,i),l(e,ke,i),a(ke,ls),l(e,Uo,i),l(e,S,i),a(S,Q),a(Q,to),h(de,to,null),a(S,ds),a(S,ro),a(ro,ns),l(e,Fo,i),l(e,xe,i),a(xe,ms),l(e,Vo,i),l(e,w,i),a(w,io),a(io,ne),a(ne,lo),a(lo,us),a(w,cs),a(w,no),a(no,me),a(me,mo),a(mo,ps),a(w,fs),a(w,uo),a(uo,ue),a(ue,co),a(co,vs),l(e,Bo,i),l(e,J,i),a(J,hs),a(J,ce),a(ce,bs),a(J,Es),l(e,Go,i),l(e,C,i),a(C,K),a(K,po),h(pe,po,null),a(C,qs),a(C,fo),a(fo,_s),l(e,To,i),l(e,ze,i),a(ze,$s),l(e,Qo,i),l(e,D,i),a(D,W),a(W,vo),h(fe,vo,null),a(D,ws),a(D,ho),a(ho,gs),l(e,Jo,i),l(e,Me,i),a(Me,As),l(e,Ko,i),l(e,g,i),a(g,ys),a(g,bo),a(bo,Ps),a(g,ks),a(g,ve),a(ve,xs),a(g,zs),l(e,Wo,i),h(he,e,i),l(e,Xo,i),l(e,je,i),a(je,Ms),l(e,Yo,i),l(e,X,i),a(X,js),a(X,be),a(be,Ns),a(X,Ss),Zo=!0},p:er,i(e){Zo||(b(Y.$$.fragment,e),b(Z.$$.fragment,e),b(oe.$$.fragment,e),b(ae.$$.fragment,e),b(se.$$.fragment,e),b(te.$$.fragment,e),b(re.$$.fragment,e),b(ie.$$.fragment,e),b(le.$$.fragment,e),b(de.$$.fragment,e),b(pe.$$.fragment,e),b(fe.$$.fragment,e),b(he.$$.fragment,e),Zo=!0)},o(e){E(Y.$$.fragment,e),E(Z.$$.fragment,e),E(oe.$$.fragment,e),E(ae.$$.fragment,e),E(se.$$.fragment,e),E(te.$$.fragment,e),E(re.$$.fragment,e),E(ie.$$.fragment,e),E(le.$$.fragment,e),E(de.$$.fragment,e),E(pe.$$.fragment,e),E(fe.$$.fragment,e),E(he.$$.fragment,e),Zo=!1},d(e){o(A),e&&o(Eo),e&&o(y),q(Y),e&&o(qo),q(Z,e),e&&o(_o),e&&o(Ee),e&&o($o),e&&o(qe),e&&o(wo),e&&o(H),e&&o(go),e&&o(O),e&&o(Ao),e&&o(_e),e&&o(yo),e&&o(p),e&&o(Po),e&&o($e),e&&o(ko),e&&o(P),q(oe),e&&o(xo),e&&o(we),e&&o(zo),e&&o(k),q(ae),e&&o(Mo),e&&o(ge),e&&o(jo),e&&o(x),q(se),e&&o(No),e&&o(F),e&&o(So),e&&o(z),q(te),e&&o(Co),e&&o(Ae),e&&o(Do),e&&o(M),q(re),e&&o(Io),e&&o(ye),e&&o(Ho),e&&o(j),q(ie),e&&o(Oo),e&&o(Pe),e&&o(Lo),e&&o(N),q(le),e&&o(Ro),e&&o(ke),e&&o(Uo),e&&o(S),q(de),e&&o(Fo),e&&o(xe),e&&o(Vo),e&&o(w),e&&o(Bo),e&&o(J),e&&o(Go),e&&o(C),q(pe),e&&o(To),e&&o(ze),e&&o(Qo),e&&o(D),q(fe),e&&o(Jo),e&&o(Me),e&&o(Ko),e&&o(g),e&&o(Wo),q(he,e),e&&o(Xo),e&&o(je),e&&o(Yo),e&&o(X)}}}const rr={local:"construindo-um-carto-para-o-modelo",sections:[{local:null,sections:[{local:"descrio-do-modelo",title:"Descri\xE7\xE3o do modelo"},{local:"usos-e-limitaes",title:"Usos e limita\xE7\xF5es"},{local:"como-usar",title:"Como usar"},{local:"dados-de-treinamento",title:"Dados de treinamento "},{local:"procedimento-de-treinamento",title:"Procedimento de treinamento"},{local:"variveis-e-mtricas",title:"Vari\xE1veis e m\xE9tricas"},{local:"resultados-da-avaliao",title:"Resultados da avalia\xE7\xE3o "}],title:null},{local:"exemplo",title:"Exemplo"},{local:"nota",title:"Nota"},{local:"model-card-metadata",title:"Model card metadata"}],title:"Construindo um cart\xE3o para o modelo"};function ir(Cs){return or(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class ur extends Wt{constructor(A){super();Xt(this,A,ir,tr,Yt,{})}}export{ur as default,rr as metadata};
