Vanliga frågor och svar om Foundry Agent Service

Basic setup lagrar agenttillstånd i Microsoft hanterade resurser.

Standardkonfiguration lagrar agentdata (trådar, filer och vektorlager) i dina Azure resurser som du deklarerar via kapacitetsinställningar.

Information om hur du jämför konfigurationsalternativ och väljer rätt finns i Konfigurera din miljö och Konfigurera agentens kapacitetsinställningar.

Rollkraven beror på vad du gör. Vanliga roller är:

• Foundry-kontoägare: Skapa konton och projekt
• Foundry-användare: Skapa och redigera agenter
• Role Based Access Control Administrator (eller Owner): Krävs för standardkonfiguration för att tilldela roller till anslutna resurser

För standardkonfiguration behöver du även behörigheten Microsoft.Authorization/roleAssignments/write.

Fullständiga rollkrav finns i Required permissions and Role-based access control (RBAC) i Microsoft Foundry.

Börja med Konfigurera din miljö och skapa sedan din första agent.

• Snabbstart: Skapa en ny agent
• Ny Foundry-upplevelse: Snabbstart: Kom igång med agenter i kod

Röstbaserade agenter är en typ av prompt-agent för muntliga samtal i realtid. Använd dem när användarna pratar med agenten och hör talade svar i stället för att i första hand skriva och läsa text.

Voice-first-agenter använder samma grundläggande agenttjänstbegrepp som andra promptagenter, inklusive projekt, sparade agentversioner, verktyg, identitet, spårning och övervakning. De kan också ha krav på tillgänglighet för röstspecifika modeller, ljud, kanaler och förhandsvisningar.

Mer information finns i Så här fungerar röstbaserade agenter.

Ja. Foundry Agent Service är ett tillståndskänsligt API, vilket innebär att den behåller data. Två typer av data lagras i Foundry Agent Service-API:et:

• Tillståndsbevarande entiteter: Konversationer och svar som skapats under användningen.
• Filer och vektorlager: Data som laddats upp under konfigurationen av Foundry Agent Service eller som en del av en svarsgenerering.

Information om hur konversationer och svar fungerar finns i Komponenter för agentkörning.

• Basic setup: Data lagras i ett säkert, Microsoft hanterat lagringskonto som är logiskt avgränsat.
• Standard: Data lagras i dina egna Azure resurser, så du har fullständig ägarskap och kontroll:
  • Azure Storage: Filer och bifogade filer
  • Azure Cosmos DB: Trådar och konversationshistorik
  • Azure AI-sökning: Vektorlager

Mer information om konfigurationsalternativ som styr var data lagras finns i Konfigurera din miljö.

Data bevaras om du inte uttryckligen tar bort dem. Om du vill ta bort agentdata använder du API:et eller SDK:n för att ta bort trådar, filer eller vektorlager.

Begrepp och terminologi (till exempel konversation och svar) finns i Agent-körningskomponenter.

• Grundläggande konfiguration stöder endast Microsoft-hanterade nycklar.
• Standardkonfigurationen stöder kundhanterade nycklar (CMK:er).

Information om täckning för foundry-funktioner finns i Kundhanterad nyckelkryptering i Microsoft Foundry.

Nej, Microsoft använder inte dina data för träningsmodeller. Mer information finns i dokumentationen om ansvarsfull AI.

Foundry Agent-tjänstslutpunkter är regionala och data lagras i samma region som slutpunkten. Mer information finns i Azure-dokumentationen om dataresidens.

• Du debiteras för slutsatsdragningskostnad (indata och utdata) för basmodellen som du använder för varje agent (till exempel gpt-4-0125). Om du har skapat flera agenter debiteras du för basmodellen som är kopplad till varje agent.

• Om du har aktiverat verktyget Kodtolkar debiteras du för dess användning per session. Om din agent till exempel anropar kodtolkaren samtidigt i två trådar skapar den här aktiviteten två kodtolkarsessioner. Var och en av dessa sessioner debiteras.

  Som standard är varje session aktiv i en timme. Om användaren fortsätter att ge instruktioner till kodtolkaren i samma tråd i upp till en timme betalar du bara den här avgiften en gång.

• Filsökning faktureras baserat på den vektorlagring som du använder.

Mer information finns på prissidan.

Avgifter och gränser beror på de modeller, verktyg, lagring och körningsfunktioner som din agent använder. Granska prissättningssidan Microsoft Foundry och agenttjänstens gränser, kvoter och regional support.

Copilot-selen är en valfri hanterad körmiljö för promptagenter. Din resurs är fortfarande en promptagent och använder Responses API. Foundry hanterar harness- och körningsmiljön, så att du inte behöver driftsätta eller underhålla harness-koden.

Information om verktyg, färdigheter, begränsningar och konfigurationsvägledning som stöds finns i Använd Copilot-harnessen med promptagenter.

Använd agentens endpoint, inte projektets Responses endpoint. Ett Foundry-projekt innehåller agenter och andra resurser. Projektändpunkten identifierar projektet; Agentändpunkten identifierar en specifik sparad agent i det.

Använd för invokering

För en resurs med namnet my-resource, för ett projekt med namnet my-project och för en agent med namnet my-agent använder du det URL-format som klienten kräver:

OpenAI-klienten lägger till åtgärdssökvägar som /responses till bas-URL:en. Ersätt exempelnamnen med dina egna värden.

SDK-konfiguration

Initiera Foundry SDK med projektets slutpunkt, till exempel https://my-resource.services.ai.azure.com/api/projects/my-project, och välj sedan en agentbegränsad klient efter agentnamn. Ett exempel:

• Python: Använd project.get_openai_client(agent_name=FOUNDRY_AGENT_NAME).
• .NET: Använd GetProjectResponsesClientForAgentEndpoint(...). Att skicka en agentreferens till GetProjectResponsesClientForAgent(...) ensam väljer inte agentslutpunkten.

Om du får HTTP 400 med följande meddelande ändrar du anropsklienten eller URL:en så att agentslutpunkten används:

Managed harness agents can only be called through
the agent endpoint route:
/agents/<agentName>/endpoint/protocols/openai/responses.

Fullständiga SDK-exempel, inklusive den nödvändiga konversationen, finns i Anropa och verifiera agenten.

Foundry kör harnessen och körningsmiljön. Data kan lämna Foundry när du konfigurerar ett externt verktyg, en anslutning eller en slutpunkt enligt tjänstens villkor och datahanteringsmetoder.

Byom (Bring Your Own Model) stöds för närvarande inte med Copilot harness.

Nej. Under den inledande offentliga förhandsversionen väljer du Copilot-selen när du skapar en ny promptagent. Du kan inte växla en befintlig agent eller ändra harness genom att skapa en annan version.

Konversationshistoriken är fortfarande tillgänglig när den valda agentversionen ändras.

Med standardbeteendet för prompt-agenten använder nästa svar den valda versionen. Med Copilot-selen använder en ny konversation den valda versionen omedelbart. En körningsmiljö som redan körs startas inte om, så funktioner som initierades när den startade kan fortsätta att använda den tidigare versionen. När miljön är inaktiv ersätter nästa interaktion den med den valda versionen och fortsätter samma konversation. Om den valda versionen inte kan tillämpas misslyckas interaktionen i stället för att tyst använda en annan version.

Starta en ny konversation när du behöver en tydlig versionsgräns. Vägledning för versionsval finns i Konfigurera och dela din agent.

Ja. En promptagent som använder Copilot-harness kan hänvisa till en versionshanterad färdighet i samma Foundry-projekt eller identifiera färdigheter som är kopplade till en kompatibel verktygslåda. Vägledning om konfigurering och versionshantering finns i Använd färdigheter i Foundry. Mer information om kompatibilitet och begränsningar finns i Använd Copilot-harness med promptagenter.

Stöd för region, klient, verktyg, nätverk och kvoter kan vara smalare än agenttjänsten i allmänhet. Se begränsningar för Copilot harness och tillgänglighet.

Börja med Toolbox-översikten och se sedan den verktygsspecifika vägledningen:

Deklarera dessa resurser i kapacitetsinställningarna för ditt Foundry-konto eller projekt.

• Anvisningar: Konfigurera inställningar för agentkapacitet
• Anvisningar: Använd dina egna resurser

Information om användnings- och övervakningsalternativ finns i Mått och Övervaka tjänsten.

BCDR-vägledningen för agenttjänsten beror på din konfiguration och de resurser du etablerar. För aktuell vägledning, se Haveriberedskap för Foundry Agent Service.

Virtuella nätverk hjälper till att skydda inkommande och utgående åtkomst till dina Azure resurser. Du uppnår nätverksisolering genom integrering av virtuella nätverk i Azure.

Information om krav och begränsningar för privata nätverk i Agent Service finns i Så här använder du ett virtuellt nätverk med Foundry Agent Service.

Agenttjänstens nätverk använder Azure Container Apps. När du distribuerar till ditt virtuella nätverk måste du använda ett dedikerat undernät som delegerats till Microsoft.App/environments.

Mer information finns i Använda ett virtuellt nätverk med Foundry Agent Service och Konfiguration av virtuellt nätverk.

Regiontillgängligheten för isolering av virtuella nätverk kan ändras. Aktuella regioner och begränsningar som stöds finns i Så här använder du ett virtuellt nätverk med Foundry Agent Service.

Endast privata IP-intervall stöds:

• Klass A: 10.0.0.0/8
• Klass B: 172.16.0.0/12
• Klass C: 192.168.0.0/16

Offentliga IP-intervall stöds inte för agentundernät.

Den rekommenderade delegerade agentundernätsstorleken är /24. Minimivärdet är /27.

Information om storleksvägledning och hur IP-adresser används finns i Så här använder du ett virtuellt nätverk med Foundry Agent Service och konfiguration av virtuella nätverk.

Så länge agentundernätet och privata slutpunkter har adressutrymme kan adressintervallet för virtuella nätverk vara vad som helst.

Ja. Det virtuella nätverket finns i din prenumeration och du bör kunna peerkoppla med alla virtuella nätverk. Men dataöverföring är kostsamt, så vi rekommenderar det inte. Kravet är att alla resurser måste finnas i samma region som Microsoft Foundry-resursen.

Ja. Tillåt nödvändiga fullständigt kvalificerade domännamn (FQDN) för hanterad identitet enligt beskrivningen i Använd Azure Firewall med Azure Container Apps eller tillåt AzureActiveDirectory tjänsttaggen.

Vägledning för privata nätverk i Agent Service finns i Så här använder du ett virtuellt nätverk med Foundry Agent Service.

Ja, flera Microsoft Foundry-resurser kan återanvända samma virtuella nätverk. Varje Foundry-resurs kräver dock ett eget undernät för dedikerad agentkörning – agentundernätet kan inte delas mellan flera Foundry-resurser.

De behöver inte finnas i samma resursgrupp, men de måste finnas i samma region.

Om du använder en nätverksskyddad konfiguration kräver vissa verktyg ytterligare konfiguration, till exempel privata slutpunkter och resursanslutningar.

De aktuella riktlinjerna och begränsningarna finns i Använda ett virtuellt nätverk med Foundry Agent Service.

Nästa steg

• Vad är Foundry Agent Service?
• Konfigurera din miljö
• Snabbstart: Skapa en ny agent
• Översikt över verktygslådan
• Använda ett virtuellt nätverk med Foundry Agent Service