Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tfittxija ibrida: tgħaqqad il-web u l-fajls

Lezzjoni 9 / 20 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Tfittxija ibrida: tgħaqqad il-web u l-fajls
  2. Ippermetti ż-żewġ għodod
  3. Każ ta’ użu: monitoraġġ regolatorju
  4. Każ ta’ użu: arrikkiment tal-bażi tal-għarfien
  5. Żid funzjonijiet personalizzati mat-taħlita
  6. Immaniġġja l-prijorità tas-sorsi
  7. Mudell sħiħ: assistent tat-tfittxija ibrida
  8. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi tad-dokumentazzjoni ta’ OpenAI: l-għodda Code Interpreter issa teħtieġ parametru container (miżjud mal-eżempji kollha), il-partijiet tat-test tal-input huma tat-tip input_text, u t-tfittxija fuq il-web tuża l-għodda web_search (web_search_preview issa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijiet fichiers_generes u telecharger mil-Lezzjoni 10. Sorsi: Code Interpreter · Web search.

Tfittxija ibrida: tgħaqqad il-web u l-fajls

Iż-żewġ għodod tat-tfittxija jwieġbu mistoqsijiet differenti, u meta jintużaw waħedhom, kull wieħed jibqa’ mhux komplut. It-Tfittxija tal-Fajls (File Search) taf x’iktebt inti; it-Tfittxija fuq il-Web (Web Search) taf x’ippubblika d-dinja. Ħafna mistoqsijiet utli jinsabu eżattament fl-intersezzjoni taż-żewġ naħat: Il-proċedura tagħna għadha konformi? Id-dokumentazzjoni tagħna hija aġġornata? Fejn qegħdin meta mqabbla mas-suq?

Dawn il-mistoqsijiet jaqsmu proprjetà komuni li tispjega l-valur tagħhom: ħadd ma jista’ jwieġibhom mingħajr ma jaqra ż-żewġ naħat. Huwa dan it-tħallit, mhux it-tfittxija nnifisha, li jagħmel din il-lezzjoni ta’ valur.

Ippermetti ż-żewġ għodod

Iddikjara ż-żewġ għodod fl-istess ħin fl-array tools:

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Compare our remote work policy with current market trends",
    tools=[
        {
            "type": "file_search",
            "vector_store_ids": ["vs_abc123"],
            "max_num_results": 10
        },
        {
            "type": "web_search",
            "search_context_size": "medium"
        }
    ]
)

print(response.output_text)

Il-mudell jiddeċiedi waħdu meta juża kull għodda. Għal mistoqsija dwar id-dokumenti interni tiegħek, se juża t-Tfittxija tal-Fajls. Għal data pubblika, se juża t-Tfittxija fuq il-Web. Għal tqabbil, se juża t-tnejn.

Każ ta’ użu: monitoraġġ regolatorju

Il-monitoraġġ regolatorju huwa l-eżempju klassiku għax il-vojt bejn iż-żewġ sorsi huwa preċiżament dak li qed infittxu. Itlob b’mod espliċitu d-differenzi, mhux sommarju ta’ kull naħa: mudell mitlub jagħmel sommarju se jipproduċi żewġ sinteżi korretti u jħallik tagħmel int it-tqabbil, li huwa l-unika parti diffiċli tax-xogħol.

def audit_conformite(sujet: str, vs_processus: str) -> dict:
    """Compares internal processes with current regulations."""
    response = client.responses.create(
        model="gpt-5.6-terra",
        instructions=(
            "You are a compliance auditor. For each point, you must: "
            "1. Search internal documents for what is currently in place "
            "2. Search the web for current applicable regulations "
            "3. Identify gaps between the two "
            "4. Propose corrective actions"
        ),
        input=f"Audit the compliance of our processes on the topic: {sujet}",
        tools=[
            {
                "type": "file_search",
                "vector_store_ids": [vs_processus],
                "max_num_results": 15
            },
            {
                "type": "web_search",
                "search_context_size": "high"
            }
        ]
    )

    return {
        "rapport": response.output_text,
        "tokens_utilises": response.usage.total_tokens
    }

# Usage
rapport = audit_conformite(
    "personal data protection and GDPR",
    "vs_processus_internes"
)

Każ ta’ użu: arrikkiment tal-bażi tal-għarfien

L-istess mekkaniżmu, maqlub, iservi biex tiċċekkja l-età tad-dokumenti tiegħek stess: minflok tivverifika l-konformità, tistaqsi x’inbidel minn meta nkiteb. Dan huwa l-użu l-aktar effiċjenti f’termini ta’ spiża tat-tfittxija ibrida fuq bażi ta’ dokumenti antiki—ħadd m’għandu ħin biex jerġa’ jaqra mitt paġna biex isib it-tlieta li qdemu.

def detecter_obsolescence(vs_id: str, sujets: list[str]) -> list[dict]:
    """Identifies potentially obsolete information."""
    resultats = []

    for sujet in sujets:
        response = client.responses.create(
            model="gpt-5.6-terra",
            instructions=(
                "Compare what our internal documents say with the most recent "
                "information from the web. Identify factual gaps, outdated figures, "
                "and obsolete procedures."
            ),
            input=f"Check the currency of our documents on: {sujet}",
            tools=[
                {"type": "file_search", "vector_store_ids": [vs_id]},
                {"type": "web_search"}
            ]
        )

        resultats.append({
            "sujet": sujet,
            "analyse": response.output_text
        })

    return resultats

Żid funzjonijiet personalizzati mat-taħlita

Li żżid il-funzjonijiet tiegħek mat-taħlita tbiddel il-fluss tax-xogħol mill-analiżi għall-azzjoni: il-mudell isib vojt, imbagħad jiftaħ tikketta. Madankollu, żomm fruntiera ċara—it-tfittxija u l-analiżi jistgħu jibqgħu awtomatiċi, iżda l-azzjonijiet li jimpenjaw riżorsi (ħolqien, tibgħit, modifika) jistħoqqilhom validazzjoni umana sakemm tkejjel l-affidabbiltà tal-fluss fuq perjodu ta’ diversi ġimgħat.

tools = [
    # Search your documents
    {
        "type": "file_search",
        "vector_store_ids": ["vs_contrats"],
        "max_num_results": 10
    },
    # Web search
    {
        "type": "web_search",
        "search_context_size": "medium"
    },
    # Business function: query the CRM
    {
        "type": "function",
        "name": "get_client_info",
        "description": "Retrieve client information from the CRM",
        "parameters": {
            "type": "object",
            "properties": {
                "client_id": {"type": "string"},
                "champs": {
                    "type": "array",
                    "items": {"type": "string"},
                    "description": "List of fields to return"
                }
            },
            "required": ["client_id"],
            "additionalProperties": False
        },
        "strict": True
    },
    # Business function: create an alert
    {
        "type": "function",
        "name": "creer_alerte",
        "description": "Create a follow-up alert for a contract or client",
        "parameters": {
            "type": "object",
            "properties": {
                "titre": {"type": "string"},
                "priorite": {"type": "string", "enum": ["basse", "moyenne", "haute", "critique"]},
                "description": {"type": "string"},
                "assignee": {"type": "string"}
            },
            "required": ["titre", "priorite", "description", "assignee"],
            "additionalProperties": False
        },
        "strict": True
    }
]

# The model can now:
# 1. Search for a contract in File Search
# 2. Verify a clause on the web
# 3. Retrieve client info from the CRM
# 4. Create an alert if a problem is detected
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Check if client CLI-42567's contract complies with the new European "
          "standards. If not, create a high-priority alert.",
    tools=tools
)

Immaniġġja l-prijorità tas-sorsi

Mingħajr istruzzjonijiet, il-mudell jittratta ż-żewġ sorsi bl-istess mod. Dan rari huwa dak li trid: għal fatti interni—figuri, proċeduri, deċiżjonijiet—id-dokumenti tiegħek huma awtoritattivi u l-web hija sempliċiment storbju plawżibbli; għal aħbarijiet u regolamenti, l-oppost huwa minnu. Ikteb din il-ġerarkija fil-prompt tas-sistema, u itlob li kwalunkwe kunflitt bejn iż-żewġ sorsi jiġi ssinjalat minflok ma jiġi arbitrat b’mod silenzjuż.

response = client.responses.create(
    model="gpt-5.6-terra",
    instructions=(
        "Source priority rules: "
        "1. For internal facts (processes, policies, contracts) -> File Search "
        "2. For external facts (laws, market, trends) -> Web Search "
        "3. In case of conflict between internal and external sources, flag the gap "
        "4. NEVER answer based solely on your own knowledge "
    ),
    input="What is our standard payment term and is it compliant with the law?",
    tools=[
        {"type": "file_search", "vector_store_ids": [vs_id]},
        {"type": "web_search"}
    ]
)

Mudell sħiħ: assistent tat-tfittxija ibrida

class AssistantRecherche:
    def __init__(self, vector_store_ids: list[str]):
        self.client = OpenAI()
        self.vs_ids = vector_store_ids
        self.historique = []

    def rechercher(self, question: str, mode: str = "hybride") -> dict:
        tools = []

        if mode in ("hybride", "interne"):
            tools.append({
                "type": "file_search",
                "vector_store_ids": self.vs_ids,
                "max_num_results": 10
            })

        if mode in ("hybride", "web"):
            tools.append({
                "type": "web_search",
                "search_context_size": "medium"
            })

        response = self.client.responses.create(
            model="gpt-5.6-terra",
            instructions="Always cite your sources. Clearly distinguish "
                        "internal information from public information.",
            input=question,
            tools=tools
        )

        resultat = {
            "question": question,
            "reponse": response.output_text,
            "mode": mode,
            "tokens": response.usage.total_tokens
        }
        self.historique.append(resultat)
        return resultat

# Usage
assistant = AssistantRecherche(["vs_contrats", "vs_procedures"])
r = assistant.rechercher("Are our GTCs up to date with European law?")
print(r["reponse"])

Punti Ewlenin

  • Għaqqad file_search u web_search f’sejħa waħda
  • Il-mudell jagħżel awtomatikament l-għodda t-tajba għal kull ħtieġa
  • Il-prompt tas-sistema jiggwida l-prijorità bejn is-sorsi interni u dawk esterni
  • Żid funzjonijiet personalizzati għal flussi tax-xogħol sħaħ
  • It-tfittxija ibrida hija ideali għal awditi ta’ konformità u monitoraġġ