...
Eroare Aplicații AI cu LLM · Tool use și function calling

TypeError: string indices must be integers, not 'str'

Pe scurt

La OpenAI, `item.arguments` dintr-un `function_call` este text JSON, nu dicționar, deci `item.arguments["oras"]` dă eroarea. Parsează-l întâi: `args = json.loads(item.arguments)`, apoi `args["oras"]`.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine din Python: ai folosit paranteze drepte cu un text ("oras") pe o valoare care e șir de caractere. Pe un șir, [...] acceptă doar poziții numerice (s[0]), nu chei.

În function calling cu OpenAI (Responses API și Chat Completions), modelul întoarce argumentele funcției ca text JSON: item.arguments == '{"oras": "Constanța"}'. E o diferență importantă față de Claude, unde bloc.input e deja dicționar. Cine trece de la un SDK la altul sau scrie din memorie accesează direct item.arguments["oras"] și primește această eroare.

În versiunile mai vechi de Python, mesajul este TypeError: string indices must be integers. Aceeași cauză apare oriunde ai un JSON încă neparsat: un răspuns text al modelului, un câmp citit din fișier sau dintr-o bază de date.

De ce apare: cauzele frecvente

1Argumentele OpenAI folosite fără json.loads

Greșit
PYTHON
for item in r.output:
    if item.type == "function_call":
        oras = item.arguments["oras"]
Corect
PYTHON
for item in r.output:
    if item.type == "function_call":
        args = json.loads(item.arguments)
        oras = args["oras"]

arguments e text JSON; după json.loads devine dicționar și accepți cheile.

2Chat Completions, aceeași capcană

Greșit
PYTHON
call = r.choices[0].message.tool_calls[0]
oras = call.function.arguments["oras"]
Corect
PYTHON
call = r.choices[0].message.tool_calls[0]
oras = json.loads(call.function.arguments)["oras"]

Și la Chat Completions argumentele vin ca text JSON, în function.arguments.

3Răspuns text JSON folosit ca dicționar

Greșit
PYTHON
date = r.output_text
print(date["categorie"])
Corect
PYTHON
date = json.loads(r.output_text)
print(date["categorie"])

Orice JSON primit ca text trebuie parsat înainte să-i citești cheile.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos folosește function calling cu OpenAI și dă TypeError: string indices must be integers, not 'str' la citirea argumentelor. Repară citirea: parsează apel.arguments cu json.loads înainte să iei orașul. Programul afișează Oraș cerut: ... și răspunsul final.

Codul care dă eroarea
PYTHON
import json

from openai import OpenAI

MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
    "type": "function",
    "name": "vremea",
    "description": "Vremea de azi într-un oraș din România.",
    "parameters": {
        "type": "object",
        "properties": {"oras": {"type": "string"}},
        "required": ["oras"],
        "additionalProperties": False,
    },
    "strict": True,
}]


def vremea(oras):
    return "18 grade, senin"


intrari = [{"role": "user", "content": "Cum e vremea azi la Constanța?"}]
r = client.responses.create(model=MODEL, tools=TOOLS, input=intrari)
intrari += r.output
for apel in r.output:
    if apel.type == "function_call":
        oras = apel.arguments["oras"]
        print("Oraș cerut:", oras)
        intrari.append({"type": "function_call_output", "call_id": apel.call_id, "output": vremea(oras)})
r = client.responses.create(model=MODEL, tools=TOOLS, input=intrari)
print(r.output_text)
După reparație, programul afișează
Oraș cerut: Constanța
Azi în Constanța: 18 grade, senin.
Indiciu

apel.arguments e un text JSON; json.loads îl face dicționar.

Alte forme ale mesajului

  • TypeError: string indices must be integers

Cum o eviți pe viitor

  • Reține diferența: OpenAI arguments = text JSON; Claude input = dicționar.
  • Parsează argumentele într-un singur loc, în dispecerul de tool-uri, cu try/except json.JSONDecodeError.
  • Validează argumentele parsate (chei obligatorii, tipuri) înainte să apelezi funcția.
  • La depanare, afișează type(apel.arguments): dacă vezi str, mai ai un pas de parsare înainte să citești cheile.

Întrebări frecvente

De ce OpenAI trimite argumentele ca text?

Așa e definit formatul API-ului: modelul generează textul JSON al argumentelor, iar SDK-ul ți-l dă neschimbat. Parsarea rămâne în grija ta.

Poate fi JSON-ul argumentelor invalid?

Cu "strict": True în definiția tool-ului, argumentele respectă schema. Fără strict, rar, pot apărea argumente incomplete, deci prinde json.JSONDecodeError și trimite modelului un rezultat de eroare.

Erori înrudite

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție

Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.