Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Alleen van toepassing op:klassieke Foundry-portal. Dit artikel is niet beschikbaar voor de nieuwe Foundry-portal.
Meer informatie over de nieuwe portal.
Opmerking
Koppelingen in dit artikel kunnen inhoud openen in de nieuwe Microsoft Foundry-documentatie in plaats van de Foundry-documentatie (klassiek) die u nu bekijkt.
Opmerking
De Assistants API is verouderd en zal op 26 augustus 2026 met pensioen worden genomen. Gebruik de algemeen beschikbare Microsoft Foundry Agents-dienst. Volg de migratiegids om je workloads bij te werken. Meer informatie.
Met code-interpreter kan de Assistants-API Python code schrijven en uitvoeren in een omgeving voor uitvoering in een sandbox. Als code-interpreter is ingeschakeld, kan uw assistent code iteratief uitvoeren om uitdagendere problemen met code, wiskunde en gegevensanalyse op te lossen. Wanneer uw assistent code schrijft die niet kan worden uitgevoerd, kan deze code worden herhaald door verschillende code te wijzigen en uit te voeren totdat de uitvoering van de code is geslaagd.
Belangrijk
Code-interpreter heeft aanvoeglijke kosten buiten de tokenkosten voor Azure OpenAI-gebruik. Als uw assistent code-interpreter tegelijk aanroept in twee verschillende threads, worden er twee code-interpretersessies gemaakt. Elke sessie is standaard gedurende 1 uur actief met een time-out voor inactiviteit van 30 minuten.
Ondersteuning voor code-interpreters
Ondersteunde modellen
De modellenpagina bevat de meest up-to-date informatie over regio's/modellen waar assistenten en de code-interpreter worden ondersteund.
We raden u aan assistenten te gebruiken met de nieuwste modellen om te profiteren van de nieuwe functies, grotere contextvensters en meer actuele trainingsgegevens.
API-versies
- Beginnen met
2024-02-15-preview
Ondersteunde bestandstypen
| Bestandsindeling | MIME-type |
|---|---|
| .c | tekst/x-c |
| .cpp | text/x-c++ |
| .csv | application/csv |
| .docx | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| .html | text/html |
| .java | text/x-java |
| .json | application/json |
| .md | text/markdown |
| application/pdf | |
| .php | text/x-php |
| .pptx | application/vnd.openxmlformats-officedocument.presentationml.presentation |
| .Py | text/x-python |
| .Py | text/x-script.python |
| .rb | text/x-ruby |
| .tex | tekst/x-tex |
| .txt | platte tekst |
| .css | text/css |
| .jpeg | afbeelding/jpeg |
| .jpg | afbeelding/jpeg |
| .js | text/javascript |
| .gif | image/gif |
| .png | image/png |
| .tar | application/x-tar |
| .ts | toepassing/typescript |
| .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| .xml | application/xml of "text/xml" |
| .zip | toepassing/zip |
Api-verwijzing voor het uploaden van bestanden
Assistenten gebruiken dezelfde API voor het uploaden van bestanden als het afstemmen van bestanden. Bij het uploaden van een bestand moet u een geschikte waarde opgeven voor de doelparameter.
Code-interpreter inschakelen
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
assistant = client.beta.assistants.create(
instructions="You are an AI assistant that can write code to help answer math questions",
model="<REPLACE WITH MODEL DEPLOYMENT NAME>", # replace with model deployment name.
tools=[{"type": "code_interpreter"}]
)
Bestand uploaden voor code-interpreter
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
# Upload a file with an "assistants" purpose
file = client.files.create(
file=open("speech.py", "rb"),
purpose='assistants'
)
# Create an assistant using the file ID
assistant = client.beta.assistants.create(
instructions="You are an AI assistant that can write code to help answer math questions.",
model="gpt-4-1106-preview",
tools=[{"type": "code_interpreter"}],
tool_resources={"code_interpreter":{"file_ids":[file.id]}}
)
Bestand doorgeven aan een afzonderlijke thread
Naast het toegankelijk maken van bestanden op assistentniveau, kunt u bestanden doorgeven zodat ze alleen toegankelijk zijn voor een bepaalde thread.
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
thread = client.beta.threads.create(
messages=[
{
"role": "user",
"content": "I need to solve the equation `3x + 11 = 14`. Can you help me?",
"file_ids": ["file.id"] # file id will look like: "assistant-R9uhPxvRKGH3m0x5zBOhMjd2"
}
]
)
Bestanden downloaden die zijn gegenereerd door de code-interpreter
Bestanden die door code-interpreter worden gegenereerd, zijn te vinden in de antwoorden van assistentberichten
{
"id": "msg_oJbUanImBRpRran5HSa4Duy4",
"assistant_id": "asst_eHwhP4Xnad0bZdJrjHO2hfB4",
"content": [
{
"image_file": {
"file_id": "assistant-1YGVTvNzc2JXajI5JU9F0HMD"
},
"type": "image_file"
},
# ...
}
U kunt deze gegenereerde bestanden downloaden door de bestanden door te geven aan de bestands-API:
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
image_data = client.files.content("assistant-abc123")
image_data_bytes = image_data.read()
with open("./my-image.png", "wb") as file:
file.write(image_data_bytes)
Zie ook
- Naslaginformatie over de API voor het uploaden van bestanden
- Assistents API-referentie
- Meer informatie over het gebruik van assistenten met onze handleiding over assistenten.
- Azure Api-voorbeelden van OpenAI-assistenten