> For the complete documentation index, see [llms.txt](https://docs.cerrix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cerrix.com/cerrix-documentation-no/beste-praksiser-og-guider/using-the-cerrix-api-with-ai-assistants-claude-and-microsoft-copilot.md). # Bruke CERRIX-API-et med AI-assistenter (Claude, Microsoft Copilot og ChatGPT) AI-assistenter som Claude, Microsoft Copilot og ChatGPT kan svare på spørsmål om CERRIX-dataene dine på naturlig språk — «Hvilke kontroller besto ikke den siste effektivitetstesten?», «Oppsummer hendelsene som ble rapportert dette kvartalet» — ved å spørre CERRIX API-et direkte. Denne veiledningen viser fire måter å sette det opp på, alle basert på standard CERRIX API-nøkler og uten å hoste noen tilleggsinfrastruktur. ## Slik fungerer det Moderne AI-assistenter kan fungere med ethvert REST API som er beskrevet av en **OpenAPI-spesifikasjon**. Assistenten leser spesifikasjonen for å lære hvilke endepunkter som finnes, velger det riktige for spørsmålet ditt, kaller CERRIX API-et med API-nøkkelen din (Basic-autentisering), og formulerer et svar ut fra responsen. Denne veiledningen dekker fire ruter: | Assistent | Integrasjon | Hvor det kjøres | | ------------------------- | --------------------------------------------------------------------------------------------------- | ----------------------- | | **Claude Desktop** | En lokal verktøyserver generert fra OpenAPI-spesifikasjonen | Din egen arbeidsstasjon | | **Claude Code** | Direkte API-kall fra terminalen, veiledet av spesifikasjonen | Din egen arbeidsstasjon | | **Microsoft 365 Copilot** | En egendefinert kobling lagt til en Copilot Studio-agent | Din Microsoft-tenant | | **ChatGPT** | ChatGPT-skrivebordsappen eller Codex, ved bruk av samme lokale verktøyserver eller direkte API-kall | Din egen arbeidsstasjon | ## Før du begynner 1. **Opprett en CERRIX API-nøkkel.** Følg [Administrasjon og oppsett av API-nøkler](/cerrix-documentation-no/cerrix-funksjoner/admin-settings/api-key-management-and-setup.md). 2. **Be om CERRIX OpenAPI-spesifikasjonen** via CERRIX servicedesk. For Microsoft Copilot-ruten, be også om **Copilot Studio-versjonen** også: en Swagger 2.0-fil med et fokusert sett med skrivebeskyttede operasjoner, formatet Power Platform-egendefinerte koblinger krever. 3. **Planlegg IP-hvitelisting.** API-nøkler er begrenset til tillatte IP-adresser. For Claude Desktop, Claude Code og ChatGPT er dette IP-adressen til din egen arbeidsstasjon eller (VPN)-nettverket ditt. For Microsoft Copilot kommer kallene fra Microsofts sky — se notatene i den delen. {% hint style="info" %} For veiledning om hvilke endepunkter som svarer på hvilke spørsmål — Workflow-endepunkter versus DirectData-rapporteringsdatasettene — se [API-dokumentasjon](/cerrix-documentation-no/cerrix-funksjoner/admin-settings/api-documentation.md). {% endhint %} ## Alternativ 1: Claude Desktop Claude Desktop kan kjøre lokale verktøyservere på arbeidsstasjonen din. Et ferdig, åpen kildekode-verktøy, **OpenAPI MCP Server** (utgitt av AWS Labs), gjør CERRIX OpenAPI-spesifikasjonen om til verktøy Claude kan kalle — ingen koding kreves, og API-legitimasjonen din forlater aldri maskinen din, unntatt når den kaller selve CERRIX. 1. Installer [uv-pakkeadministratoren](https://docs.astral.sh/uv/getting-started/installation/) (brukes til å kjøre verktøyserveren). 2. Lagre CERRIX OpenAPI-spesifikasjonen et permanent sted på maskinen din, for eksempel `Documents/cerrix/cerrix-api-openapi.yaml`. 3. I Claude Desktop, åpne **Innstillinger → Utvikler → Rediger konfigurasjon**. Dette åpner `claude_desktop_config.json`. Legg til: ```json { "mcpServers": { "cerrix": { "command": "uvx", "args": ["awslabs.openapi-mcp-server[yaml]@latest"], "env": { "API_NAME": "cerrix", "API_BASE_URL": "https://[customer short name].cerrix.com/api", "API_SPEC_PATH": "/full/path/to/cerrix-api-openapi.yaml", "AUTH_TYPE": "basic", "AUTH_USERNAME": "", "AUTH_PASSWORD": "", "LOG_LEVEL": "ERROR" } } } } ``` 4. Erstatt base-URL-en med ditt eget CERRIX-miljø, spesifikasjonsstien med plasseringen fra trinn 2, og brukernavnet og passordet med **Identifier** og **Passord** av API-nøkkelen din. 5. Start Claude Desktop på nytt. CERRIX-verktøyene vises under verktøyikonet i chatinndatafeltet, og du kan begynne å stille spørsmål. {% hint style="info" %} CERRIX API-et eksponerer mange endepunkter. Hvis verktøylisten blir lang, støtter OpenAPI MCP Server filtrering av hvilke operasjoner som eksponeres (for eksempel med sin `--include-tags` alternativ) slik at du kan begrense det til modulene du faktisk bruker. {% endhint %} ## Alternativ 2: Claude Code Claude Code, Anthropics agent for terminalen, trenger ingen ekstra verktøy i det hele tatt: gi det OpenAPI-spesifikasjonen og legitimasjonen din som miljøvariabler, så kaller det CERRIX API-et direkte. 1. Installer [Claude Code](https://code.claude.com/docs/en/overview) og opprett en arbeidsmappe, for eksempel `cerrix-assistant`, som inneholder CERRIX OpenAPI-spesifikasjonsfilen. 2. Gjør API-nøkkelen din tilgjengelig som miljøvariabler (for eksempel i shell-profilen din), slik at legitimasjonen holder seg utenfor promptene og filene dine: ```bash export CERRIX_API_USER="" export CERRIX_API_PASSWORD="" ``` 3. I samme mappe, opprett en `CLAUDE.md` fil som forteller Claude Code hvordan den skal nå CERRIX: ``` # CERRIX API - Basis-URL: https://[customer short name].cerrix.com/api - Den fullstendige endpoint-referansen finnes i cerrix-api-openapi.yaml i denne mappen. - Autentisering: HTTP Basic, ved bruk av miljøvariablene CERRIX_API_USER og CERRIX_API_PASSWORD. Eksempel: curl -s -u "$CERRIX_API_USER:$CERRIX_API_PASSWORD" \ "https://[kundens korte navn].cerrix.com/api/directdata/v3/risiko" - Bruk v3-versjonene av Risiko-endepunktene. - Bruk kun GET-endepunkter med mindre du uttrykkelig blir bedt om å opprette noe. ``` 4. Start `claude` i den mappen og still spørsmålet ditt. Claude Code finner riktig endepunkt i spesifikasjonen, kjører API-kallet og kan samle, kryssreferere og til og med lage diagrammer over resultatene. ## Alternativ 3: Microsoft 365 Copilot (via Copilot Studio) For Microsoft Copilot legges CERRIX API-et til som en **egendefinert Power Platform-kobling**, som en **Copilot Studio-agent** bruker den deretter som et verktøy. Denne ruten kjører i Microsoft-leieren din og kan deles med hele teamet ditt via Teams eller Microsoft 365 Copilot. 1. Be om **Copilot Studio-versjonen** av CERRIX-spesifikasjonen (Swagger 2.0) via servicedesken. 2. I [Power Apps-makerportalen](https://make.powerapps.com), velg **Løsninger → Ny løsning**, skriv inn et visningsnavn (for eksempel "CERRIX"), behold standardutgiveren og velg **Opprett**. Copilot Studio kan bare bruke egendefinerte koblinger som er en del av en løsning, så du oppretter koblingen inne i den. ![Ruten Ny løsning i Power Apps med visningsnavn, navn og utgiver](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2Fp0CLnHLBEI1IyXsGN06C%2Fpa-new-solution.png?alt=media) 3. I den nye løsningen velger du **Ny → Automatisering → Egendefinert kobling**. En tom kobling åpnes. Skriv inn et navn øverst (for eksempel "CERRIX"), slå på **Swagger-redigeringsprogrammet** og erstatt innholdet i redigeringsprogrammet med hele innholdet i spesifikasjonsfilen for Copilot Studio. ![Menyen Ny i en løsning, med Automatisering og Egendefinert kobling valgt](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FPyj3FZt8hhkSaJ9PkSGD%2Fpa-solution-new-custom-connector.png?alt=media) ![Swagger-redigeringsprogrammet med CERRIX OpenAPI-spesifikasjonen limt inn og en forhåndsvisning av API-operasjonene](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2F3L6ZiDd98kiorZrcLuvz%2Fpa-swagger-editor-v2.webp?alt=media) 4. Slå av **Swagger-redigeringsprogrammet**. På **Generelt** fanen, sett **Host** til ditt eget CERRIX-miljø, `[kundens kortnavn].cerrix.com`, og kontroller at **Base URL** er `/api`. ![Feltene Host og Base URL på Generelt-fanen i den egendefinerte koblingen](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FKGLh815ikYeGrVf1g20m%2Fpa-general-host-base-url.png?alt=media) 5. På **Security** fanen, velger du **Grunnleggende autentisering**. Merk feltene "API-nøkkel Identifier" og "API-nøkkel Passord" slik at brukerne vet hva de skal skrive inn. Dette er bare visningsetiketter: ikke skriv inn dine faktiske legitimasjonsopplysninger her, siden hver bruker skriver inn sine egne når de oppretter en tilkobling. ![Sikkerhetsfanen med Grunnleggende autentisering valgt og parameteretikettene API-nøkkel Identifier og API-nøkkel Passord](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FlRzufveUqpsFfeWzC1tA%2Fpa-security-basic-auth-v2.png?alt=media) 6. Velg **Opprett kobling** øverst på siden for å lagre koblingen. Du må opprette den før du kan teste den. 7. På **Test** fanen, oppretter du en tilkobling med API-nøkkelens Identifier og Passord og tester en operasjon som `getDirectdataV3Risk`. Det første kallet blokkeres vanligvis av API-nøkkelens IP-begrensning; se merknaden om IP-allowlisting nedenfor. ![En vellykket test av en operasjon på Test-fanen, som returnerer status 200](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2Fjq0NiPhZWJqw8cbJeAsL%2Fpa-test-operation.webp?alt=media) 8. I [Copilot Studio](https://copilotstudio.microsoft.com), velg **Andre måter å bygge på** på startsiden, og deretter **Agent (Standard)**, og opprett agenten. Standardagenter faktureres etter publisering, så du kan bygge og teste uten å bruke Copilot-kreditter; agenttypene merket **GitHub Copilot** bruker kreditter fra det øyeblikket du begynner å bygge. ![Copilot Studio-startsiden med alternativet Andre måter å bygge på](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FcjOkJ2fAmren8piCoCrL%2Fcs-home-other-ways-to-build.webp?alt=media) ![Alternativet Agent (Standard) under Andre måter å bygge på](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2F1ioTBdwtrhPhfZcMlINa%2Fcs-agent-standard.webp?alt=media) 9. På agentens side, under **Verktøy**, velg **Legg til verktøy**, velger du **Kobling** filteret og søker etter CERRIX-koblingen din. Velg et verktøy, kontroller at **Kobling** er angitt, og velg **Legg til og konfigurer**. Gjenta dette for hvert verktøy du trenger (se merknaden om valg av verktøy nedenfor), og behold **Legitimasjon som skal brukes** satt til **sluttbrukerlegitimasjon**. ![Verktøyene til CERRIX-konnektoren i ruten Legg til verktøy](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FHXxKWIaRIoqzk9WoeiNM%2Fcs-standard-connector-tools.webp?alt=media) ![Legge til ett enkelt CERRIX-verktøy med tilkoblingen, ved å bruke Legg til og konfigurer](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FZqvHDB12eNeTupj0EDG8%2Fcs-standard-add-and-configure.webp?alt=media) 10. Under **Instruksjoner**, beskriv hvordan agenten skal arbeide, for eksempel: "Svar på spørsmål om våre Risiko- og Etterlevelse-data i CERRIX. Bruk alltid CERRIX-verktøyene og gjett aldri. Verktøyene returnerer komplette datasett: filtrer og oppsummer dem selv, og si hvor mange poster svaret ditt er basert på. Denne agenten kan bare lese data." Under **Kunnskap**, slå av nettsøk slik at svarene bare kommer fra CERRIX. 11. Åpne **Test** ruten og still et spørsmål. Første gang agenten bruker et verktøy, ber den deg om å koble til med API-nøkkelens Identifier og passord. ![Copilot Studio-testruten med et svar basert på CERRIX-risikoregisteret](https://3330106213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEeL4xdXxYZ2fsPsMzsYF%2Fuploads%2FLHpby7G5MH7iKp9r4Gxz%2Fcs-test-answer.png?alt=media) 12. Publiser agenten. Deretter, på **Kanaler** fanen, legg til **Teams og Microsoft 365 Copilot** kanalen slik at teamet ditt kan bruke agenten i Microsoft Teams og Microsoft 365 Copilot. Noen merknader: * **Velg et fokusert sett med verktøy.** Microsoft anbefaler ikke mer enn 25–30 verktøy per agent for pålitelige resultater, og en agent kan ha maksimalt 128. Derfor inneholder Copilot Studio-versjonen av spesifikasjonen et fokusert sett med skrivebeskyttede DirectData-operasjoner som dekker moduler som Risiko, Kontroll, Hendelser, Funnrapport, KRI, Oppgave, Tredjepart og databehandling. Legg til verktøyene brukstilfellet ditt trenger. Se Microsofts [veiledning for generativ orkestrering](https://learn.microsoft.com/en-us/microsoft-copilot-studio/advanced-generative-actions). * **Copilot-kreditter.** Etter publisering kan samtaler med agenten bruke Copilot-kreditter, avhengig av organisasjonens lisensiering for Copilot Studio og Microsoft 365 Copilot. Sjekk med Microsoft-administratoren din før du ruller ut agenten bredt. * **IP-hvitelisting.** Konnektortrafikk kommer fra Microsofts Power Platform, ikke fra brukernes arbeidsstasjoner, så det første testkallet blir vanligvis blokkert av API-nøkkelens IP-restriksjon. Åpne profilen til nøkkelens eier **API** siden, godkjenn kallende adresse under **Forespurte IP-adresser** og klikk **Lagre**. For et Power Platform-miljø i Europa er dette en adresse som for eksempel `20.86.93.33`. Power Platform kan kalle fra enhver adresse i sine [publiserte utgående områder](https://learn.microsoft.com/en-us/connectors/common/outbound-ip-addresses) for regionen din (for Europa, `AzureConnectors.WestEurope` og `AzureConnectors.NorthEurope` servicemerker), så en ny adresse kan av og til bli blokkert senere. Godkjenn den på samme måte. ## Alternativ 4: ChatGPT (skrivebordsapp og Codex) OpenAIs agent **Codex** kjører på arbeidsstasjonen din og er inkludert i ChatGPT-abonnementer. [ChatGPT-skrivebordsappen](https://chatgpt.com/download), Codex CLI og Codex IDE-utvidelsen deler én enkelt verktøykonfigurasjon, så du setter opp CERRIX én gang og kan bruke det fra hvilken som helst av dem. Oppsettet speiler Claude-alternativene: en lokal verktøytjener generert fra OpenAPI-spesifikasjonen, eller direkte API-kall fra terminalen. **Lokal verktøytjener (ChatGPT-skrivebordsappen, Codex CLI og IDE-utvidelsen)** 1. Installer [uv-pakkeadministratoren](https://docs.astral.sh/uv/getting-started/installation/) og lagre CERRIX OpenAPI-spesifikasjonen et permanent sted, som i alternativ 1. 2. Åpne Codex-konfigurasjonsfilen `~/.codex/config.toml` (opprett den hvis den ikke finnes) og legg til: ```toml [mcp_servers.cerrix] command = "uvx" args = ["awslabs.openapi-mcp-server[yaml]@latest"] startup_timeout_sec = 60 [mcp_servers.cerrix.env] API_NAME = "cerrix" API_BASE_URL = "https://[customer short name].cerrix.com/api" API_SPEC_PATH = "/full/path/to/cerrix-api-openapi.yaml" AUTH_TYPE = "basic" AUTH_USERNAME = "" AUTH_PASSWORD = "" LOG_LEVEL = "ERROR" ``` 3. Bytt ut base-URL-en, spec-stien og legitimasjonen som beskrevet i Alternativ 1. Den lengre `startup_timeout_sec` gir verktøytjeneren tid til å laste ned ved første oppstart. 4. Start ChatGPT-skrivebordsappen på nytt, eller start `codex` i en terminal (skriv `/mcp` der for å sjekke at CERRIX-serveren er aktiv), og begynn å stille spørsmål. **Direkte API-kall (Codex CLI)** Codex CLI kan også kalle CERRIX API-en direkte, akkurat som Claude Code. Følg trinnene i Alternativ 2, men kall instruksjonsfilen `AGENTS.md` i stedet for `CLAUDE.md` (Codex leser prosjektinstruksjonene sine fra `AGENTS.md`), og start `codex` i den mappen. Noen merknader: * **Din egen nøkkel og IP-adresse.** Som Claude-alternativene gjøres kallene fra din egen arbeidsstasjon med din egen API-nøkkel, så datatilgangen følger legitimasjonen din, og du hvitelister din egen IP-adresse. * **Bruk.** Codex-bruk teller med i Codex-bruksgrensene eller kredittpoengene i ChatGPT-abonnementet ditt. * **Begrens verktøyene.** For å holde verktøylisten fokusert, bruk verktøytjenerens `--include-tags` alternativ (se Alternativ 1) eller Codex sin `enabled_tools` -innstilling. ## Gode praksiser * **Sørg for samsvar med sikkerhets- og personvernansvarlige.** Data som hentes av assistenten behandles av AI-leverandøren (Anthropic, Microsoft eller OpenAI) i henhold til organisasjonens avtaler med dem. Bekreft at dataklassifiseringen av CERRIX-innholdet ditt passer med disse avtalene før du ruller dette ut bredt. * **Planlegg for nøkkelrotasjon.** API-nøkler er gyldige i høyst ett år, så planlegg rotasjonen og oppdater konfigurasjonen når nøkkelen erstattes. ## Spørsmål å prøve Når du er tilkoblet, kan du prøve spørsmål som: * "Hvilke av risikoene våre har ingen tilknyttede kontroller?" * "Hvilke kontroller bestod ikke den siste effektivitetsprøven, og hvem eier dem?" * "Oppsummer hendelsene som ble rapportert i forrige kvartal, etter klassifisering." * "List opp forbedringstiltakene som er forfalte, gruppert etter emne." --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.cerrix.com/cerrix-documentation-no/beste-praksiser-og-guider/using-the-cerrix-api-with-ai-assistants-claude-and-microsoft-copilot.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.