Olet tässä:
AI Agent Generative AI Usage -datamalli
Käytä AI Agent Generative AI Usage -datamalliobjektia (DMO) analysoidaksesi Agentforcen ja generoivan tekoälyn kulutuskuvioita Data 360:ssa.
Tietoja AiAgentGenerativeAiUsage-sovelluksesta
Jokainen tietue edustaa yhtä tekoälyn luovaa vuorovaikutustapahtumaa, joka käsitellään tekoälymittaripalvelun kautta. Objekti kaappaa tekoälyn palveluista tehdyt laskutus- ja mittauspäätökset (esimerkiksi LLM Gateway ja Agent Reasoner), mukaan lukien sen, onko vuorovaikutus laskutettava, käytön määrä, valtuuksien määrät sekä jäljitettävyyttä ja auditointia koskevat tunnisteet.
AI Agent Generative AI Usage -kentät
Seuraava taulukko kuvaa AI Agent Generative AI Usage DMO -organisaation kentät (AiAgentGenerativeAiUsage, jonka kehitysnimi on AiAgentGenerativeAiUsageDmo).
| Kentän otsikko | Kentän kehitysnimi | Tietotyyppi | Kuvaus |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Teksti | BotDefinition- tai agenttitietueen tunnus (esimerkiksi 0Xx-tunnus), kun tapahtuma liittyy agenttiin. |
Agent Developer Name |
AgentDeveloperName__c |
Teksti | Agentin kehitysnimi läsnä ollessa. |
Agent Generative AI Usage ID |
Id__c |
Teksti | Käyttötapahtumatietueen yksilöllinen tunnus. |
Agent Type Code |
AgentTypeCode__c |
Teksti | Yleinen agentti tai kokemusten tyyppi (esimerkiksi EinsteinServiceAgent, AgentforceEmployeeAgent tai NOT_SET muille kuin agenttien kehotteille). |
AI Agent Interaction |
AiAgentInteractionId__c |
Teksti | Istunnon yksittäisen vuorovaikutuksen tunnus. |
AI Agent Session |
AiAgentSessionId__c |
Teksti | Istunnon tunnus, joka ryhmittää useita vuorovaikutuksia yhteen keskusteluun. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Teksti | Agentin kutsuman työkalun tunnus, jos sovellettavissa. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Teksti | Perustyökalun täydellinen nimi tai kohdekoodi (esimerkiksi EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Teksti | Kutsuvan työkalun ihmisen luettava tai mallityylinen nimi. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Teksti | Pyynnölle käytetty Salesforce-ominaisuus (esimerkiksi PromptTemplateGenerationsInvocable tai CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Teksti | Mallin tunnus LLM-yhdyskäytävässä (esimerkiksi sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Teksti | Ominaisuuden nimi, joka näytetään generoivan tekoälyn yhdyskäytävässä. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Teksti | Infrastruktuurin vuokralainen organisaatiolle (esimerkiksi core/prod/ plus organisaation 18-merkkinen tunnus). |
Is Billable
|
IsBillableIndicator__c
|
Totuusarvo | Onko tapahtuma tarkoitettu laskutettavaksi tuoteominaisuudelle. |
Is Metered
|
IsMeteredIndicator__c
|
Totuusarvo | Onko tapahtuma mitattu ja veloitettu (lopullinen mittauspäätös). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Teksti | Jos sovellettavissa, syyn käyttöä ei mitattu (esimerkiksi NOT_SKIPPED tai muut tuotekohtaiset koodit). |
Model Class Type |
ModelClassType__c |
Teksti | Mallin käyttöluokka (esimerkiksi STANDARD tai BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Teksti | Tarjoajakohtainen mallin nimen merkkijono. |
Model Provider Name |
ModelProviderName__c |
Teksti | Mallin tarjoaja (esimerkiksi openai, azureopenai tai Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Numero | Palautettujen suoritusvaltuuksien määrä. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Numero | Kehotteen syöttövaltuuksien määrä. |
Prompt Template |
PromptTemplateIdentifier__c |
Teksti | Malliin perustuville generoinneille käytetyn kehotteen rakenteen tunnus. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Teksti | Kehotteen mallin kehitysnimi. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Numero | Kehotteiden valtuuksien kokonaismäärä (syöte plus valmistuminen), kun raportoidaan aggregaatissa. |
Request Identifier |
RequestIdentifier__c |
Teksti | Tietyn yhdyskäytävän tai suorituksen aikaisen pyynnön yksilöllinen tunnus. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Teksti | Lokin päätepisteen korrelaation seurantatunnus (esimerkiksi B3-seuranta- tai heksadesimaali-seuranta-arvo). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Teksti | Tietyn yhdyskäytävän tai suorituksen aikaisen pyynnön yksilöllinen tunnus. |
Tier Qualifier Type |
TierQualifierType__c |
Teksti | Tapahtuman tason hyväksyjä (esimerkiksi STANDARD, BASIC, scale, priority, CUSTOM tai NOT_SET). |
| Aikaleima | Aikaleima__c | DateTime | Aika, jolloin mittaustapahtuma tapahtui. |
Usage Type Code |
UsageTypeCode__c |
Teksti | Digital Wallet -käyttötyyppi (esimerkiksi EmbeddedAI_StandardPrompts, Agentforce_StandardAction tai Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Numero | Tapahtumalle tallennettujen liiketoimintakäytön yksiköiden määrä. |
Unit Type Code |
UnitTypeCode__c |
Teksti | Saapuva yksikkötyyppi mittausta varten (esimerkiksi ACTION tai generoinnit). |
User Context |
UserContext__c |
Teksti | Arviointia varten annettu konteksti (esimerkiksi UT:STANDARD ja ominaisuusmerkinnät). |
User ID |
UserId__c |
Teksti | Tapahtumaan liittyvän käyttäjän Salesforce-käyttäjätunnus (005-etuliite), jos sellainen on saatavilla. |
Datamallin kyseleminen
Voit suorittaa ad hoc -kyselyitä, jotka noutavat asiaankuuluvia tietoja DMO-organisaatiosta. Data 360 tarjoaa useita tapoja datasi kyselemiseen. Lisätietoja on kohdassa Query Data in Data 360.
Alla on joitakin esimerkkikyselyitä, joita voit käyttää.
Laskuttava käyttö agentin mukaan
Käytä tätä kyselyä tunnistaaksesi kalleimmat agentit. Se kerää yhteen kokonaiskäytön ja tapahtumien määrät, ryhmitettynä agentin kehitysnimen ja tyypin mukaan.
SELECT
AgentDeveloperName__c,
AgentTypeCode__c,
SUM(UsageQuantity__c) AS TotalUsage,
COUNT(*) AS EventCount
FROM AiAgentGenerativeAiUsage_std__dlm
WHERE IsBillableIndicator__c = true
AND Timestamp__c >= CURRENT_DATE - 30
GROUP BY AgentDeveloperName__c, AgentTypeCode__c
ORDER BY TotalUsage DESC
Tunnusten kulutus mallin mukaan
Käytä tätä kyselyä tunnistaaksesi mallit, jotka kuluttavat eniten valtuuksia. Se kerää input-, completion-, total-valtuuksien ja tapahtumien määrät mallin tunnuksen, tarjoajan ja luokan mukaan.
SELECT
GenAiGatewayModelName__c,
ModelProviderName__c,
ModelClassType__c,
SUM(PromptInputTokenCount__c) AS TotalInputTokens,
SUM(PromptCompletionTokenCount__c) AS TotalCompletionTokens,
SUM(PromptTotalTokenCount__c) AS TotalTokens,
COUNT(*) AS EventCount
FROM AiAgentGenerativeAiUsage_std__dlm
WHERE Timestamp__c >= CURRENT_DATE - 30
GROUP BY GenAiGatewayModelName__c, ModelProviderName__c, ModelClassType__c
ORDER BY TotalTokens DESC
Käyttö kanavan mukaan
Käytä tätä kyselyä verrataksesi Voice- ja Messaging-kanavien käyttöä. Se liitetään generoivan tekoälyn käyttöön ja istuntotaulukoihin aggregoidakseen kokonaiskäytön ja valtuudet kanavatyypin mukaan.
SELECT
s.ssot__AiAgentChannelType__c AS ChannelType,
s.ssot__RelatedMessagingSessionId__c AS MessagingSessionId,
s.ssot__RelatedVoiceCallId__c AS VoiceCallId,
u.AgentDeveloperName__c,
SUM(u.UsageQuantity__c) AS TotalUsage,
SUM(u.PromptTotalTokenCount__c) AS TotalTokens
FROM AiAgentGenerativeAiUsage_std__dlm u
JOIN ssot__AiAgentSession__dlm s
ON u.AiAgentSessionId__c = s.ssot__Id__c
WHERE u.Timestamp__c >= CURRENT_DATE - 30
GROUP BY s.ssot__AiAgentChannelType__c,
s.ssot__RelatedMessagingSessionId__c,
s.ssot__RelatedVoiceCallId__c,
u.AgentDeveloperName__c
ORDER BY TotalUsage DESC
LIMIT 20
Data 360 -raporttien rakentaminen
Jos haluat analysoida Knowledge/RAG:n laatudataa ja tilastoja, laadi Data 360:ssa raportteja, jotka noutavat asiaankuuluvia tietoja AiAgentGenerativeAiUsage DMO:sta. Voit käyttää laskettuja havaintoja luodaksesi tilastoja, jotka voivat käynnistää hälytyksiä. Lisätietoja on kohdassa Data 360 -raportit ja -mittaristot.

