Files
semantic-kernel/python/notebooks/01-basic-loading-the-kernel.ipynb
T
63e140ae57 Python: Bump pyproject to 0.4.5 for release. Update notebooks to use this version (#4581)
### Motivation and Context

Bumping pyproject.toml to version 0.4.5 for a release. Updating the
package references in the Jupyter notebooks.

<!-- Thank you for your contribution to the semantic-kernel repo!
Please help reviewers and future users, providing the following
information:
  1. Why is this change required?
  2. What problem does it solve?
  3. What scenario does it contribute to?
  4. If it fixes an open issue, please link to the issue here.
-->

### Description

Pre-release code updates.

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->

### Contribution Checklist

<!-- Before submitting this PR, please make sure: -->

- [X] The code builds clean without any errors or warnings
- [X] The PR follows the [SK Contribution
Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
and the [pre-submission formatting
script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts)
raises no violations
- [X] All unit tests pass, and I have added new tests where possible
- [X] I didn't break anyone 😄

---------

Co-authored-by: Evan Mattson <[email protected]>
Co-authored-by: Eduard van Valkenburg <[email protected]>
2024-01-11 17:37:57 +00:00

4.3 KiB

Basic Loading of the Kernel

To run the notebooks we recommend using Poetry and starting a shell with a virtual environment prepared to use SK.

See DEV_SETUP.md for more information.

In [ ]:
!python -m pip install semantic-kernel==0.4.5.dev0
In [1]:
import semantic_kernel as sk
from semantic_kernel.connectors.ai.open_ai import (
    AzureChatCompletion,
    OpenAIChatCompletion,
)

You can instantiate the kernel in a few ways, depending on your use case.

In [2]:
# Simple instance
kernel_1 = sk.Kernel()

When using the kernel for AI requests, the kernel needs some settings like URL and credentials to the AI models.

The SDK currently supports OpenAI and Azure OpenAI, other services will be added over time.

If you need an Azure OpenAI key, go here.

In [ ]:
kernel = sk.Kernel()

kernel.add_chat_service(  # We are adding a text service
    "Azure_curie",  # The alias we can use in prompt templates' config.json
    AzureChatCompletion(
        deployment_name="my-finetuned-Curie",  # Azure OpenAI *Deployment name*
        endpoint="https://contoso.openai.azure.com/",  # Azure OpenAI *Endpoint*
        api_key="...your Azure OpenAI Key...",  # Azure OpenAI *Key*
    ),
)

kernel.add_chat_service(  # We are adding a text service
    "OpenAI_chat_gpt",  # The alias we can use in prompt templates' config.json
    OpenAIChatCompletion(
        ai_model_id="gpt-3.5-turbo",  # OpenAI Model Name
        api_key="...your OpenAI API Key...",  # OpenAI API key
        org_id="...your OpenAI Org ID...",  # *optional* OpenAI Organization ID
    ),
)

When working with multiple services and multiple models, the first service defined is also the "default" used in these scenarios:

  • a prompt configuration doesn't specify which AI service to use
  • a prompt configuration requires a service unknown to the kernel

The default can be set and changed programmatically:

In [ ]:
kernel.set_default_text_completion_service("Azure_curie")

Great, now that you're familiar with setting up the Semantic Kernel, let's see how we can use it to run prompts.