Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

input_file agus attachment_search san API Freagraí

Ceacht 4 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Dhá bhealach chun an bloc céanna a bhaint amach
  2. An bealach file_id
  3. An bealach file_url
  4. Cad a dhéanann attachment_search
  5. Ilchomhad a chomhcheangal
  6. Roghnú idir an dá cheann
  7. Príomhphointí

Dhá bhealach chun an bloc céanna a bhaint amach

Glacann API Freagraí Grok le doiciméad ar dhá bhealach: trí file_id, rud a chiallaíonn comhad a d’uaslódáil tú cheana, nó trí file_url, seoladh poiblí a fhaigheann xAI ag am na hiarrata. Úsáideann an bloc an t-ainm céanna i ngach cás, input_file, agus tá an phróiseáil ina dhiaidh sin identic: gníomhachtaíonn Grok an uirlis attachment_search agus baineann sé na pasáistí amach a fhreagraíonn do cheist. Is é an difríocht ná timthriall an doiciméid, a rúndacht, agus costas gach glaonna arís.

An bealach file_id

Nuair a sheolann tú an comhad trí POST /v1/files, tagraíonn tú dó trína aitheantóir, in éineacht le do cheist i ngnáth-théacs:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_abc123"
    },
    {
      "type": "input_text",
      "text": "What are the main risks mentioned in this report?"
    }
  ]
}

Tá ciall leis an mbealach seo i dtrí chás. Is é an chéad cheis ná ceisteanna arís agus arís eile: má iarrann do fhoireann dlí cúig cheist déana as a chéile faoin gconradh céanna, sáraíonn uaslódáil amháin agus cúig thagairt déag cúig aistriú den PDF céanna. Is é an dara ceis ná rúndacht, nuair nach mór an doiciméad a choinneáil slán ó URL atá inrochtana ag duine ar bith a bhfuil an nasc aige. Is é an tríú ceis ná d’ailtireacht feidhmchláir: má uaslódáiltear comhaid roimh ré le linn ionghabhála oíche, ní láimhsíonn do chuid iarratas ach aitheantóirí.

An bealach file_url

Nuair atá an doiciméad foilsithe cheana féin áit éigin, is céim riachtanach é an t-uaslódáil agus is féidir leat díriú go díreach ar an seoladh:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_url": "https://exemple.com/specifications-api.pdf"
    },
    {
      "type": "input_text",
      "text": "Summarize the endpoints described in this documentation."
    }
  ]
}

I measc na gcásanna úsáide tipiciúla tá doiciméadú oscailte nach bhfuil aon chúis agat a stóráil, comhad óstáilte ar do bhonneagar féin taobh thiar de URL sealadach, nó tástáil thapa ar mhaith leat hipitéis a fhíorú gan píblíne uaslódála iomlán a chur ar bun.

Tagann trí theorainn leis an áisiúlacht seo, agus costóidh siad go léir duit sa táirgeadh. Caithfidh an URL a bheith fíor-phoiblí, gan aon fíordheimhniú: filleann seoladh atá cosanta ag comhartha nó cookie leathanach earráide chuig xAI, agus déanfaidh an tsamhail anailís dhícheallach air sin in ionad do dhoiciméid. Cuireann an íoslódáil le ham próiseála na hiarrata, rud a fhágann go bhfuil PDFanna móra i bhfad níos moille ná le file_id. Ar deireadh, níl aon taisce ar thaobh xAI: íoslódálann gach glao an comhad arís, mar sin trasnaíonn doiciméad amháin a bhfuil ceist faoi chaoga uair sa lá an líonra caoga uair.

Chomh luath agus a fheictear input_file in d’iarratas, spreagann Grok attachment_search gan aon chumraíocht uait. Tarlaíonn an phróiseáil i gceithre chéim:

  1. Eastóscadh ábhair ón gcomhad: téacs, táblaí, struchtúr
  2. Innéacsú sealadach den ábhar seo, ar feadh thréimhse na hiarrata
  3. Cuardach ar phasáistí ábhartha bunaithe ar do cheist
  4. Instealladh blúirí isteach i gcomhthéacs na samhla

Dírigh ar an aidiacht “sealadach” sa dara céim, toisc go míníonn sé difríocht costais a fhionnann go leor daoine ró-dhéanach: athdhéantar an t-innéacs ar gach glao agus imíonn sé ina dhiaidh sin. Is é seo go díreach an fhadhb a réitíonn bailiúcháin le hinneacsú buan. Tabhair faoi deara freisin go luaíonn an tsamhail na pasáistí a d’úsáid sí go díreach ina freagra, rud a ligeann duit a cuid oibre a fhíorú seachas glacadh lena focal.

Ilchomhad a chomhcheangal

Níl aon rud a chuireann iallach ort fanacht le comhad amháin in aghaidh na hiarrata. Trí bhlocanna input_file iolracha a charnadh, iarrann tú ar an tsamhail réasúnú a dhéanamh ar an tacar:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_rapport_q1"
    },
    {
      "type": "input_file",
      "file_id": "file_rapport_q2"
    },
    {
      "type": "input_text",
      "text": "Compare the Q1 and Q2 results."
    }
  ]
}

Déanann Grok anailís ar an dá dhoiciméad agus tras-thagraíonn sé faisnéis chun freagra a thabhairt, rud a osclaíonn an doras do chomparáidí ráthúla, athbhreithnithe ar leaganacha conarthaí leantacha, nó aighneachtaí idir sonraíocht agus a cur chun feidhme.

Roghnú idir an dá cheann

Critéarfile_idfile_url
Uaslódáil roimh réTáNíl
Comhad rúndaMoltaMí-mholta
Ceisteanna arís agus arís eileFeidhmíoch (1 uaslódáil)Mall (ath-íoslódáil)
Comhad poiblíIndéantaIdeálach
Bainistiú timthriallaIs tusa a rialaíonnBraitheann ar an óstach

Príomhphointí

  • Tagraíonn input_file le file_id do chomhad uaslódáilte, agus file_url do dhoiciméad poiblí
  • Gníomhachtaíonn an uirlis attachment_search go huathoibríoch chun ábhar ábhartha a eastóscadh
  • Is féidir leat ilchomhad a chomhcheangal in iarratas amháin
  • Bain úsáid as file_id do chomhaid rúnda nó a gcuirtear ceisteanna orthu go minic
  • Bain úsáid as file_url do dhoiciméid phoiblí nó do thástálacha tapa